微信团队原创Android资源混淆工具：AndResGuard [有源码]

JackJiang · 8 年前

前言

本文主要是讲述资源混淆组件的用法以及性能，资源混淆组件不涉及编译过程，只需输入一个apk(无论签名与否，debug版，release版均可，在处理过程中会直接将原签名删除)，可得到一个实现资源混淆后的apk(若在配置文件中输入签名信息，可自动重签名并对齐，得到可直接发布的apk)以及对应资源ID的mapping文件。同时可在配置文件中指定白名单，压缩文件(支持*，？通配符)，支持自动签名，保持旧mapping，7z重打包，对齐等功能。

本工具支持Linux、Window跨平台使用，但测试表示若使用7z压缩，Linux下的压缩率更高。

源码和下载

源码同步：点此进入
最新版本：点此下载

使用Gradle

此工具已发布在Bintray。

apply plugin: 'AndResGuard'

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


andResGuard {
    mappingFile = null
    use7zip = false
    keepRoot = false
    // add <yourpackagename>.R.drawable.icon into whitelist.
    // because the launcher will get thgge icon with his name
    whiteList = [
           "<your_package_name>.R.drawable.icon"
           "<your_package_name>.R.string.com.crashlytics.*"
    ]
    compressFilePattern = [
            "*.png",
            "*.jpg",
            "*.jpeg",
            "*.gif",
            "resources.arsc"
    ]
    zipAlignPath = 'your_zipalign_path'
    sevenZipPath = 'your_7zip_path'
}

运行andresguard/resguard的gradle任务，可以得到资源混淆的安装包命令行可直接运行./gradlew resguard。
注意: 在build.gradle文件中请把andResGuard的相关配置放在签名信息的下面,会自动使用你的签名信息用户重新打包APK。

如何使用资源混淆工具

1命令行方式：tools_output文件夹有使用命令行工具的简单例子,可以参考

我们先看看它的help描述，最简单的使用方式是：java -jar andresguard.jar input.apk，此时会读取运行路径中的config.xml文件，并将结果输出到运行路径中的input(输入apk的名称)中。当然你也可以自己定义：

-config, 指定具体config文件的路径；

-out, 指定具体的输出路径；混淆的mapping会在输出文件夹中以resource_mapping_input(输入apk的名称).txt命名。

-signature, 指定签名信息，若在命令行设置会覆盖config.xml中的签名信息，顺序为签名文件路径、storepass、keypass、storealias。

-mapping, 指定旧的mapping文件，保证同一资源文件在不同版本混淆后的名称保持一致。若在命令行设置会覆盖config.xml中的信息。

-7zip, 指定7zip的路径，若已添加到环境变量不需要设置。应是全路径例如linux: /shwenzhang/tool/7za, Window需要加上.exe 结尾。

[pquoteH]window：对于window应下载命名行版本，若将7za指定到环境变量，即无须设置。地址：http://sparanoid.com/lab/7z/download.html
linux：sudo apt-get install p7zip-full
mac:sudo brew install p7zip[/pquoteH]
-zipalign, 指定zipalign的路径，若已添加到环境变量不需要设置。应是全路径例如linux: /shwenzhang/sdk/tools/zipalign, Window需要加上.exe结尾。

-repackage, 如果想要出渠道包等需求，我们可能希望利用7zip直接重打包安装包。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f467373413539612e6a7067.jpeg

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f467373413539612e6a7067.jpeg

2简单用法

java -jar andresguard.jar input.apk

若想指定配置文件或输出目录：

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

若想指定签名信息或mapping信息：

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

若想指定7zip或zipalign的路径(若已设置环境变量，这两项不需要单独设置)：

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

若想用7zip重打包安装包，同时也可指定output路径，指定7zip或zipalign的路径(此模式其他参数都不支持)：

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

使用资源混淆工具会得到什么

正常来说，我们可得到以下output路径得到以下7个有用的文件(需要把zipalign也加入环境变量)：
微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f554474784b714f2e706e67.png

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f554474784b714f2e706e67.png

混淆过程中会输出log,主要是可看到耗费时间，以及相对输入apk减少的大小：
微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f4943446b4a43482e706e67.png

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f4943446b4a43482e706e67.png

如何写配置文件

配置文件中主要有五大项，即property，whitelist, keepmapping, compress,sign。

1Property项

Property主要设置一些通用属性：

--sevenzip, 是否使用7z重新压缩签名后的apk包(这步一定要放在签名后，不然签名时会破坏效果)，需要我们安装7z命令行，同时加入环境变量中，同时要求输入签名信息(不然不会使用)。

Window：7z command line version, 即7za（7-zip.org/download.html）
Linux: 可直接sudo apt-get install p7zip-full。

注意：效果很好，推荐使用，并且在Linux(Mac的高富帅也可)上。

--metaname, 由于重打包时需要删除签名信息，考虑到这个文件名可能会被改变，所以使用者可手动输入签名信息对应的文件名。默认为META_INF。

--keeproot, 是否将res/drawable混淆成r/s

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f4a666b5a3039652e676966.gif

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f4a666b5a3039652e676966.gif

2Whitelist项

Whitelist主要是用来设置白名单，由于我们代码中某些资源会通过getIdentifier(需要全局搜索所有用法并添加到白名单)或动态加载等方式，我们并不希望混淆这部分的资源ID：

--isactive, 是否打开白名单功能；

--path, 是白名单的项，格式为package_name.R.type.specname,由于一个resources.arsc中可能会有多个包，所以这里要求写全包名。同时支持，？通配符，例如: com.tencent.mm.R.drawable.emoji_、com.tencent.mm.R.drawable.emoji_？；

注意:1.不能写成com.tencent.mm.R.drawable.emoji.png，即带文件后缀名；2. 通配符代表.+,即a,不能匹配到a。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f565a34664f61322e676966.gif

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f565a34664f61322e676966.gif

3Keepmapping项

Keepmapping主要用来指定旧的mapping文件，为了保持一致性，我们支持输入旧的mapping文件，可保证同一资源文件在不同版本混淆后的名称保持一致。另一方面由于我们需要支持增量下载方式，如果每次改动都导致所有文件名都会更改，这会导致增量文件增大，但测试证明影响并不大(后面有测试数据)。

--isactive, 是否打开keepmapping模式；

--path, 是旧mapping文件的位置，linux用/, window用 \。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_3.gif

微信团队原创Android资源混淆工具：AndResGuard [有源码]_3.gif

4Compress项

Compress主要用来指定文件重打包时是否压缩指定文件，默认我们重打包时是保持输入apk每个文件的压缩方式(即Stored或者Deflate)。一般来说，1、在2.3版本以下源文件大于1M不能压缩；2、流媒体不能压缩。对于.png、.jpg是可以压缩的，只是AssetManger读取时候的方式不同。

--isactive, 是否打开compress模式；

--path, 是需要被压缩文件的相对路径(相对于apk最顶层的位置)，这里明确一定要使用‘/’作为分隔符，同时支持通配符，？，例如.png(压缩所有.png文件)，res/drawable/emjio_?.png，resouces.arsc(压缩 resources.arsc)

注意若想得到最大混淆：

输入四项个path:*.png, *.jpg, *.jpeg, *.gif
若你的resources.arsc原文件小于1M，可加入resourcs.arsc这一项！若不需要支持低版本，直接加入也可。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_4.gif

5Sign项

Sign主要是对处理后的文件重签名，需要我们输入签名文件位置，密码等信息。若想使用7z功能就一定要填入相关信息。

--isactive, 是否打开签名功能；

--path, 是签名文件的位置，linux用/, window用 \;

--storepass, 是storepass的数值;

--keypass, 是keypass的数值;

--alias, 是alias的数值。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_6.gif

微信团队原创Android资源混淆工具：AndResGuard [有源码]_6.gif

注意： 若出于保密不想写在config.xml，可用-signature命令行设置模式。config.xml中的签名信息会被命令行覆盖。

需要注意的问题

compress参数对混淆效果的影响若指定compess 参数.png、.gif以及*.jpg，resources.arsc会大大减少安装包体积。若要支持2.2，resources.arsc需保证压缩前小于1M。
操作系统对7z的影响实验证明，linux与mac的7z效果更好
keepmapping方式对增量包大小的影响影响并不大，但使用keepmapping方式有利于保持所有版本混淆的一致性
渠道包的问题(建议通过修改zip摘要的方式生产渠道包) 在出渠道包的时候，解压重压缩会破坏7zip的效果，通过repackage命令可用7zip重压缩。
若想通过getIdentifier方式获得资源，需要放置白名单中。部分手机桌面快捷图标的实现有问题，务必将程序桌面icon加入白名单。
对于一些第三方sdk,例如友盟，可能需要将部分资源添加到白名单中。

    <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*" />
        <path value ="yourpackagename.R.string.com.crashlytics.*" />
    </issue>

应用实例（含测试数据）

1基本的耗时与效果

以微信的5.4为例，使用组件中的resoureproguard.jar进行资源混淆，具体的性能数据如下：

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f3869363271624a2e6a7067.jpeg

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f3869363271624a2e6a7067.jpeg

说明：其中时间指的是从最开始到该步骤完成的时间，而不是每步骤独立时间。

2 compres参数(下文有详细描述，是否压缩某些资源)对安装包大小的影响

若指定compess 参数.png、.gif以及*.jpg，resources.arsc对安装包大小影响如下：

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f346b576777366f2e6a7067.jpeg

微信团队原创Android资源混淆工具：AndResGuard [有源码]_687474703a2f2f692e696d6775722e636f6d2f346b576777366f2e6a7067.jpeg

说明：resources.arsc如果原文件大于1M，压缩后是不能在系统2.3以下运行的。

3操作系统对7z的影响

由于7z过程中使用的是极限压缩模式，所以遍历次数会增多(7次)，时间相对会比较长。假设不使用7z在单核的虚拟机中仅需10秒。同时我们需要注意是由于文件系统不一致，在window上面使用7z生成的安装包会较大，微信在window以及linux下7z的效果如下：

微信团队原创Android资源混淆工具：AndResGuard [有源码]_1.png

微信团队原创Android资源混淆工具：AndResGuard [有源码]_1.png

说明：所以最后出包请使用Linux(Mac亦可)，具体原因应该与文件系统有关。

4keepmapping方式(下文有详细描述，是否保持旧的mapping)对增量包大小的影响

我们一般使用bsdiff生成增量包，bsdiff差分的是二进制，利用LCS最长公共序列算法。假设分别使用正序与逆序混淆规则对微信5.4作资源混淆(即它们的混淆方式是完全相反的)。

微信团队原创Android资源混淆工具：AndResGuard [有源码]_2.png

事实上，它们的差分是不需要371kb,因为有比较大的文件格式，共同标记部分。

现在我们做另外一个实验，首先对微信5.3.1作资源混淆得到安装包a，然后以keepmapping方式对微信5.4作资源混淆得到安装包b，最后以完全逆序的方式对微信5.4作资源混淆得到安装包c。

分别用安装包b、c对安装包a生成增量文件d,e。比较增量文件d、e的大小，分别如下：

微信团队原创Android资源混淆工具：AndResGuard [有源码]_3.png

微信团队原创Android资源混淆工具：AndResGuard [有源码]_3.png

说明：所以增量文件的大小并不是我们采用keepmapping方式的主要考虑因素，保持混淆的一致性，便于查找问题或是更加重要的考虑。

5安装包缩减的原因与影响因素

总结，安装包大小减少的原因以下四个：
微信团队原创Android资源混淆工具：AndResGuard [有源码]_11.png

相对的，可得到影响效果的因素有以下几个：
微信团队原创Android资源混淆工具：AndResGuard [有源码]_22.png

附录1：全站精品资源下载

附录2：全站即时通讯技术资料分类

附录：有关QQ、微信的文章汇总

[1] 有关QQ、微信的技术文章：
《微信后台团队：微信后台异步消息队列的优化升级实践分享》
《微信团队原创分享：微信客户端SQLite数据库损坏修复实践》
《腾讯原创分享(一)：如何大幅提升移动网络下手机QQ的图片传输速度和成功率》
《腾讯原创分享(二)：如何大幅压缩移动网络下APP的流量消耗（下篇）》
《腾讯原创分享(二)：如何大幅压缩移动网络下APP的流量消耗（上篇）》
《微信Mars：微信内部正在使用的网络层封装库，即将开源》
《如约而至：微信自用的移动端IM网络层跨平台组件库Mars已正式开源》
《开源libco库：单机千万连接、支撑微信8亿用户的后台框架基石 [源码下载]》
《微信新一代通信安全解决方案：基于TLS1.3的MMTLS详解》
《微信团队原创分享：Android版微信后台保活实战分享(进程保活篇)》
《微信团队原创分享：Android版微信后台保活实战分享(网络保活篇)》
《Android版微信从300KB到30MB的技术演进(PPT讲稿) [附件下载]》
《微信团队原创分享：Android版微信从300KB到30MB的技术演进》
《微信技术总监谈架构：微信之道——大道至简(演讲全文)》
《微信技术总监谈架构：微信之道——大道至简(PPT讲稿) [附件下载]》
《如何解读《微信技术总监谈架构：微信之道——大道至简》》
《微信海量用户背后的后台系统存储架构(视频+PPT) [附件下载]》
《微信异步化改造实践：8亿月活、单机千万连接背后的后台解决方案》
《微信朋友圈海量技术之道PPT [附件下载]》
《微信对网络影响的技术试验及分析（论文全文）》
《一份微信后台技术架构的总结性笔记》
《架构之道：3个程序员成就微信朋友圈日均10亿发布量[有视频]》
《快速裂变：见证微信强大后台架构从0到1的演进历程（一）》
《快速裂变：见证微信强大后台架构从0到1的演进历程（二）》
《微信团队原创分享：Android内存泄漏监控和优化技巧总结》
《全面总结iOS版微信升级iOS9遇到的各种“坑”》
《微信团队原创资源混淆工具：让你的APK立减1M》
《微信团队原创Android资源混淆工具：AndResGuard [有源码]》
《Android版微信安装包“减肥”实战记录》
《iOS版微信安装包“减肥”实战记录》
《移动端IM实践：iOS版微信界面卡顿监测方案》
《微信“红包照片”背后的技术难题》
《移动端IM实践：iOS版微信小视频功能技术方案实录》
《移动端IM实践：Android版微信如何大幅提升交互性能（一）》
《移动端IM实践：Android版微信如何大幅提升交互性能（二）》
《移动端IM实践：实现Android版微信的智能心跳机制》
《移动端IM实践：WhatsApp、Line、微信的心跳策略分析》
《移动端IM实践：谷歌消息推送服务(GCM)研究（来自微信）》
《移动端IM实践：iOS版微信的多设备字体适配方案探讨》
>> 更多同类文章 ……

[2] 有关QQ、微信的技术故事：
《技术往事：创业初期的腾讯——16年前的冬天，谁动了马化腾的代码》
《技术往事：史上最全QQ图标变迁过程，追寻IM巨人的演进历史》
《开发往事：深度讲述2010到2015，微信一路风雨的背后》
《开发往事：微信千年不变的那张闪屏图片的由来》
《开发往事：记录微信3.0版背后的故事（距微信1.0发布9个月时）》
《一个微信实习生自述：我眼中的微信开发团队》
>> 更多同类文章 ……

2 楼: 冈阪日川 · 8 年前

已fork源码，感谢作者哦

3 楼: HelloKing · 8 年前

感谢混淆后的效果并不是特别明显，对于一般的app不说费那么大劲有点不值。
但需要极致优化的APP来说至少这是一个不错的选择。

神秘人 *发表于 8 年前* · 发表于 8 年前

<issue id="keepmapping" isactive="true">
      <path value="/app/mapping.txt"/>
</issue>
将keepmapping打开后，报错求解！！！！！
Exception in thread "main" java.lang.RuntimeException: Error while mapping file
      at com.tencent.mm.resourceproguard.Configuration.processOldMappingFile(Configuration.java:472)
      at com.tencent.mm.resourceproguard.Configuration.readOldMapping(Configuration.java:395)
      at com.tencent.mm.resourceproguard.Configuration.loadMappingFilesFromXml(Configuration.java:351)
      at com.tencent.mm.resourceproguard.Configuration.readXmlConfig(Configuration.java:190)
      at com.tencent.mm.resourceproguard.Configuration.<init>(Configuration.java:80)
      at com.tencent.mm.resourceproguard.cli.CliMain.loadConfigFromXml(CliMain.java:208)
      at com.tencent.mm.resourceproguard.cli.CliMain.run(CliMain.java:176)
      at com.tencent.mm.resourceproguard.cli.CliMain.main(CliMain.java:36)

5 楼: JackJiang · 8 年前

引用：吾夢依然发表于 2016-11-29 15:43
将keepmapping打开后，报错求解！！！！！
Exception in thread "main" java.lang. ...

这个错误是怎么发生的？混淆的时候？

6 楼: kaydxh · 7 年前

不错噢

本文目录

前言

相关文章

源码和下载

使用Gradle