Apktool 2.0.0
Maintainer of Apktool
Creator of Apktool
caution
Major release. Breaking changes!
- Java 1.7 is required
- Update apktool to v2.0.0
- aapt is now included inside the apktool binary. It's not required to maintain your own aapt install under $PATH. (However, features like
-a / --aaptare still used and can override the internal aapt) - The addition of aapt replaces the need for separate aapt download packages. Helper Scripts may be found here
- Remove framework
$HOME/apktool/framework/1.apk - Eagle-eyed users will notice resources are now decoded before sources now. This is because we need to know the API version via the manifest for decoding the sources
Changes
- Android 5.1 support
- Updated smali/baksmali to
v2.0.5 - Updated gradle to
v2.1 - Fixed using
-cto retain original manifest and META-INF folder. (#118) - Fixed handling apks that have unknown files outside of standard aapt allowed resources. (#174)
- Fixed aapt incorrectly setting
pkgId. (#313) / (Thanks M1cha) - Added new usage output to organize features / parameters. (#514)
- Fixed NPE from malformed 9patch images. (#470) / (Thanks Felipe Richards)
- Fixed aapt requiring
versionNameandversionCodevia parameter passing. (#512) - Fixed common
aaptproblems by including an internal mac, win and linux aapt. (#551) - Fixed decoding apks that had general access bit thrown. (#550)
- Fixed debug mode (
-d) to fix smali debugging. (#450) / (Thanks Ryszard) - Adapted smali debugging output to make breakpoint setting easier across IDEs. (#228) / (Thanks Ryszard)
- Fixed characters (
&&<) from being double escaped in<item>'s ofarrays.xml. (#502) - Fixed "multiple substitution" errors with positional and exactly 1 non-positional argument. (#371)
- Fixed ignoring
--frame-pathon[b]uild. (#538) - Fixed setting
android:debuggableon debug apks. (#507) - Fixed common "superclass" errors on debug mode. (#451)
- Fixed
pkgIdnot being set in framework files. (#569) - Added
-m/--match-originalfeature to allow apks to match original. (#580) - Fixed apks PNGs gaining brightness on rebuild. (#437)
- Added dexlib2 (smali2) into Apktool. (#559)
- Fixed windows builds caused by
java.nio. (#606) - Fixed error output being written to
stdoutinstead ofstderr. (#620) - Fixed issue with smali filenames from being too long. (#537) / (Thanks JesusFreke)
- Fixed issue with
INSTALL_FAILED_DEXOPT. (#634) / (Thanks JesusFreke) - Fixed issue with apks with multiple packages. (#583)
- Fixed issue with decoding
.jarfiles. (#641) - Fixed issue with improperly labeling type of
<array>'s. (#660) - Fixed issue with truncated strings. (#681) / (Thanks jtmuhone)
- Fixed issue with apks with multiple empty types via ignoring them. (#688)
- Fixed issue with apks with one package named
androidfrom decoding. (#699) - Fixed StringBlock by making it thread safe. (#711) / (Thanks aluedeke)
- Fixed truncated
UTF-16strings. (#349) - Spacing cleanup of 2014. (#694)
- Fixed style crash due to malformed styles. (#307)
- Fixed issue with unknown files being ignored that start with an accepted file name. (#713)
- Fixed issue with unknown files being ignored when
-rwas used. (#716) - Fixed issue with renamed manifests such as (
android,com.htcandmiui). (#719) - Fixed path issues with
UTF8chars and unknown files. (#736) - Fixed issue with renamed manifest (
com.lge). (#740) - Fixed incorrect typing of
<array>items due to incorrect loop index. (#520) - Fixed issue with
AndroidManifest.xmlmissing attributes. (#623) - Fixed issue with ignoring
formatted="false"attribute in<string-array>'s. (#786) - Fixed issue with multiple overlapping try catches. (#748)
- Fixed issue with apks with multiple
ResPackageswhere default is notpkgId0. (#793) - Fixed issue with renamed manifest (
yi). (#791) - Fixed issue with apks with large StringPools failing to decode. (#773)
- Fixed issue with bad casting of
ResStringValuetoResAttr. (#587) / (Thanks whydoubt) - Fixed issue with hardcoding 9 patches as
.pngwhen there are.qmg,.spi. (#798) - Added support for Android 5.0 (Lollipop). (#763)
- Added support for
TYPE_DYNAMIC_REFERENCE. (#815) - Fixed issue with implicitly added version qualifiers. (#823)
- Added support for shared library apks. (#822)
- Fixed issue improperly casting strings that resembled filepaths to
ResFileValues. (#440) - Fixed issue with segfaulting
aapt. (#700) - Fixed issue with undefined attributes. (#655)
- Fixed issue with improper handling of
MNC_ZEROwhich caused duplicated resources. (#811) - Fixed warnings of "Cleaning up unclosed ZipFile...". (#853)
- Added support for downloading gradle binaries over
https. (#866) - Fixed issue when user has no access to
$HOME. (#513) - Added support for
BCP-47localization tags. (#870) - Fixed issue with double escaping of ampersands in
<. (#658) / (Thanks jhornber) - Fixed issue with not respecting compression type of unknown files. (#878) / (Thanks simtel12)
- Fixed issue with apktool branding apks via
platformBuildVersion[Code/Name]. (#890) - Fixed issue when multiple dex files were ignored using
-s. (#904) - Fixed issue with
@stringreferences in<provider>attributes from preventing apk install. (#636) - Fixed issue with decoding
.spifiles as 9 patch images. (Thanks Furniel) - Fixed issue with APKs with multiple dex files.
- Fixed issue using Apktool without smali/baksmali.
- Fixed issue using non URI standard characters in apk name. (Thanks rover12421)
- Added version output during decode/build operations to quickly identify apktool version.
- Fixed NPE error when using
.odexfiles with--no-srcspecified. (Thanks Rodrigo Chiossi) - Fixed locale problems when locale changes meaning of windows
.batscript. (Thanks Adem666) - Fixed issue when
-rwas used with no/resfolder present. (Thanks chrisch1974)
Parameter Changes
- Smali/baksmali 2.0 are included. This is a big change from 1.4.2. Please read the smali updates here for more information
-o / --outputis now used for the output of apk/directory-t / --tagis required for tagging framework files-advance / --advancedwill launch advanced parameters and information on the usage output-m / --match-originalis a new feature for apk analysis. This retains the apk in nearly the original format, but will likely make the rebuild not work due to ignoring the changes that newer aapt requires- After
[d]ecode, there will be new folders (original / unknown) in the decoded apk folder - original =
META-INF folder/AndroidManifest.xml, which are needed to retain the signature of apks to prevent needing to resign. Used with-c / --copy-originalon[b]uild - unknown = Files/folders that are not part of the standard AOSP build procedure. These files will be injected back into the rebuilt APK.
apktool.ymlcollects more information than the last versionSdkInfo- Used to repopulate the SDK information inAndroidManifest.xmlsince newer aapt requires version information to be passed via a parameterpackageInfo- Used to help support Android 4.2 renamed manifest feature. Automatically detects differences between resources and the manifest and performs automatic--rename-manifest-packageon[b]uildversionInfo- Used to repopulate the version information inAndroidManifest.xmlsince newer aapt requires version information to be passed via a parametercompressionType- Used to determine the compression thatresources.arschad on the original APK in order to replicate during[b]uildunknownFiles- Used to record the name/location of non-standard files in an APK in order to place them correctly on the rebuilt APKsharedLibrary- Used to help support Android 5 shared library feature by automatically detecting shared libraries and using--shared-libon[b]uild
Parameter Comparison
| Old (Apktool 1.5.x) | New (Apktool 2.0.x) |
|---|---|
| apktool if framework-res.apk tag | apktool if framework-res.apk -t tag |
| apktool d framework-res.apk output | apktool d framework.res.apk -o output |
| apktool b output new.apk | apktool b output -o new.apk |
This post was originally released at: https://connortumbleson.com/2015/04/20/apktool-v2-0-0-released and duplicated in part here for historical reasons.