Code Monkey home page Code Monkey logo

apkspy's Introduction

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

Build Status Code Coverage SonarQube Bugs License semantic-release

jadx - Dex to Java decompiler

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

jadx-gui screenshot

Downloads

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:

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

Copyright 2018 by Skylot

apkspy's People

Contributors

skylot avatar asashour avatar lucasbaizer avatar jpstotz avatar bagipro avatar neospb avatar 13-beta2 avatar donlon avatar daramos avatar trunkator avatar flxme avatar wuyongzheng avatar asviridenko avatar rgoggins avatar mingyuan-xia avatar riboribo avatar allight avatar achellies avatar wwj402 avatar javaeryang avatar broqdev avatar dgorshkov avatar vbauer avatar thestrix avatar netmaxt3r avatar soldierkam avatar kpchuck avatar bkerler avatar antonellof avatar dnet avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.