Android: Каковы рекомендуемые конфигурации Proguard?

Я разрабатываю приложения для Android и использую Proguard для обфускации кода.

В настоящее время я использую конфигурации ProGuard:

-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 com.android.vending.licensing.ILicensingService

Чтобы сохранить имена пользовательских компонентов, которые используются в макетах XML:

-keep public class custom.components.**

Чтобы удалить журналы отладки:

-assumenosideeffects class android.util.Log {
    public static *** d(...);
    public static *** v(...);
}

Чтобы избежать изменения имен методов, вызванных в макете onClick:

-keepclassmembers class * {
 public void onClickButton1(android.view.View);
 public void onClickButton2(android.view.View);
 public void onClickButton3(android.view.View);
}

-keepclasseswithmembernames class * {
    native <methods>;
}

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

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

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

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

Вопрос (есть):

Рекомендуются ли какие-либо другие теги? Зачем и зачем?

Можно ли прокомментировать файл proguard.cfg? Я хотел бы иметь его с комментариями, что некоторые строки делают, чтобы другие разработчики не сомневались в том, почему я добавил.

Также в proguard можно сохранить заголовок комментария файла (с авторским правом)? Если это не так, или это не хорошая политика, где я должен добавить авторские права?

Ответ 1

Android SDK (r20 или выше)

Пожалуйста, проверьте предопределенный proguard.config, указанный в файле project.properties

proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt

Дополнительная информация: http://proguard.sourceforge.net/manual/examples.html#androidapplication


Android SDK (r19 или ниже)

Основываясь на моем ответе Включение ProGuard в Eclipse для Android Я получил этот общий файл. Я добавил комментарии, чтобы помнить, для чего предназначена каждая строка. Это может помочь людям там, вот так вот:

-optimizationpasses 5

#When not preverifing in a case-insensitive filing system, such as Windows. Because this tool unpacks your processed jars, you should then use:
-dontusemixedcaseclassnames

#Specifies not to ignore non-public library classes. As of version 4.5, this is the default setting
-dontskipnonpubliclibraryclasses

#Preverification is irrelevant for the dex compiler and the Dalvik VM, so we can switch it off with the -dontpreverify option.
-dontpreverify

#Specifies to write out some more information during processing. If the program terminates with an exception, this option will print out the entire stack trace, instead of just the exception message.
-verbose

#The -optimizations option disables some arithmetic simplifications that Dalvik 1.0 and 1.5 can't handle. Note that the Dalvik VM also can't handle aggressive overloading (of static fields).
#To understand or change this check http://proguard.sourceforge.net/index.html#/manual/optimizations.html
-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

#To repackage classes on a single package
#-repackageclasses ''

#Uncomment if using annotations to keep them.
#-keepattributes *Annotation*

#Keep classes that are referenced on the AndroidManifest
-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 com.android.vending.licensing.ILicensingService


#To remove debug logs:
-assumenosideeffects class android.util.Log {
    public static *** d(...);
    public static *** v(...);
}

#To avoid changing names of methods invoked on layout onClick.
# Uncomment and add specific method names if using onClick on layouts
#-keepclassmembers class * {
# public void onClickButton(android.view.View);
#}

#Maintain java native methods 
-keepclasseswithmembernames class * {
    native <methods>;
}

#To maintain custom components names that are used on layouts XML.
#Uncomment if having any problem with the approach below
#-keep public class custom.components.package.and.name.**

#To maintain custom components names that are used on layouts XML:
-keep public class * extends android.view.View {
    public <init>(android.content.Context);
    public <init>(android.content.Context, android.util.AttributeSet);
    public <init>(android.content.Context, android.util.AttributeSet, int);
    public void set*(...);
}

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

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

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

#To keep parcelable classes (to serialize - deserialize objects to sent through Intents)
-keep class * implements android.os.Parcelable {
  public static final android.os.Parcelable$Creator *;
}

#Keep the R
-keepclassmembers class **.R$* {
    public static <fields>;
}

###### ADDITIONAL OPTIONS NOT USED NORMALLY

#To keep callback calls. Uncomment if using any
#http://proguard.sourceforge.net/index.html#/manual/examples.html#callback
#-keep class mypackage.MyCallbackClass {
#   void myCallbackMethod(java.lang.String);
#}

#Uncomment if using Serializable 
#-keepclassmembers class * implements java.io.Serializable {
#    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();
#}

Ответ 2

Для стандартных построек с Ant или Eclipse Android SDK (r20 или выше) уже предоставляет подходящую конфигурацию, на которую ссылается свойство proguard.config в файле project.properties(как Михал указывает в его ответе). В старых версиях вы всегда должны были указывать свою полную конфигурацию, поэтому старший совет (например, первый ответ) может привести к некоторой путанице.

Для пользовательских построек вы можете найти последнюю рекомендованную конфигурацию в руководстве ProGuard > Examples > Полное приложение для Android. В дистрибутиве Proguard также содержатся примеры примеров файлов /android.pro

В частности, вы можете сохранить аннотации и сеттеры в расширениях View.

Вы можете добавлять комментарии после хеш-символа '#', как это было сделано в файлах-образцах.

Ответ 3

В файле проекта project.properties установите следующее значение:

proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt

Это приведет к последней версии настроек Proguard из Android SDK.