apkSpy: A Java repository from LucasBaizer

apkSpy

A fork of jadx with support for editing Java source code of APK's, and then recompiling them. Inspired by dnSpy, but for Android Java instead of .NET.

How it Works

apkSpy allows you to recompile individual methods of classes, so you can recompile only small pieces, regardless of whether the other parts of the application are compiling or not. Once you've made your changed you can export it as an APK.

Limitations and Future Goals

Currently you cannot edit Smali bytecode. This would be very useful, as you can edit a method even if that method itself does not compile.
You can only edit methods. It would be great to have support for editing member fields.
The ability to create and delete classes, as well as create and delete new methods.
Classes within the android.* packages cannot be edited.

Below is the README for jadx.

How Use

After compiling this project from source (there will be released in the future), load an APK, open up any class, right-click within a method and then click "Edit Method Java".

To save your changes, first ensure your Android SDK path is set. You can find this by going in the menu bar apkSpy -> Preferences. Then, your changed can be recompiled by going to apkSpy -> Save APK. If all goes well, it should pop up saying the recompiling has been successful. You now have a patched APK!

JADX

jadx - Dex to Java decompiler

Command line and GUI tools for produce Java source code from Android Dex and Apk files

Downloads

latest unstable build:
release from github:
release from bintray:

After download unpack zip file go to bin directory and run:

jadx - command line version
jadx-gui - graphical version

On Windows run .bat files with double-click
Note: ensure you have installed Java 8 64-bit version

Related projects:

PyJadx - python binding for jadx by @romainthomas

Building jadx from source

JDK 8 or higher must be installed:

git clone https://github.com/skylot/jadx.git
cd jadx
./gradlew dist

(on Windows, use gradlew.bat instead of ./gradlew)

Scripts for run jadx will be placed in build/jadx/bin and also packed to build/jadx-<version>.zip

macOS

You can install using brew:

brew install jadx

Run

Run jadx on itself:

cd build/jadx/
bin/jadx -d out lib/jadx-core-*.jar
# or
bin/jadx-gui lib/jadx-core-*.jar

Usage

jadx[-gui] [options] <input file> (.apk, .dex, .jar, .class, .smali, .zip, .aar, .arsc)
options:
  -d, --output-dir                    - output directory
  -ds, --output-dir-src               - output directory for sources
  -dr, --output-dir-res               - output directory for resources
  -j, --threads-count                 - processing threads count
  -r, --no-res                        - do not decode resources
  -s, --no-src                        - do not decompile source code
  -e, --export-gradle                 - save as android gradle project
  --show-bad-code                     - show inconsistent code (incorrectly decompiled)
  --no-imports                        - disable use of imports, always write entire package name
  --no-debug-info                     - disable debug info
  --no-inline-anonymous               - disable anonymous classes inline
  --no-replace-consts                 - don't replace constant value with matching constant field
  --escape-unicode                    - escape non latin characters in strings (with \u)
  --respect-bytecode-access-modifiers - don't change original access modifiers
  --deobf                             - activate deobfuscation
  --deobf-min                         - min length of name, renamed if shorter (default: 3)
  --deobf-max                         - max length of name, renamed if longer (default: 64)
  --deobf-rewrite-cfg                 - force to save deobfuscation map
  --deobf-use-sourcename              - use source file name as class name alias
  --rename-flags                      - what to rename, comma-separated, 'case' for system case sensitivity, 'valid' for java identifiers, 'printable' characters, 'none' or 'all'
  --fs-case-sensitive                 - treat filesystem as case sensitive, false by default
  --cfg                               - save methods control flow graph to dot file
  --raw-cfg                           - save methods control flow graph (use raw instructions)
  -f, --fallback                      - make simple dump (using goto instead of 'if', 'for', etc)
  -v, --verbose                       - verbose output
  --version                           - print jadx version
  -h, --help                          - print this help
Example:
 jadx -d out classes.dex
 jadx --rename-flags "none" classes.dex
 jadx --rename-flags "valid,printable" classes.dex

These options also worked on jadx-gui running from command line and override options from preferences dialog

Troubleshooting

Out of memory error:

Reduce processing threads count (-j option)
Increase maximum java heap size:
- command line (example for linux): JAVA_OPTS="-Xmx4G" jadx -j 1 some.apk
- edit 'jadx' script (jadx.bat on Windows) and setup bigger heap size: DEFAULT_JVM_OPTS="-Xmx2500M"

Licensed under the Apache 2.0 License

LucasBaizer/apkSpy