proguard

快速开始 • 特性 • 贡献 • 许可证

ProGuard 是一个免费的 Java 字节码压缩、优化、混淆和预校验工具：

它可以检测并移除未使用的类、字段、方法和属性。
它可以优化字节码并移除未使用的指令。
它可以使用简短的无意义名称重命名剩余的类、字段和方法。

经过处理的应用程序和库文件更小、运行更快。

❓ 获取帮助

如果您有使用或一般问题，请在 Guardsquare 社区中提问。

请使用问题追踪器来报告实际的错误 🐛、崩溃等问题。

🚀 快速开始

命令行

首先，从 GitHub releases 下载最新版本。

在 Linux/MacOS 上运行 ProGuard，只需输入：

bin/proguard.sh <选项...>

在 Windows 上：

bin\proguard.bat <选项...>

通常，您会将大多数选项放在配置文件中（比如 myconfig.pro），然后只需调用：

bin/proguard.sh @myconfig.pro

在 Windows 上：

bin\proguard.bat @myconfig.pro

所有可用选项都在手册的配置部分中有描述。

Gradle 任务

ProGuard 可以作为 Gradle 中的一个任务运行。在使用 proguard 任务之前，您需要确保 Gradle 在构建时能在其类路径中找到它。一种方法是在 build.gradle 文件中添加以下行，这将从 Maven Central 下载 ProGuard：

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.guardsquare:proguard-gradle:7.5.0'
    }
}

然后您可以定义一个带有配置的任务：

tasks.register('proguard', ProGuardTask) {
    configuration file('proguard.pro')

    injars(tasks.named('jar', Jar).flatMap { it.archiveFile })

    // 自动处理此构建的 Java 版本。
    if (System.getProperty('java.version').startsWith('1.')) {
        // Java 9 之前，运行时类被打包在一个单独的 jar 文件中。
        libraryjars "${System.getProperty('java.home')}/lib/rt.jar"
    } else {
        // 从 Java 9 开始，运行时类被打包在模块化的 jmod 文件中。
        libraryjars "${System.getProperty('java.home')}/jmods/java.base.jmod", jarfilter: '!**.jar', filter: '!module-info.class'
        //libraryjars "${System.getProperty('java.home')}/jmods/....."
    }

    verbose

    outjars(layout.buildDirectory.file("libs/${baseCoordinates}-minified.jar"))
}

嵌入式配置与标准 ProGuard 配置非常相似。您可以在 Gradle 设置页面上找到更多详细信息。