Android开发者必备：AndResGuard极速上手教程（3分钟搞定资源混淆）

Android开发者必备：AndResGuard极速上手教程（3分钟搞定资源混淆）

【免费下载链接】AndResGuard proguard resource for Android by wechat team 项目地址: https://gitcode.com/gh_mirrors/an/AndResGuard

你还在为APK体积过大而烦恼吗？还在手动压缩图片、删除冗余资源吗？本文将带你3分钟极速上手微信团队开发的Android资源混淆工具AndResGuard，通过自动化资源混淆技术，轻松为你的应用瘦身30%以上。读完本文，你将掌握：AndResGuard核心原理、Gradle插件集成步骤、关键配置参数解析、常见问题解决方案，以及主流第三方SDK的白名单配置。

什么是AndResGuard

AndResGuard是微信团队开发的Android资源混淆工具，原理类似Java ProGuard，但专门针对资源文件进行优化。它能将冗长的资源路径（如res/drawable/wechat）混淆为简短路径（如r/d/a），同时支持资源压缩、签名和重打包，最终显著减小APK体积。项目核心代码位于AndResGuard-core/目录，包含资源解码、混淆映射和APK重打包等关键实现。

为什么选择AndResGuard

• 高效压缩：平均可减少APK体积15-30%，微信实测节省近20MB
• 完全自动化：支持Gradle插件和命令行两种方式，无缝集成到现有构建流程
• 安全稳定：已在微信、QQ等亿级应用验证，兼容Android 4.0+所有版本
• 灵活配置：提供白名单、资源合并、签名管理等丰富功能

快速开始：Gradle插件集成

1. 添加依赖

在项目根目录的build.gradle中添加插件依赖：

buildscript {
    repositories {
        jcenter()
        google()
    }
    dependencies {
        classpath 'com.tencent.mm:AndResGuard-gradle-plugin:1.2.21'
    }
}

插件源码定义在AndResGuard-gradle-plugin/src/main/groovy/com/tencent/gradle/AndResGuardPlugin.groovy，主要实现了Gradle任务的创建和配置解析。

2. 应用插件

在App模块的build.gradle中应用插件：

apply plugin: 'AndResGuard'

andResGuard {
    use7zip = true           // 使用7zip压缩
    useSign = true           // 保留签名信息
    keepRoot = false         // 不保留资源根目录
    mergeDuplicatedRes = true // 合并重复资源
    
    // 白名单配置
    whiteList = [
        "R.drawable.icon",   // 应用图标
        "R.string.com.crashlytics.*" // Crashlytics相关字符串
    ]
    
    // 压缩文件类型
    compressFilePattern = [
        "*.png", "*.jpg", "*.jpeg", "*.gif"
    ]
}

配置类AndResGuardExtension.groovy定义了所有支持的参数及其默认值，如fixedResName可设置统一的资源名称前缀，digestalg可指定签名摘要算法。

3. 执行混淆任务

通过Android Studio的Gradle面板找到andresguard组下的对应任务（如resguardRelease），或直接执行命令：

./gradlew resguardRelease

任务执行成功后，混淆后的APK和资源映射文件会输出到app/build/outputs/apk/release/目录，映射文件命名格式为resource_mapping_<variant>.txt，可用于版本间资源一致性维护。

核心功能解析

资源混淆原理

AndResGuard通过修改resources.arsc文件中的资源名称映射，将长路径替换为短路径，同时重命名APK中的资源文件。以下是混淆前后的资源路径对比：

混淆前	混淆后
res/drawable/ic_launcher.png	r/d/a.png
res/layout/activity_main.xml	r/l/b.xml
res/values/strings.xml	r/v/c.xml

这种转换不会影响资源的引用关系，因为Android系统通过资源ID而非路径访问资源。核心实现位于ResourceRepackage.java，负责解析和重写资源表。

白名单机制

对于通过getResources().getIdentifier()动态访问的资源，必须加入白名单防止混淆。官方文档white_list.md提供了主流SDK的白名单配置，例如友盟统计需要添加：

whiteList = [
    "yourpackagename.R.string.umeng*",
    "yourpackagename.R.layout.umeng*",
    "yourpackagename.R.drawable.umeng*"
]

白名单匹配逻辑支持*（任意字符序列）和?（单个字符）通配符，实现代码位于ARSCDecoder.java的资源名称过滤部分。

7zip极致压缩

开启use7zip=true后，工具会使用7zip对APK进行极限压缩。相比默认的ZIP压缩，7zip的LZMA算法能进一步减少10-15%的体积。7zip可执行文件位于SevenZip/executable/目录，包含Windows、Linux和macOS的不同架构版本。

微信团队测试数据显示，在Linux环境下使用7zip压缩效果最佳，比Windows环境平均多节省8%的空间。配置7zip路径的方法：

andResGuard {
    sevenzip {
        path = "/usr/local/bin/7za"  // 自定义7zip路径
        // artifact = 'com.tencent.mm:SevenZip:1.2.21' // 或使用Maven依赖
    }
}

最佳实践与常见问题

第三方SDK兼容处理

许多第三方SDK通过反射或动态资源访问，需要添加特定白名单。以下是常见SDK的配置示例：

友盟统计

whiteList = [
    "R.string.umeng*",
    "R.layout.umeng*",
    "R.drawable.umeng*",
    "R.id.umeng*"
]

极光推送

whiteList = ["R.drawable.jpush_notification_icon"]

完整的第三方SDK白名单配置可参考doc/white_list.md，该文件维护了友盟、个推、Firebase等20+ SDK的兼容配置。

增量更新支持

通过指定旧的映射文件，可保持资源名称的一致性，减少增量更新包体积：

andResGuard {
    mappingFile = file("./resource_mapping_old.txt")
}

实验数据显示，使用相同映射文件时，微信5.4版本相对于5.3.1版本的增量包仅增加371KB，而不使用映射文件时增量包增加2.1MB。具体测试方法和数据可参考doc/how_to_work.zh-cn.md中的"keepmapping方式对增量包大小的影响"章节。

常见问题解决

1. 资源找不到异常（Resources$NotFoundException）

原因：动态访问的资源未加入白名单
解决：全局搜索getIdentifier调用，将相关资源添加到白名单，例如：

// 需添加到白名单的动态资源访问
int resId = getResources().getIdentifier("icon_" + type, "drawable", getPackageName());

2. 7zip压缩后APK安装失败

原因：Windows环境下7zip压缩效果较差
解决：使用Linux或macOS环境构建，或在配置中关闭7zip压缩：

andResGuard {
    use7zip = false
}

3. 渠道包体积增大

原因：渠道包生成工具破坏7zip压缩格式
解决：使用AndResGuard的repackage命令重新压缩：

java -jar andresguard.jar -repackage input.apk -out output_dir

高级配置示例

完整配置模板

以下是生产环境常用的完整配置，包含签名管理、多渠道支持和增量混淆：

andResGuard {
    use7zip = true
    useSign = true
    keepRoot = false
    fixedResName = "arg"  // 统一资源名称前缀
    mergeDuplicatedRes = true
    digestalg = "SHA-256" // 签名摘要算法
    
    // 白名单配置
    whiteList = [
        "R.drawable.icon",
        "R.string.com.crashlytics.*",
        "R.string.google_app_id",
        "R.layout.umeng*"
    ]
    
    // 压缩文件模式
    compressFilePattern = [
        "*.png", "*.jpg", "*.jpeg", "*.gif", "*.webp"
    ]
    
    // 7zip配置
    sevenzip {
        artifact = 'com.tencent.mm:SevenZip:1.2.21'
    }
    
    // 输出路径
    finalApkBackupPath = "${project.rootDir}/output/apk/${variant.name}.apk"
}

命令行工具使用

除Gradle插件外，AndResGuard还提供命令行工具，位于tool_output/AndResGuard-cli-1.2.15.jar。基本用法：

java -jar AndResGuard-cli-1.2.15.jar input.apk -config config.xml -out output_dir

命令行参数支持指定配置文件、输出目录、签名信息等，详细说明可通过-h参数查看，或参考doc/how_to_work.zh-cn.md的"使用命令行"章节。

总结与展望

AndResGuard作为微信团队开源的资源优化工具，凭借其高效的压缩率和稳定的兼容性，已成为Android开发必备工具。通过本文介绍的3分钟快速集成方案，你可以立即为项目启用资源混淆，显著减小APK体积。

未来版本计划支持更多高级特性，如资源按需加载、WebP自动转换和动态功能模块混淆。项目源码托管在GitCode，欢迎贡献代码和白名单配置：

git clone https://gitcode.com/gh_mirrors/an/AndResGuard.git

最后，推荐配合ProGuard代码混淆和Android Studio的"Remove Unused Resources"功能，实现APK体积的极致优化。

扩展阅读：

• 官方文档：README.zh-cn.md
• 混淆原理：doc/how_to_work.zh-cn.md
• 白名单大全：doc/white_list.md

【免费下载链接】AndResGuard proguard resource for Android by wechat team 项目地址: https://gitcode.com/gh_mirrors/an/AndResGuard