精华内容
参与话题
问答
  • Proguard

    2021-01-08 08:09:01
    <div><ul><li>Added proguard rule for CloudRail, SpongyCastle</li><li>Added 's rules for jssh</li><li>Added proguard rules for tests (in another file)</li><li>Removed '-dontwarn' rule and ...
  • ProGuard

    2019-10-02 04:31:07
    xirihanlin 2011.06.09 ProGuard工具通过移除不用的代码,用语义上混淆的名字来重命名类、字段和方法等手段来压缩、优化和混淆你的代码。结果是更小的.apk文件,并且更难于被反编译。由于ProGuard能够让你的程序难于...

    xirihanlin 2011.06.09

    ProGuard工具通过移除不用的代码,用语义上混淆的名字来重命名类、字段和方法等手段来压缩、优化和混淆你的代码。结果是更小的.apk文件,并且更难于被反编译。由于ProGuard能够让你的程序难于被反编译,因此,当你的程序使用了一些机密的信息的时,使用它就显得更加重要。

    ProGuard已经集成到Android的编译环境中,因此,用不着手动来触发它。ProGuard只在release模式下编译应用程序才会运行,所以,在debug模式下编译,你就不必处理混淆的代码。是否运行ProGuard是完全可选的,但强烈推荐使用。

    这篇文章将描述如何启用和配置ProGuard,以及如何使用retrace工具来解码混淆过的堆栈跟踪信息。

    启用ProGuard

    当你创建Android工程时,proguard.cfg文件会在工程的根目录自动创建。这个文件定义了ProGuard如何优化和混淆代码,因此,理解如何定制它是非常重要的。默认的配置文件只是覆盖了一些通用的情况,所以,基本上你需要编辑它来满足你的需求。参考后面的“配置ProGuard”章节来了解如何定制ProGuard的相关信息。

    启用ProGuard让它跟随Ant或Eclipse编译时一起运行,你需要在<project_root>/default.properties文件中设置proguard.config属性。路径可以是绝对路径或是工程根目录的相对路径。

    如果你把proguard.cfg文件放在默认的位置(工程的根目录),你可以像这样来指定它的位置:

    proguard.config=proguard.cfg

    你还可以把该文件移到任何你想放的位置,然后指定绝对路径:

    proguard.config=/path/to/proguard.cfg

    当你在release模式下编译你的程序,不管是用ant release还是用Eclipse的导出向导,编译系统都会自动检查proguard.config属性是否设置。如果设置了,ProGuard就会在打包成.apk文件之前,自动处理应用程序的字节码。Debug模式编译,不会触发ProGuard,因为它会使得调试更加复杂累赘。

    ProGuard运行结束后,输出以下文件:

    dump.txt

    描述.apk文件中所有类文件间的内部结构

    mapping.txt

    列出了原始的类,方法和字段名与混淆后代码间的映射。这个文件很重要,当你从release版本中收到一个bug报告时,可以用它来翻译被混淆的代码。

    seeds.txt

    列出了未被混淆的类和成员

    usage.txt

    列出了从.apk中删除的代码

    这些文件放在以下文件夹中:

    · Ant:<project_root>/bin/proguard

    · Eclipse: <project_root>/proguard

    注意:每当你在release模式下编译时,这些文件都会被覆盖重写,当然,是被ProGuard工具生成的最新的文件所覆盖。每次你发布你的程序时,都应该保存一份,为了将来能够解码bug报告。

    配置 ProGuard

    一些情况下,proguard.cfg文件中的默认配置就足够了。然而,有些情况ProGuard也很难正确分析,它可能会删除它认为不用的代码,但实际上正是你的程序所需要的。例如:

    l 只在AndroidManifest.xml文件中引用的类

    l 由JNI调用的方法

    l 动态引用的字段和方法

    默认的proguard.cfg文件努力去覆盖通用的情况,但有可能你会遇到如ClassNotFoundException这样的异常,而这正好是由于ProGuard移除了整个类造成的。

    你可以修正由于ProGuard移除代码造成的错误,只需要在proguard.cfg文件中添加一行“-keep”。例如:

    -keep public class <MyClass>

    使用-keep选项时,有一些选项和建议,因此,强烈建议你阅读ProGuard手册来了解更多关于定制配置文件的信息。“Overview of Keep options”和“Examples section”将非常有用。而“Troubleshooting”章节也列出了一些当你的代码被删除时你可能会遇到的一些常见问题。

    解码混淆过的堆栈跟踪信息

    当混淆后的代码输出一个堆栈信息时,方法名是不可识别的,这使得调试变得很困难,甚至是不可能的。幸运的是,当ProGuard运行时,它都会输出一个<project_root>/bin/proguard/mapping.txt文件,而这个文件中包含了原始的类,方法和字段名被映射成的混淆名字。

    retrace.bat脚本(Window)或retrace.sh脚本(Linux,Mac OS X)可以将一个被混淆过的堆栈跟踪信息还原成一个可读的信息。它位于<sdk_root>/tools/proguard文件夹中。执行retrace工具的语法如下:

    retrace.bat|retrace.sh [-verbose] mapping.txt [<stacktrace_file>]

    例如:

    retrace.bat -verbose mapping.txt obfuscated_trace.txt

    如果你没有指定<stacktrace_file>,retrace工具会从标准输入读取。

    发布程序的调试建议

    每次发布程序给用户时,都应该保存一份mapping.txt。这样的话,当用户遇到一个bug并提交一个混淆的堆栈信息,能确保你能调试这个问题。工程的mapping.txt文件在你每次进行release编译时都会被覆盖,所以,你一定要小心的保存你需要的版本。

    如何保存mapping.txt文件是你的事。例如,你可以用一个包含版本信息或编译号的名字来重命名文件,或者让其和你的代码一样进行版本控制。

     

    ====== 

    在导出APK时,如果你也遇到 Conversion to Dalvik format failed with error 1 这样的error,

    可以参考 http://hsx9566.iteye.com/blog/1142002 

    转载于:https://www.cnblogs.com/xirihanlin/archive/2011/06/10/2077951.html

    展开全文
  • proguard

    2014-12-11 16:01:51
    proguard 原理 Java代码编译成二进制class 文件,这个class 文件也可以反编译成源代码 ,除了注释外,原来的code 基本都可以看到。为了防止重要code 被泄露,我们往往需要混淆(Obfuscation code , 也就是把方法,...

    proguard 原理

    Java代码编译成二进制class 文件,这个class 文件也可以反编译成源代码 ,除了注释外,原来的code 基本都可以看到。为了防止重要code 被泄露,我们往往需要混淆(Obfuscation code , 也就是把方法,字段,包和类这些java 元素的名称改成无意义的名称,这样代码结构没有变化,还可以运行,但是想弄懂代码的架构却很难。 proguard 就是这样的混淆工具,它可以分析一组class 的结构,根据用户的配置,然后把这些class 文件的可以混淆java 元素名混淆掉。在分析class 的同时,他还有其他两个功能,删除无效代码(Shrinking 收缩),和代码进行优化 (Optimization Options)。

    缺省情况下,proguard 会混淆所有代码,但是下面几种情况是不能改变java 元素的名称,否则就会这样就会导致程序出错。
    一, 我们用到反射的地方。
    二, 我们代码依赖于系统的接口,比如被系统代码调用的回调方法,这种情况最复杂。
    三, 是我们的java 元素名称是在配置文件中配置好的。
    所以使用proguard时,我们需要有个配置文件告诉proguard 那些java 元素是不能混淆的。


    proguard 配置

    最常用的配置选项
    -dontwarn 缺省proguard 会检查每一个引用是否正确,但是第三方库里面往往有些不会用到的类,没有正确引用。如果不配置的话,系统就会报错。
    -keep 指定的类和类成员被保留作为 入口 。
    -keepclassmembers 指定的类成员被保留。
    -keepclasseswithmembers 指定的类和类成员被保留,假如指定的类成员存在的话。


    proguard 问题和风险

    代码混淆后虽然有混淆优化的好处,但是它往往也会带来如下的几点问题
    1,混淆错误,用到第三方库的时候,必须告诉 proguard 不要检查,否则proguard 会报错。
    2,运行错误,当code 不能混淆的时候,我们必须要正确配置,否则程序会运行出错,这种情况问题最多。
    3,调试苦难,出错了,错误堆栈是混淆后的代码 ,自己也看不懂。


    为了防止混淆出问题,你需要熟悉你所有的code ,系统的架构 ,以及系统和你code的集成的接口,并细心分析。 同时你必须需要一轮全面的测试。 所以混淆也还是有一定风险的。 为了避免风险,你可以只是混淆部分关键的代码,但是这样你的混淆的效果也会有所降低。


    常见的不能混淆的androidCode

    1.Android 程序 ,下面这样代码混淆的时候要注意保留。
    2.Android系统组件,系统组件有固定的方法被系统调用。
    3.被Android Resource 文件引用到的。名字已经固定,也不能混淆,比如自定义的View 。
    4.Android Parcelable ,需要使用android 序列化的。
    5.其他Anroid 官方建议 不混淆的,如:
    android.app.backup.BackupAgentHelper
    android.preference.Preference
    com.android.vending.licensing.ILicensingService
    6.Java序列化方法,系统序列化需要固定的方法。
    7.枚举 ,系统需要处理枚举的固定方法。
    8.本地方法,不能修改本地方法名
    9.annotations 注释
    10.数据库驱动
    11.有些resource 文件
    12.用到反射的地方


    如何实施

    现在的系统已经配置为混淆时候会保留
    Android系统组件
    自定义View
    Android Parcelable
    Android R 文件
    Android Parcelable
    枚举
    各个开发人员必须检查自己的code 是否用到反射 ,和其他不能混淆的地方。告诉我来修改配置文件(已经保留的就不需要了)

    目前系统部检查的第三方库为
    -dontwarn android.support.**
    -dontwarn com.tencent.**
    -dontwarn org.dom4j.**
    -dontwarn org.slf4j.**
    -dontwarn org.http.mutipart.**
    -dontwarn org.apache.**
    -dontwarn org.apache.log4j.**
    -dontwarn org.apache.commons.logging.**
    -dontwarn org.apache.commons.codec.binary.**
    -dontwarn weibo4android.**


    proguard 参数

    -include {filename}    从给定的文件中读取配置参数 

    -basedirectory {directoryname}    指定基础目录为以后相对的档案名称 

    -injars {class_path}    指定要处理的应用程序jar,war,ear和目录 

    -outjars {class_path}    指定处理完后要输出的jar,war,ear和目录的名称 

    -libraryjars {classpath}    指定要处理的应用程序jar,war,ear和目录所需要的程序库文件 

    -dontskipnonpubliclibraryclasses    指定不去忽略非公共的库类。 

    -dontskipnonpubliclibraryclassmembers    指定不去忽略包可见的库类的成员。 

    保留选项 

    -keep {Modifier} {class_specification}    保护指定的类文件和类的成员 

    -keepclassmembers {modifier} {class_specification}    保护指定类的成员,如果此类受到保护他们会保护的更好

    -keepclasseswithmembers {class_specification}    保护指定的类和类的成员,但条件是所有指定的类和类成员是要存在。 

    -keepnames {class_specification}    保护指定的类和类的成员的名称(如果他们不会压缩步骤中删除) 

    -keepclassmembernames {class_specification}    保护指定的类的成员的名称(如果他们不会压缩步骤中删除) 

    -keepclasseswithmembernames {class_specification}    保护指定的类和类的成员的名称,如果所有指定的类成员出席(在压缩步骤之后) 

    -printseeds {filename}    列出类和类的成员-keep选项的清单,标准输出到给定的文件 

    压缩 

    -dontshrink    不压缩输入的类文件 

    -printusage {filename} 

    -whyareyoukeeping {class_specification}     

    优化 

    -dontoptimize    不优化输入的类文件 

    -assumenosideeffects {class_specification}    优化时假设指定的方法,没有任何副作用 

    -allowaccessmodification    优化时允许访问并修改有修饰符的类和类的成员 

    混淆 

    -dontobfuscate    不混淆输入的类文件 

    -printmapping {filename} 

    -applymapping {filename}    重用映射增加混淆 

    -obfuscationdictionary {filename}    使用给定文件中的关键字作为要混淆方法的名称 

    -overloadaggressively    混淆时应用侵入式重载 

    -useuniqueclassmembernames    确定统一的混淆类的成员名称来增加混淆 

    -flattenpackagehierarchy {package_name}    重新包装所有重命名的包并放在给定的单一包中 

    -repackageclass {package_name}    重新包装所有重命名的类文件中放在给定的单一包中 

    -dontusemixedcaseclassnames    混淆时不会产生形形色色的类名 

    -keepattributes {attribute_name,…}    保护给定的可选属性,例如LineNumberTable, LocalVariableTable, SourceFile, Deprecated, Synthetic, Signature, and InnerClasses. 

    -renamesourcefileattribute {string}    设置源文件中给定的字符串常量


    解决export打包的报错
    这个时候export提示“conversion to Dalvik format failed with error 1”错误,网上说法有好多种,最后我还是把proguard从4.4升级到4.8就解决了。官方地址是http://proguard.sourceforge.net。上面的配置文件参数可以在这里查阅。
    升级办法很简单,就是把android sdk目录下的tool/proguard目录覆盖一下即可。

    打包出来的程序如何调试
    一旦打包出来,就不能用eclipse的logcat去看了,这里可以用android sdk中ddms.bat的tool来看,一用就发现和logcat其实还是一个东西,就是多了个设备的选择。


    使用 gson 需要的配置
    当Gson用到了泛型就会有报错,这个真给郁闷了半天,提示“Missing type parameter”。最后找到一个资料给了一个解决办法,参考:http://stackoverflow.com/questio … sing-type-parameter
    另外我又用到了JsonObject,提交的Object里面的members居然被改成了a。所以上面给的东西还不够,还要加上
    # 用到自己拼接的JsonObject
    -keep class com.google.gson.JsonObject { *; }

    个人建议减少这些依赖包混淆带来的麻烦,干脆都全部保留不混淆。例如
    -keep class com.badlogic.** { *; }
    -keep class * implements com.badlogic.gdx.utils.Json*
    -keep class com.google.** { *; }


    使用libgdx需要的配置
    参考http://code.google.com/p/libgdx-users/wiki/Ant

    验证打包效果
    利用了apktool的反编译工具,把打包文件又解压了看了一下,如果包路径、类名、变量名、方法名这些变化和你期望一致,那就OK了。命令:

    apktool.bat d xxx.apk destdir

    配置实例
    -injars  androidtest.jar【jar包所在地址】 
    -outjars  out【输出地址】
    -libraryjars    ‘D:\android-sdk-windows\platforms\android-9\android.jar’ 【引用的库的jar,用于解析injars所指定的jar类】

    -optimizationpasses 5
    -dontusemixedcaseclassnames 【混淆时不会产生形形色色的类名 】
    -dontskipnonpubliclibraryclasses 【指定不去忽略非公共的库类。 】
    -dontpreverify 【不预校验】
    -verbose
    -optimizations !code/simplification/arithmetic,!field/*,!class/merging/* 【优化】
    -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
    -keep public class com.android.vending.licensing.ILicensingService
    -keep public abstract interface com.asqw.android.Listener{
    public protected <methods>;  【所有方法不进行混淆】
    }
    -keep public class com.asqw.android{
    public void Start(java.lang.String); 【对该方法不进行混淆】
    }
    -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 class com.aspire.**

    展开全文
  • ProGuard

    2012-04-10 21:34:25
    http://proguard.sourceforge.net/    
    展开全文

空空如也

1 2 3 4 5 ... 20
收藏数 8,052
精华内容 3,220
关键字:

proguard