### 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](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.
## FAQ
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
```xml
```
6. 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.
```
".R.string.com.crashlytics.*"
```