【亲测免费】 AndResGuard 安装和配置指南

1. 项目基础介绍

AndResGuard 是一个由微信团队开源的工具，旨在帮助开发者减少 Android APK 的大小。它通过混淆资源文件路径和名称来实现这一目标，类似于 Java 的 ProGuard 工具，但仅针对资源文件。AndResGuard 支持 Windows、Linux 和 Mac 操作系统，并且不需要源代码即可工作。

主要编程语言

AndResGuard 主要使用 Java 和 Groovy 编写。

2. 项目使用的关键技术和框架

• 资源混淆：通过改变资源文件的路径和名称来减少 APK 大小。
• 7zip 压缩：支持使用 7zip 对 APK 进行压缩，进一步减少包体大小。
• Gradle 插件：提供 Gradle 插件，方便集成到 Android 项目的构建流程中。

3. 项目安装和配置的准备工作和详细步骤

准备工作

1. 安装 Java 开发环境：确保你的系统上已经安装了 Java JDK，并且配置了 JAVA_HOME 环境变量。
2. 安装 Android Studio：如果你还没有安装 Android Studio，请先下载并安装。
3. 配置 Gradle：确保你的 Android 项目已经正确配置了 Gradle。

详细安装步骤

步骤 1：在项目中引入 AndResGuard 插件

首先，在你的项目根目录下的 build.gradle 文件中添加 AndResGuard 插件的依赖：

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

步骤 2：在 app 模块中应用插件

在 app 模块的 build.gradle 文件中应用 AndResGuard 插件：

apply plugin: 'AndResGuard'

andResGuard {
    mappingFile = null
    use7zip = true
    useSign = true
    keepRoot = false
    fixedResName = "arg"
    mergeDuplicatedRes = true
    whiteList = [
        // 添加你需要保留的资源文件
        "R.drawable.icon",
        "R.string.app_name"
    ]
    compressFilePattern = [
        "*.png",
        "*.jpg",
        "*.jpeg",
        "*.gif"
    ]
    sevenzip {
        artifact = 'com.tencent.mm:SevenZip:1.2.21'
    }
}

步骤 3：配置白名单

在 whiteList 中添加你需要保留的资源文件路径。这些资源文件将不会被混淆。

步骤 4：运行 AndResGuard

在 Android Studio 中，你可以通过 Gradle 任务来运行 AndResGuard。打开 Gradle 面板，找到 andresguard 任务组，然后运行 resguard[BuildType] 任务。例如，如果你要生成一个 Release 版本的 APK，可以运行 resguardRelease 任务。

步骤 5：检查生成的 APK

AndResGuard 会在你指定的路径下生成一个新的 APK 文件。你可以使用 adb install 命令来安装这个 APK，或者直接在设备上安装并测试。

注意事项

• 7zip 压缩：建议在 Linux 或 Mac 平台上使用 7zip 进行压缩，以获得更高的压缩比。
• 白名单：确保所有通过 getIdentifier 访问的资源都添加到白名单中，以避免运行时错误。

通过以上步骤，你就可以成功地在你的 Android 项目中集成并使用 AndResGuard 来减少 APK 的大小。