Android资源混淆工具AndResGuard完整使用指南

Android资源混淆工具AndResGuard完整使用指南

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

项目概述

AndResGuard是一款专为Android应用设计的资源混淆工具，由微信团队开发。该工具通过缩短资源文件路径和重命名资源文件，有效减小APK体积，提升应用性能和安全性。

核心功能特性

AndResGuard具有以下突出优势：

• 显著压缩效果：通过资源路径混淆，将冗长的资源路径如res/drawable/wechat缩短为r/d/a
• 安全保障：防止资源被轻易反编译，保护应用资源
• 简单易用：无需复杂配置，支持命令行和Gradle插件两种使用方式
• 兼容性强：支持所有类型的APK文件，包括debug版和release版

快速开始

使用Gradle插件方式

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

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

在app模块的build.gradle文件中应用插件并配置：

apply plugin: 'AndResGuard'

andResGuard {
    mappingFile = null
    use7zip = true
    useSign = true
    keepRoot = false
    fixedResName = "arg"
    mergeDuplicatedRes = true
    whiteList = [
        "R.drawable.icon",
        "R.string.com.crashlytics.*",
        "R.string.google_app_id"
    ]
    compressFilePattern = [
        "*.png",
        "*.jpg",
        "*.jpeg",
        "*.gif"
    ]
}

执行混淆任务：

./gradlew resguard

使用命令行方式

项目提供了命令行工具，位于tool_output/AndResGuard-cli-1.2.15.jar。基本使用方法：

java -jar AndResGuard-cli-1.2.15.jar input.apk

如需自定义配置：

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

详细配置说明

白名单配置

白名单用于保护通过getIdentifier方式访问的资源，确保应用正常运行：

whiteList = [
    "R.drawable.icon",           // 应用图标
    "R.string.com.crashlytics.*", // Crashlytics相关字符串
    "R.string.google_app_id",     // Google服务ID
    "R.string.gcm_defaultSenderId",
    "R.string.default_web_client_id",
    "R.string.ga_trackingId",
    "R.string.firebase_database_url",
    "R.string.google_api_key"
]

压缩文件配置

指定需要压缩的文件类型，进一步提升压缩效果：

compressFilePattern = [
    "*.png",
    "*.jpg", 
    "*.jpeg",
    "*.gif"
]

7Zip压缩配置

启用7Zip压缩可以获得更好的压缩效果：

sevenzip {
    artifact = 'com.tencent.mm:SevenZip:1.2.21'
}

最佳实践建议

配置优化策略

1. 白名单管理：仔细检查代码中所有使用getIdentifier的地方，确保相关资源已加入白名单
2. 7Zip使用：在Linux或Mac系统上使用7Zip压缩，效果最佳
3. 资源合并：启用mergeDuplicatedRes选项，合并重复资源
4. 签名配置：确保正确配置签名信息，以便自动重签名

注意事项

• 对于需要发布到Google Play的应用，建议不要使用7Zip压缩，以免影响Google Play的优化补丁算法
• 如果对APK大小没有极致要求，不要将resources.arsc添加到压缩文件模式中
• 确保应用图标相关资源加入白名单，避免桌面快捷方式出现问题

效果验证

根据实际项目测试数据，使用AndResGuard可以获得显著的压缩效果：

• 微信项目APK体积减少约15%
• 其他大型应用平均压缩率在10%-20%之间
• 压缩后的APK在下载和安装速度上都有明显提升

常见问题解决

资源访问问题

如果应用中使用了getIdentifier动态获取资源，必须将相关资源添加到白名单中。常见的第三方SDK如友盟、Crashlytics等都需要配置相应的白名单规则。

版本兼容性

• 支持Android 2.2及以上版本
• 对于resources.arsc文件，如果原文件大于1M，在Android 2.3以下设备上可能无法正常运行

项目结构说明

AndResGuard项目包含多个模块：

• AndResGuard-core：核心功能实现
• AndResGuard-gradle-plugin：Gradle插件
• AndResGuard-cli：命令行工具
• AndResGuard-example：使用示例
• SevenZip：7Zip压缩支持

每个模块都提供了详细的配置示例和使用说明，开发者可以参考示例项目快速上手。

通过合理配置和使用AndResGuard，开发者可以有效减小应用体积，提升用户体验，同时增强应用的安全性防护。

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