smali/baksmali is an assembler/disassembler for the dex format used by dalvik, Android's Java VM implementation. The syntax is loosely based on Jasmin's/dedexer's syntax, and supports the full functionality of the dex format (annotations, debug info, line info, etc.)
NOTE: This is a fork of https://github.com/JesusFreke/smali for patches needed by Google as the original repository is currently not maintained. After forking the namespace was changed from org.jf to com.android.tools.smali. The artifacts are released on Google Maven under the following coordinates:
com.android.tools.smali:smali:<version>com.android.tools.smali:smali-dexlib2:<version>com.android.tools.smali:smali-baksmali:<version>com.android.tools.smali:smali-util:<version>
After the fork the first version released was 3.0.0, which was version 2.5.2 from the original repo with a few patches and the namespace change.
- github Issue tracker - For any bugs/issues/feature requests
- Official dex bytecode reference
- Registers wiki page
- Types, Methods and Fields wiki page
- Official dex format reference
./gradlew assemble
To run the smali and baksmali tools from the command line build the fat
jars. The fat jars will be named with the current version followed by the first
8 characters of the current git hash followed by an optional -dirty if the
repository was dirty when building and ending in -fat . The fat jar can be
invoked with java -jar.
./gradlew smali:fatJar
java -jar smali/build/libs/smali-x.y.z-aaaaaaaa-dirty-fat.jar
To execute all tests run
./gradlew test
Push a release version to your local maven repository (add
-Dmaven.repo.local=<dir> to override the default local maven repository
location)
./gradlew release publishToMavenLocal
To prepare a release update build.gradle with the next release version and commit that.
Then create a tag for that commit with the version.
git tag <version> <commit>
git push origin <version>
Release versions can then be built by the Google R8 team using:
tools/trigger.py --smali=<version> --release
in the R8 repository.
The status of the build on the bot is at https://ci.chromium.org/p/r8/builders/ci/smali.
TBD.