CLI Parameters
Utility Options
Options used for utility commands (apktool {options}
)
h, help
- Dumps out all usage output.
v|version
- Outputs the current software version. (Ex: 1.5.2)
Decoding Options
Options used for decoding commands (apktool d file.apk {options}
)
--no-debug-info
- Prevents baksmali from writing out debug info. (
.local
,.param
,.line
, etc.).
-f, --force
- Forces the deletion of the destination directory.
--force-manifest
- Forces Apktool to decode
AndroidManifest.xml
regardless of your decoding options.
--keep-broken-res
- Use if an error was thrown and some resources were dropped and you want to decode them anyway.
- E.g.
Invalid config flags detected. Dropping resources
. - You will have to fix them manually before building.
- E.g.
-l, --lib <package>:<location>
- Use to specify a dynamic library location.
- ie.
--lib com.google.android.test.shared_library:/tmp/shared_library.apk
- This can be called multiple times to add multiple libraries.
- ie.
--match-original
- Matches the generated files as close as possible to the originals.
- Comes at the cost of possibly preventing re-build.
--no-assets
- Prevents decoding/copying unknown asset files.
--only-main-classes
- Only disassembles dex classes that are in the root of the application.
-p, --frame-path <DIR>
- Sets the folder framework files are stored/read from.
-r, --no-res
- Prevents decompiling resources.
- Keeps
resources.arsc
intact.
- Keeps
--res-resolve-mode <mode>
- Sets the mode used when resolving resources.
remove
(default) - Removes resources that cannot be resolved.dummy
- Adds a dummy resource for resources that cannot be resolved.keep
- Keeps unresolved resources usingAPKTOOL_MISSING_{resId}
nomenclature.
-s, --no-src
- Prevents disassembling dex files.
- Leaves the dex files untouched and moves them upon build.
-t, --frame-tag <TAG>
- Uses framework files tagged by
TAG
.
Building Options
Options used for building commands (apktool b folder {options}
)
--aapt <FILE>
- Loads aapt2 binaries from the specified location.
- These are used instead of the internal version.
--copy-original
- Copies the original
AndroidManifest.xml
andMETA-INF
.
--debuggable
- Adds
debuggable="true"
toAndroidManifest.xml
.
-f, --force
- Overwrites existing files during build.
- Includes resources and sources.
--net-sec-conf
- Adds a generic Network Security Configuration file in the apk.
--no-apk
- Disables repacking of the built files into a new apk.
---no-crunch
- Disables crunching resource files during build.
- This prevents automatic bitmap optimization by aapt/aapt2.
-o, --output <FILE>
- Sets the name of the output apk.
- The Default is
dist/{apkname}.apk
.
- The Default is
-p, --frame-path <DIR>
- Sets the folder framework files are stored/read from.
Clean Frameworks Options
Options used for empty-framework-dir commands (apktool cf|clean-frameworks {options}
)
-a, --all
- Lists all framework files regardless of their tag.
-p, --frame-path <DIR>
- Sets the folder framework files are read from.
-t, --frame-tag <TAG>
- Lists framework files with the specified tag.
List Framework Directory Options
Options used for list-frameworks commands (apktool lf|list-frameworks {options}
)
-a, --all
- Lists all framework files regardless of their tag.
-p, --frame-path <DIR>
- Sets the folder framework files are read from.
-t, --frame-tag <TAG>
- Lists framework files with the specified tag.
Common Options
Options that can be used with any command
-j <NUM>, --jobs <NUM>
- Sets the number of threads to use when parallel operations are available.
- Defaults to the number of processors available, with a max of 8.
-v, --verbose
- Verbose output.
- Includes any log messages tagged with
FINE
.
- Includes any log messages tagged with
-q, --quiet
- Quiet output.