Android--资源混淆工具使用说明

最新推荐文章于 2026-01-06 14:58:25 发布

原创最新推荐文章于 2026-01-06 14:58:25 发布 · 1.2k 阅读

0 ·

CC 4.0 BY-SA版权

android-utils 专栏收录该内容

52 篇文章

订阅专栏

本文介绍了Android资源混淆工具AndResGuard的使用方法，包括如何通过Gradle集成、混淆APK生成、白名单配置以及已知问题。该工具能够帮助减小APK大小，类似于Java的Proguard，但专门针对资源进行混淆。请注意，v2签名可能会影响7zip压缩效果，需要根据需求调整签名设置。

https://github.com/shwenzhang/AndResGuard/blob/master/README.zh-cn.md

Android资源混淆工具使用说明

其他语言版本: English, 简体中文.

AndResGuard是一个帮助你缩小APK大小的工具，他的原理类似Java Proguard，但是只针对资源。他会将原本冗长的资源路径变短，例如将res/drawable/wechat变为r/d/a。

AndResGuard不涉及编译过程，只需输入一个apk(无论签名与否，debug版，release版均可，在处理过程中会直接将原签名删除)，可得到一个实现资源混淆后的apk(若在配置文件中输入签名信息，可自动重签名并对齐，得到可直接发布的apk)以及对应资源ID的mapping文件。

原理介绍：详见WeMobileDev公众号文章

注意: v2签名会使得7zip压缩失效，如果你对apk大小有极致的要求，可以在signingConfigs中关闭v2签名

使用Gradle

此工具已发布在Bintray

apply plugin: 'AndResGuard'

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


andResGuard {
    // mappingFile = file("./resource_mapping.txt")
    mappingFile = null
    // 当你使用v2签名的时候，7zip压缩是无法生效的。
    use7zip = true
    useSign = true
    // 打开这个开关，会keep住所有资源的原始路径，只混淆资源的名字
    keepRoot = false
    whiteList = [
        // for your icon
        "R.drawable.icon",
        // for fabric
        "R.string.com.crashlytics.*",
        // for google-services
        "R.string.google_app_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",
        "R.string.google_crash_reporting_api_key"
    ]
    compressFilePattern = [
        "*.png",
        "*.jpg",
        "*.jpeg",
        "*.gif",
        "resources.arsc"
    ]
     sevenzip {
         artifact = 'com.tencent.mm:SevenZip:1.2.3'
         //path = "/usr/local/bin/7za"
    }
}

使用Android Studio的同学可以再 andresguard 下找到相关的构建任务; 命令行可直接运行./gradlew resguard[BuildType | Flavor]，这里的任务命令规则和assemble一致。

在设置sevenzip时, 你只需设置artifact或path. 支持同时设置,总以path的值为优先.

最终的混淆APK会生成在{App}/build/output/apk/AndResGuard_{apk_name}/{apk_name}_signed_7zip_aligned.apk。

请使用Umeng_social_sdk的同学特别留意将资源加入白名单，否则会出现Crash。可以在white_list.md查看更多sdk的白名单配置，也欢迎大家PR自己的白名单

白名单机制只作用于资源的specsName，不会keep住资源的路径。如果想keep住资源原有的物理路径，可以使用mappingFile。例如我想keep住icon所有folder，可以在mappingFile指向的文件添加：

res path mapping:
    res/mipmap-hdpi-v4 -> res/mipmap-hdpi-v4
    res/mipmap-mdpi-v4 -> res/mipmap-mdpi-v4
    res/mipmap-xhdpi-v4 -> res/mipmap-xhdpi-v4
    res/mipmap-xxhdpi-v4 -> res/mipmap-xxhdpi-v4
    res/mipmap-xxxhdpi-v4 -> res/mipmap-xxxhdpi-v4

点击查看更多细节和命令行使用方法