ProGuard 开源项目指南

ProGuard 开源项目指南

proguardA fork of ProGuard. 项目地址:https://gitcode.com/gh_mirrors/pro/proguard

---

项目介绍

ProGuard 是一个 Java 字节码优化器和混淆器，由 GuardSquare 公司维护（请注意，提供的链接指向的是 Facebook 的归档版本，该版本可能不再活跃）。它广泛应用于Android开发中，用于减小应用程序大小，通过移除未使用的代码，优化字节码，以及对剩余部分进行混淆，以增加逆向工程的难度。尽管Facebook的仓库是归档状态，但ProGuard本身仍在持续发展，最新的版本和文档应从GuardSquare官网获取。

项目快速启动

安装与配置

在大部分Android Studio项目中，ProGuard已经被内置并准备就绪。你需要在项目的build.gradle文件中启用它。以下是如何简单地启用ProGuard：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

这将开启代码混淆，并指定两个ProGuard规则文件。默认的Optimize文件提供了基本的混淆设置，而自定义的proguard-rules.pro文件可以用来添加特定于你项目的规则。

示例规则

在你的proguard-rules.pro文件中加入一些基础规则示例：

# 保留所有的类名、方法名和字段名，防止混淆特定的公共接口或库签名。
-keep public class * extends android.app.Activity
-keepclassmembers class ** {
    <fields>;
    <methods>;
}

# 保持Log类不被混淆，以便调试时使用
-keep class android.util.Log { *; }

当你完成上述步骤后，执行项目的Release构建，ProGuard就会自动运行。

应用案例和最佳实践

在Android开发中，ProGuard的主要应用是为了提高App的安全性和性能。最佳实践包括：

• 精确匹配：确保只混淆那些不需要外部可见的部分，避免API改变导致的问题。
• 排除第三方库：多数第三方库已经有自己的混淆规则，需将其导入以防功能受损。
• 测试混淆后的应用：混淆后务必进行全面测试，以发现可能因混淆导致的问题。
• 性能监控：混淆虽然可以减少APK大小，但也要监控是否影响了应用性能。

典型生态项目

由于ProGuard主要作为独立工具集成在各种Java和Android项目中，其“典型生态项目”更多指的是其被广泛应用的各种场景，而非直接关联的特定生态系统。在Android领域，几乎所有的专业级应用都会间接与其交互，通过 Gradle 构建系统来管理和优化他们的代码。此外，对于Java项目，通过Maven或Gradle插件也可以轻松集成ProGuard，实现跨平台的代码优化和保护。

请注意，实际开发中应关注 GuardSquare 官方的更新和推荐，因为Facebook的归档仓库代表的是一个历史快照，非最新稳定版信息。

proguardA fork of ProGuard. 项目地址:https://gitcode.com/gh_mirrors/pro/proguard