如何在 Eclipse 中使用 Proguard 混淆 Android 库（.jar 文件）

Question

我看过很多关于如何在 Eclipse 中使用 ProGuard 混淆 Android 应用程序（.apk 文件）的帖子。另见http://developer.android.com/guide/developing/tools/proguard.html:

“当您在发布模式下构建应用程序（通过运行 ant release 或使用 Eclipse 中的导出向导）时，构建系统会自动检查是否设置了 proguard.config 属性。如果是，ProGuard 会在将所有内容打包成.apk 文件之前自动处理应用程序的字节码。”

但如果使用 Eclipse 导出向导将 Android 项目导出为 .jar 文件，请按照所述步骤（创建文件 proguard.cfg，在文件 default.properties 中将 proguard.config 属性配置为 proguard.cfg，使用导出向导等）似乎不起作用 - 我在生成的 jar 文件中没有看到类名等的混淆。我的 proguard.cfg 文件中也有以下设置，但在我的项目目录或 proguard 目录中看不到任何输出文件（甚至没有创建该目录）。

-dump class_files.txt 
-printseeds seeds.txt 
-printusage unused.txt 
-printmapping mapping.txt

我什至在我的项目目录中使用以下行创建了一个文件 project.properties，但这似乎并没有吸引 ProGuard 采取行动：

proguard.config=proguard.cfg

此项目中未定义任何活动。我在 Windows 上使用 Android 2.3.1 和 Eclipse Galileo 3.5.2。与 Android 3.0 的结果相同。似乎必须在 Eclipse 导出向导中以某种方式显式插入混淆步骤。我将不胜感激任何帮助或见解。谢谢。

Answer 1

正如 cmets 对上述答案之一的建议（但我一开始并没有注意到，因为它被埋在“其他 cmets”之一中）......

我们只需在命令行（参见下面的第一个块）在 eclipse 之外的库上运行 progruard，并在我们的proguard.cfg 文件中使用下面第二个块中的参数（绝对是 请勿使用-dontpreverify，否则将您的项目用作android 库的项目将无法正确混淆，因为您的project.jar 中存在StackMapTable 问题。

命令行：

$ java -jar $ANDROID_SDK/tools/proguard/lib/proguard.jar \
  -libraryjars $ANDROID_SDK/platforms/android-18/android.jar @proguard.cfg
  -outjars /tmp/project.jar -verbose

proguard.cfg：

-optimizationpasses 5
-dontusemixedcaseclassnames
-dontskipnonpubliclibraryclasses
-dontwarn our.company.project.R*
-injars bin/project.jar
-verbose
-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

-keep class org.apache.3rdparty.stuff.**
-keep public class our.company.project.ProjectAPI
-keep public class * extends android.app.Activity
-keep public class * extends android.app.Application
-keep public class * extends android.app.Service
-keep public class * extends android.content.BroadcastReceiver
-keep public class * extends android.content.ContentProvider
-keep public class * extends android.app.backup.BackupAgentHelper
-keep public class * extends android.preference.Preference

-keepclassmembers public class our.company.project.ProjectAPI {
    public static <fields>;
}

-keepclasseswithmembernames class * {
    native <methods>;
}

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet);
}

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet, int);
}

-keepclassmembers class * extends android.app.Activity {
    public void *(android.view.View);
}

-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

-keep class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}

可能并非所有参数和 -keep 项都是绝对必要的（除了不使用前面提到的-dontpreverify），但其中大部分对我来说是有意义的，因为如果你有一个活动则需要在那里您要导出的库中的类扩展。

Answer 2

我使用间接方式生成导出的android混淆jar，我的方式是：

1. 使用eclipse导出签名的apk

2. 解压apk，找到classes.dex

3. 使用dex2jar.bat，将classes.dex改成jar

4. 解压jar并删除不需要的类，然后将其压缩并 把文件名改成XXX.jar

5. 然后你在其他项目中使用这个jar，或者把它交给客户，它 很模糊！

我相信这会对你有所帮助！尽情享受吧！

Answer 3

java -jar proguard.jar @yourconfig.pro

yourconfig.pro（扩展自http://proguard.sourceforge.net/index.html#manual/examples.html）：

-injars yourjar.jar
-outjars yourjar_out.jar

-libraryjars 'C:\android\sdk\platforms\android-10\android.jar'

-printmapping mapping.txt
-verbose
-dontoptimize
-dontpreverify
-dontshrink
-dontskipnonpubliclibraryclassmembers
-dontusemixedcaseclassnames
-keepparameternames
-renamesourcefileattribute SourceFile
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,
                SourceFile,LineNumberTable,*Annotation*,EnclosingMethod

-keep public class * {
    public protected *;
}

-keepclassmembernames class * {
    java.lang.Class class$(java.lang.String);
    java.lang.Class class$(java.lang.String, boolean);
}

-keepclasseswithmembernames class * {
    native <methods>;
}

-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

结果可以用jd-gui验证

Answer 4

调用 ProGuard 的方法相当简单：

1. 将proguard.config=proguard.cfg 行添加到project.properties
2. 导出应用程序包

默认的 proguard.cfg 文件应该已由新项目向导自动创建。

Answer 5

不要混淆你的纯Java Jar。在生成 Jar 时完全跳过该阶段（无论是在 Eclipse 中手动还是通过命令行中的 Ant 构建）。

相反，在 client 项目中设置并执行适当的混淆，该项目使用 Jar，您可以在其中将库添加为外部 Jar。 Proguard 也将能够混淆 Jar 中的代码。

我偶然发现了这个问题，并按照我在这里描述的那样成功地结束了。