Dodawanie opcji globalnych

R8 udostępnia opcje globalne, które modyfikują optymalizacje R8 w całej aplikacji lub wpływają na każdą regułę zachowywania. 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 pominięcie 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]: umożliwia R8 zmianę sprawdzania wartości null w funkcjach wewnętrznych Kotlin na usunięcie tylko 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 zmienia każde wywołanie metody sprawdzania na wywołanie funkcji getClass() w pierwszym argumencie wywołania (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 włączania R8 po raz pierwszy.

• -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, ponieważ wyłączenie zaciemniania kodu 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 rozdzieloną przecinkami listę atrybutów, które mają zostać zachowane. Jeśli nie używasz domyślnego parametruproguard-android-optimize.txt, R8 usuwa wszystkie atrybuty, w tymRuntimeVisibleAnnotations i Signature. Zachowanie tych atrybutów może być jednak przydatne w przypadkach takich jak refleksja. Listę atrybutów, które możesz określić, znajdziesz w sekcji Zachowaj atrybuty.

Atrybuty zachowywania

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

Niektóre operacje refleksyjne 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 ogólnych sygnatur za pomocą elementu 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 korzystających 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 konsumenta 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 nie zdecydują się na uwzględnienie proguard-android-optimize.txt.

Dodatkowe atrybuty zachowywania

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