/AndResGuard

proguard resource for Android by wechat team

Primary LanguageJavaApache License 2.0Apache-2.0

AndResGuard

Join the chat at https://gitter.im/shwenzhang/AndResGuard Build Status Jcenter Status license Commitizen friendly

Read this in other languages: English, 简体中文.

AndResGuard is a tool to proguard resource for Android, just like ProGuard in Java. It can change res/drawable/wechat to r/d/a, and rename the resource file wechat.png to a.png. Finally, it repackages the apk with 7zip, which can reduce the package size obviously.

AndResGuard is fast, and it does not need the source codes. Input a Android apk, then we can get a 'ResGuard' apk in a few seconds.

Some uses of AndResGuard are:

  1. Obfuscate android resources, it contain all the resource type(such as drawable、layout、string...). It can prevent your apk reversed by Apktool.

  2. Shrinking the apk size, it can reduce the resources.arsc and the package size obviously.

  3. Repackage with 7zip, it support repackage apk with 7zip, and we can specify the compression method for each file.

AndResGuard is a command-line tool, it supports Window、Linux and Mac. We suggest you to use 7zip in Linux or Mac platform for a higher compression ratio.

How to use

With Gradle

This has been released on Bintray

apply plugin: 'AndResGuard'

buildscript {
    dependencies {
        classpath 'com.tencent.mm:AndResGuard-gradle-plugin:1.1.5'
    }
}

andResGuard {
    mappingFile = null
    use7zip = false
    useSign = true
    keepRoot = false
    // add <yourpackagename>.R.drawable.icon into whitelist.
    // because the launcher will get the icon with his name
    whiteList = [
        //for your icon
        "<your_package_name>.R.drawable.icon",
        //for fabric
        "<your_package_name>.R.string.com.crashlytics.*",
        //for umeng update
        "<your_package_name>.R.string.umeng*",
        "<your_package_name>.R.string.UM*",
        "<your_package_name>.R.string.tb_*",
        "<your_package_name>.R.layout.umeng*",
        "<your_package_name>.R.layout.tb_*",
        "<your_package_name>.R.drawable.umeng*",
        "<your_package_name>.R.drawable.tb_*",
        "<your_package_name>.R.anim.umeng*",
        "<your_package_name>.R.color.umeng*",
        "<your_package_name>.R.color.tb_*",
        "<your_package_name>.R.style.*UM*",
        "<your_package_name>.R.style.umeng*",
        "<your_package_name>.R.id.umeng*"
    ]
    compressFilePattern = [
        "*.png",
        "*.jpg",
        "*.jpeg",
        "*.gif",
        "resources.arsc"
    ]
    zipAlignPath = 'your_zipalign_path'
    sevenZipPath = 'your_7zip_path'
}

Run andresguard/resguard task to generate compressed APK. This can be done in two ways:

If you are using AndroidStudio, you can find the generate task option in andresguard group. Or alternatively, you run ./gradlew resguard in your terminal.

Note: please put andResGuard block below SignConfigs in build.gradle file, we will use your signConfig info to repackage apk file.

With Command Line

    java -jar andresguard-x.x.x.jar -h

You can find a simple example in tools_output folder.

we can see the help description, The easiest way is : java -jar andresguard.jar input.apk. Then it would try to read the config,xml, and output the results to the directory with the name of input.apk.

  • -config, set the config file yourself, if not, the default path is the running location with name config.xml.

  • -out, set the output directory yourself, if not, the default directory is the running location with name of the input file

  • -signature, set sign property, following by parameters: signature_file_path storepass keypass storealias, if you set these, the sign data in the config file will be overlayed.

  • -mapping, set keep mapping property, following by parameters: mapping_file_path. if you set these, the mapping data in the config file will be overlayed.

  • -7zip, set the 7zip path, such as /home/shwenzhang/tools/7za, window will be end of 7za.exe.

Window: set 7za to environment variables。Address: http://sparanoid.com/lab/7z/download.html

linux: sudo apt-get install p7zip-full

mac: brew install p7zip

  • -zipalign, set the zipalign, such as /home/shwenzhang/sdk/tools/zipalign, window will be end of zipalign.exe.

  • -repackage, usually, when we build the channeles apk, it may destroy the 7zip. so you may need to use 7zip to repackage the apk

2.samples

java -jar resourceproguard.jar input.apk

if you want to special the output path or config file path, you can input:

java -jar resourceproguard.jar input.apk -config yourconfig.xml -out output_directory

if you want to special the sign or mapping data, you can input:

java -jar resourceproguard.jar input.apk -config yourconfig.xml
	-out output_directory -signature signature_file_path storepass_value
	keypass_value storealias_value -mapping mapping_file_path

if you want to special 7za or zipalign path, you can input:

java -jar resourceproguard.jar input.apk
 -7zip /shwenzhang/tool/7za  -zipalign /shwenzhang/sdk/tools/zipalign

if you just want to repackage an apk compress with 7z:

java -jar resourceproguard.jar -repackage input.apk -out output_directory
 -7zip /shwenzhang/tool/7za  -zipalign /shwenzhang/sdk/tools/zipalign

What we get

Normally, we can get the following 7 useful files:

During the process, we can see the cost time and the reduce size.

How to write config.xml file

There are five main configurations:property, whitelist, keepmapping, compress, sign。

1. Property

Common properties:

  • --sevenzip, whether use 7zip to repackage the signed apk, you must install the 7z command line version first.

  • --metaname, the sign data file name in your apk, default must be META-INF.

  • --keeproot, if keep root, res/drawable will be kept, it won't be changed to such as r/s.

2. Whitelist

Whitelist property is used for keeping the resource you want. Because some resource id you can not proguard, such as throug method getIdentifier.

  • --isactive, whether to use whitelist, you can set false to close it simply.

  • --path, you must write the full package name, such as com.tencent.mm.R.drawable.icon. For some reason, we should keep our icon better, and it support , ?, such as com.tencent.mm.R.drawable.emoji_ or com.tencent.mm.R.drawable.emoji_?

Warning:1. donot write the file format name, such com.tencent.mm.R.drawable.emoji.png；2. * mean .+, a* would not match a；

3. Keepmapping

sometimes if we want to keep the last way of obfuscation, we can use keepmapping mode. It is just like applymapping in ProGuard.

  • --isactive, whether to use keepmapping, you can set false to close it simply.

  • --path, the old mapping file, in window use , in linux use /, and the default path is the running location.

4. Compress

Compress can specify the compression method for each file(Stored or Deflate). Generally, 1. blow 2.3 version, if the source file is larger than 1M, then is can not be compressed; 2, streaming media can not be compressed, such as .wav, .mpg.

  • --isactive, whether to use compress, you can set false to close it simply.

  • --path, you must use / separation, and it support *, ?, such as *.png, *.jpg, res/drawable-hdpi/welcome_?.png.

The maximum confusion will be:

  1. paths:*.png, *.jpg, *.jpeg, *.gif

  2. resources.arsc

5. Sign

if you want to sign the apk, you should input following data, but if you want to use 7zip, you must fill them

  • --isactive, whether to use sign, you can set false to close it simply.

  • --path, the signature file path, in window use , in linux use /, and the default path is the running location.

  • --storepass, storepass value.

  • --keypass, keypass value.

  • --alias, alias value.

Warning: if you use -signature mode。these setting in config.xml will be overlayed.

FQA

  1. How to use compress flag If you use compess flag with .png、.gif、*.jpg，it will help you decrease the size of file resources.arsc NOTE: If your app support Android2.2 and below, the size of file resources.arsc should be below 1M.

  2. keepmapping flag impact on the size of increasing package keepmapping will help to keep your coherence in different version

  3. packages for different channel Repackage will make 7zip invalid，you should repackage all channel apk.

  4. wanna get resource with getIdentifier You should add these resources to whitelist. NOTE: You should add your icon to whitelist, because of some launchers' special implementation

  5. Use umeng or other sdk You should add umeng resource to whitelist

    <issue id="whitelist" isactive="true">
        <path value ="yourpackagename.R.string.umeng*" />   
        <path value ="yourpackagename.R.layout.umeng*" />
        <path value ="yourpackagename.R.drawable.umeng*" />
        <path value ="yourpackagename.R.anim.umeng*" />
        <path value ="yourpackagename.R.color.umeng*" />
        <path value ="yourpackagename.R.style.*UM*" />
        <path value ="yourpackagename.R.style.umeng*" />
        <path value ="yourpackagename.R.id.umeng*" />
    </issue>
  1. Use fabric

The Fabric Gradle plugin generates a unique identifier so that our backend can identify your builds. This identifier is used to deobfuscate crashes and distribute the correct versions of your beta test builds. The identifier will be added to your res/values and looks like: RANDOM_UUID

The Fabric will get this value with exact name, so we add it to whitelist.

    "<your_package_name>.R.string.com.crashlytics.*"