diff --git a/categories/consoles/Android.md b/categories/consoles/Android.md index eacd0707..988a1649 100644 --- a/categories/consoles/Android.md +++ b/categories/consoles/Android.md @@ -7,7 +7,7 @@ breadcrumbs: url: / - name: Android url: -editlink: ../pages/Android.md +editlink: ../categories/consoles/Android.md recommend: - android - introduction @@ -15,35 +15,52 @@ _image: /public/images/Android.jpg _twitterimage: https://www.retroreversing.com/public/images/Android.jpg tags: - android -_updatedAt: 2025-12-07 +updatedAt: '2026-11-18' --- -# Reverse Engineering Android Games +# Reverse Engineering Android Games +An Android game's APK is a ZIP archive, but its code and data are not all in one place. `classes.dex` holds managed bytecode, `lib/` can hold native `.so` libraries for different processor architectures, and `assets/` contains files the game reads through Android's asset manager [^1]. The package layout gives you a useful first question: is the behavior you want to understand in DEX, native code, or game data? -## JADX: Dex to Java Decompiler -The **skylot** project hosts **JADX**, the premier open-source tool for **reverse engineering** Android applications by converting **Dalvik bytecode (DEX/APK)** back into readable **Java source code**. +--- +## Where is the game code in an APK? +The [Android APK structure guide](https://developer.android.com/topic/performance/reduce-apk-size#understand_the_apk_structure) maps `classes.dex`, `lib/`, `assets/`, `resources.arsc` and the binary `AndroidManifest.xml` [^1]. `classes.dex` is the right starting point for Java or Kotlin code compiled to DEX. Native game code can instead be in `lib//lib.so`; the [Android NDK ABI guide](https://developer.android.com/ndk/guides/abis) explains why an APK can contain several builds of the same library [^2]. A Java decompiler will not reveal the instructions in those `.so` files. -It is available as a powerful command-line utility and a feature-rich graphical user interface (GUI) that supports syntax highlighting, cross-reference navigation, and full-text search. The decompiler includes an effective **deobfuscator** and is essential for deep static analysis of compiled Android binaries. +For older large games distributed through Google Play, the APK may be only part of the release. Google's [APK expansion-file guide](https://developer.android.com/google/play/expansion-files) describes `main` and `patch` OBB files stored under `Android/obb//`; an OBB can contain data in a format chosen by the developer [^3]. Check for these files before concluding that art, audio or levels are absent from an APK. This is a legacy APK distribution scheme; [app bundles](https://developer.android.com/guide/app-bundle/app-bundle-format) can instead deliver split APKs and separate asset packs [^4]. -{% include link-to-other-site.html url="https://github.com/skylot/jadx" description="skylot's JADX project provides robust command-line and GUI tools for decompiling Android DEX/APK files back into readable Java code, complete with an integrated deobfuscator." image="https://opengraph.githubassets.com/1/skylot/jadx" title="skylot/jadx: Dex to Java decompiler" %} +--- +## Tools for inspecting code and packages +Start with the package layout, then choose a tool for the code or metadata you need. -### jadx-magic-strings Plugin -The **jadx-magic-strings** project by **0rShemesh** is a highly valuable JADX plugin designed to enhance the decompilation and analysis of Android DEX files. +### How can you read DEX code? +[JADX](https://github.com/skylot/jadx) decompiles DEX bytecode into Java-like source and offers command-line and graphical interfaces. Its search and cross-reference views help trace calls across an APK; its name-renaming options can make obfuscated code easier to navigate, but cannot recover original source names without a mapping [^5]. -It operates automatically after decompilation to extract and analyze "magic strings," which include method names, class references, and source file paths (like `.java` or `.kt`), from string constants found in the code. +{% include link-to-other-site.html url="https://github.com/skylot/jadx" description="Decompile DEX code and trace classes and calls in a graphical interface." image="https://opengraph.githubassets.com/1/skylot/jadx" title="skylot/jadx: Dex to Java decompiler" %} -{% include link-to-other-site.html url="https://github.com/0rShemesh/jadx-magic-strings" description="0rShemesh's JADX plugin automatically extracts source file references, method name candidates, and other structural information from string constants in decompiled Android code, aiding reverse engineering." image="https://opengraph.githubassets.com/1/0rShemesh/jadx-magic-strings" title="jadx-magic-strings: JADX plugin for extracting metadata from strings" %} +### jadx-magic-strings Plugin +[0rShemesh's jadx-magic-strings plugin](https://github.com/0rShemesh/jadx-magic-strings) extracts method names, class references and source-file paths left in DEX string constants. Those clues can help name code that JADX otherwise shows with short obfuscated identifiers [^6]. -## Android File Formats +{% include link-to-other-site.html url="https://github.com/0rShemesh/jadx-magic-strings" description="Find source paths, class references and method-name clues in DEX strings." image="https://opengraph.githubassets.com/1/0rShemesh/jadx-magic-strings" title="jadx-magic-strings: JADX plugin for extracting metadata from strings" %} -### APK-Info: Full-Featured APK Parser (Rust/Python) -The APK parser **apk-info** is designed for efficient forensic and security analysis, offering comprehensive extraction of crucial metadata from Android packages, including main activities, minimum SDK versions, and intricate details from the **AXML** (Binary XML) and **ARSC** (Resource) formats. -Crucially, it fully supports parsing various **APK Signature Block 42** schemes (v1, v2, v3, v3.1), making it a powerful read-only utility for large-scale Android reverse engineering and malware analysis. +### How can you inspect package metadata? +Google's [apkanalyzer reference](https://developer.android.com/tools/apkanalyzer) lists commands for the manifest, DEX classes, resources and files inside an APK [^7]. It is useful when you need to identify a package and its entry points before opening code in a decompiler. -{% include link-to-other-site.html url="https://github.com/delvinru/apk-info" description="delvinru's apk-info is a full-featured, malware-friendly APK parser in Rust with Python bindings, capable of high-speed extraction of metadata and analysis of complex signature schemes." image="https://opengraph.githubassets.com/1/delvinru/apk-info" title="delvinru/apk-info: APK full-featured parser" %} +[apk-info](https://github.com/delvinru/apk-info) is a Rust parser with Python bindings. Its README documents main-activity and minimum-SDK extraction, binary XML and resource parsing, and APK signature schemes including v1, v2, v3 and v3.1 [^8]. + +{% include link-to-other-site.html url="https://github.com/delvinru/apk-info" description="Inspect an APK's metadata, binary XML, resources and signing schemes." image="https://opengraph.githubassets.com/1/delvinru/apk-info" title="delvinru/apk-info: APK full-featured parser" %} --- # Magazine Interviews The magazine index collects developer interviews tagged for this system across all indexed magazines. {% include interview-table.html platform="Android" %} + +--- +# References +[^1]: [Android Developers, Understand the APK structure](https://developer.android.com/topic/performance/reduce-apk-size#understand_the_apk_structure). +[^2]: [Android Developers, Android ABIs](https://developer.android.com/ndk/guides/abis), native-library paths and architecture selection. +[^3]: [Android Developers, APK Expansion Files](https://developer.android.com/google/play/expansion-files), file naming and storage location. +[^4]: [Android Developers, The Android App Bundle format](https://developer.android.com/guide/app-bundle/app-bundle-format), split APKs and asset packs. +[^5]: [skylot, JADX](https://github.com/skylot/jadx), decompiler features and name-mapping options. +[^6]: [0rShemesh, jadx-magic-strings](https://github.com/0rShemesh/jadx-magic-strings), extracted string clues. +[^7]: [Android Developers, apkanalyzer](https://developer.android.com/tools/apkanalyzer), APK inspection commands. +[^8]: [delvinru, apk-info](https://github.com/delvinru/apk-info), parser capabilities and signing-scheme list. diff --git a/public/generated/placeholders/delphi.jpg b/public/generated/placeholders/delphi.jpg index 5c9a2511..30885357 100644 Binary files a/public/generated/placeholders/delphi.jpg and b/public/generated/placeholders/delphi.jpg differ diff --git a/public/generated/placeholders/n64-sdk-demos.jpg b/public/generated/placeholders/n64-sdk-demos.jpg index 4a8c9226..355a71b0 100644 Binary files a/public/generated/placeholders/n64-sdk-demos.jpg and b/public/generated/placeholders/n64-sdk-demos.jpg differ diff --git a/public/generated/placeholders/retro-gamer.jpg b/public/generated/placeholders/retro-gamer.jpg index e75605f4..d653fd14 100644 Binary files a/public/generated/placeholders/retro-gamer.jpg and b/public/generated/placeholders/retro-gamer.jpg differ diff --git a/public/generated/placeholders/sega-dts.jpg b/public/generated/placeholders/sega-dts.jpg index 4be98723..27a9f7a9 100644 Binary files a/public/generated/placeholders/sega-dts.jpg and b/public/generated/placeholders/sega-dts.jpg differ