ProGuard 的规则及示例

规则概述

ProGuard 是一个代码优化工具，它通过移除未使用的代码、重命名类、字段和方法等方式来减小应用的大小。在 ProGuard 的配置文件中，我们可以定义一系列的规则来控制优化和混淆的过程。

规则语法

ProGuard 的规则通常包含以下几个方面：

  • 保留类、方法和字段：使用 -keep 指令来保留特定的类、方法和字段，防止它们被移除或重命名。

  • 优化选项：使用 -optimizationpasses、-optimizations 等指令来控制优化的级别和方式。

  • 混淆选项：使用 -obfuscationdictionary、-renamesourcefileattribute 等指令来控制混淆的过程。

  • 预校验：使用 -dontpreverify 指令来关闭预校验，这在某些情况下可以提高性能。

示例规则

以下是一些常见的 ProGuard 规则示例：

  • 保留所有公共类：-keep public class *

  • 保留某个包下的所有类：-keep class com.example.** { *; }

  • 保留实现了某个接口的类：-keep class * implements com.example.MyInterface

  • 保留类名、方法名和字段名：-keepnames class com.example.MyClass

  • 防止类被优化：-keep class com.example.MyClass { *; }

  • 防止方法被优化：-keepclassmembers class com.example.MyClass { public void myMethod(); }

注意事项

  • 在定义 ProGuard 规则时，需要仔细考虑哪些代码是必要的，哪些代码可以被移除或混淆。

  • 混淆后的代码可能难以调试，因此在发布前应该进行充分的测试。

  • ProGuard 的规则文件通常是一个以 .pro 为扩展名的文本文件，可以使用文本编辑器进行编辑。