Dodawanie opcji globalnych

R8 udostępnia opcje globalne, które modyfikują optymalizacje R8 w całej aplikacji lub wpływają na każdą regułę keep. Te opcje są przechowywane w pliku proguard-rules.pro wraz z regułami przechowywania. Niektóre z tych opcji globalnych konfigurują dodatkową optymalizację, a inne wyłączają pewne aspekty optymalizacji.

Opcje globalne dotyczące dodatkowej optymalizacji

Te opcje globalne umożliwiają dodatkową optymalizację:

• -repackageclasses [<optional-package-name>]: ponownie pakuje klasy w jednym pakiecie, aby zmniejszyć rozmiar aplikacji. Jeśli nie podasz opcjonalnej nazwy pakietu, klasy zostaną przeniesione do nienazwanego pakietu domyślnego. Jest to zalecane ustawienie w przypadku aplikacji, ponieważ powoduje zmniejszenie rozmiaru plików DEX przez pomijanie prefiksu pakietu w nazwach klas.
• -allowaccessmodification: umożliwia R8 zmianę (zwykle poszerzenie) widoczności klas, pól i metod w celu przeprowadzenia bardziej zaawansowanych optymalizacji. Włączone, gdy używana jest właściwość proguard-android-optimize.txt. Od wersji 8.2 wtyczki Androida do obsługi Gradle (AGP) jest to konfiguracja domyślna, jeśli włączysz pełną optymalizację za pomocą R8.

• -processkotlinnullchecks [level]: pozwala R8 zmienić sprawdzanie wartości null w funkcjach wewnętrznych Kotlin na usunięcie komunikatu o błędzie lub całkowite usunięcie jawnego sprawdzania wartości null.

  Wartości level, uporządkowane od najsłabszej do najsilniejszej, mają następujący wpływ:

  • keep nie zmienia kontroli.
  • remove_message zastępuje każde wywołanie metody sprawdzania wywołaniem funkcji getClass() na pierwszym argumencie wywołania (skutecznie zachowując sprawdzanie wartości null, ale bez żadnej wiadomości).
  • remove całkowicie usuwa weryfikacje.

  Domyślnie R8 używa remove_message. Każda specyfikacja -processkotlinnullchecks zastępuje to ustawienie. Jeśli zostanie podana kilka razy, użyta zostanie najsilniejsza wartość.

  -processkotlinnullchecks jest obsługiwane od AGP 9.0.0.

Oto przykład konfiguracji z włączoną dodatkową optymalizacją:

-repackageclasses
-allowaccessmodification

Opcje globalne ograniczające optymalizację

Poniższe opcje globalne umożliwiają wyłączenie niektórych aspektów optymalizacji aplikacji. Są one przydatne podczas dopracowywania reguł zachowywania lub pierwszego włączania R8.

• -dontoptimize: Zapobiega optymalizacji kodu, np. wstawianiu metod. Tej opcji można używać podczas programowania, ale nie należy jej stosować w wersjach produkcyjnych.
• -dontshrink: zapobiega usuwaniu nieużywanego kodu i optymalizacji kodu. Tej opcji można używać podczas programowania, ale nie należy jej stosować w wersjach produkcyjnych.
• -dontobfuscate: zapobiega skracaniu nazw klas i metod. Może to być szczególnie przydatne podczas debugowania, gdy wyłączenie zaciemniania ułatwia odczytywanie śladów stosu. Tej opcji można używać podczas programowania, ale nie należy jej stosować w wersjach produkcyjnych.
• -keepattributes <attributes>: akceptuje oddzieloną przecinkami listę atrybutów, które mają zostać zachowane. Jeśli nie używasz domyślnego ustawienia proguard-android-optimize.txt, R8 usuwa wszystkie atrybuty, w tym RuntimeVisibleAnnotations i Signature. Zachowanie tych atrybutów może być jednak przydatne w przypadkach takich jak odbicie. Listę atrybutów, które możesz określić, znajdziesz w sekcji Zachowaj atrybuty.

Zachowaj atrybuty

Atrybuty to dodatkowe informacje dołączone do różnych części kodu. Atrybuty przechowują informacje takie jak adnotacje i ogólne sygnatury z kodu.

Niektóre operacje odblaskowe wymagają zachowania określonych atrybutów, aby można było je przeprowadzić. Na przykład:

• Podczas uzyskiwania dostępu do wewnętrznej lub zewnętrznej struktury klasy za pomocą poleceń getEnclosingMethod() lub getDeclaredClasses() wymagane są atrybuty EnclosingMethod i InnerClasses.
• Aby uzyskać dostęp do podpisów ogólnych za pomocą getTypeParameters(), musisz użyć atrybutu Signature.

• Aby uzyskać dostęp do adnotacji za pomocą getAnnotation(), musisz użyć atrybutu RuntimeVisibleAnnotations.

Często wymagane atrybuty

Gdy używasz domyślnego pliku Proguard (proguard-android-optimize.txt lub proguard-android.txt), wtyczka Androida do obsługi Gradle (AGP) zachowuje te atrybuty: Pamiętaj, że niektóre z tych atrybutów wymagają nowszych wersji AGP:

W przypadku aplikacji, które korzystają z proguard-android-optimize.txt, reguły przechowywania zdefiniowane przez AGP są w większości przypadków wystarczające. Jeśli jednak piszesz kod biblioteki, w jej regułach zachowywania informacji o użytkownikach musisz określić wszystkie atrybuty wymagane przez bibliotekę, nawet jeśli są one zdefiniowane na tej liście. Dzięki temu Twoja biblioteka będzie solidna, nawet jeśli programiści zdecydują się nie uwzględniać proguard-android-optimize.txt.

Dodatkowe atrybuty zachowania

Możesz określić dodatkowe atrybuty do zachowania, ale w większości przypadków związanych z dostępem refleksyjnym lub JNI nie są one potrzebne. Niektóre z nich mogą być jednak nadal często używane podczas optymalizacji bibliotek.