Używanie inteligentniejszych reguł zachowywania: jak dostawcy bibliotek mogą odblokować optymalizację kodu DEX na poziomie aplikacji
Czas czytania: 6 min
Jako deweloperzy aplikacji na Androida i bibliotek wszyscy dążymy do tego samego celu: wydajnych aplikacji, które zapewniają płynne działanie. Ważną rolę odgrywa tu R8, czyli optymalizator aplikacji na Androida. R8 zwiększa wydajność aplikacji, usuwając nieużywany kod oraz optymalizując i zaciemniając pozostały.
Google Play niedawno ogłosiło nowe progi optymalizacji kodu DEX dla aplikacji i gier, które pomagają skrócić czas uruchamiania, zmniejszyć wykorzystanie pamięci i zapewnić zgodność z zobowiązaniem Androida do ochrony wrażeń użytkownika przed aplikacjami, które zużywają nadmierną ilość pamięci. Te progi dotyczą aplikacji i gier, ale ich osiągnięcie jest odpowiedzialnością współdzieloną całego ekosystemu – R8 może optymalizować aplikację tylko w ramach podanych parametrów, które obejmują reguły zachowywania powiązane z bibliotekami, od których zależy aplikacja.
Analizator konfiguracji R8 to świetne narzędzie do oceny optymalizacji aplikacji, zmniejszania rozmiaru i zaciemniania kodu, które stanowią podstawę wymagań technicznych Google Play. Oprócz śledzenia tych wartości procentowych analizator konfiguracji R8 wykrywa też nieefektywne reguły zachowywania pochodzące nie tylko z aplikacji, ale też z reguł zachowywania konsumentów dołączonych do bibliotek, od których zależą aplikacje.
Z tego przewodnika dowiesz się, jak rozwiązać niektóre z najczęstszych problemów, z którymi borykają się dostawcy bibliotek, i jak dostarczać wąskie, wydajne reguły, aby pomóc klientom spełnić wymagania techniczne Google Play.
Czym są reguły przechowywania dla konsumentów?
Reguły zachowywania konsumentów to instrukcje dołączone do biblioteki Androida lub JAR, które informują R8, które części kodu biblioteki nie mogą być optymalizowane podczas procesu kompilacji na poziomie aplikacji. W przeciwieństwie do standardowych reguł zachowywania zapisanych przez aplikację lub bibliotekę, które są używane do minifikacji artefaktów, reguły zachowywania konsumentów są umieszczane w bibliotekach i wpływają na sposób minifikacji biblioteki podczas optymalizacji całej aplikacji. Dzięki temu wewnętrzne cele refleksji i interfejsy natywne pozostają nienaruszone, a programista aplikacji nie musi ich ręcznie identyfikować.
Celowe, wąsko ukierunkowane reguły zachowywania konsumentów to kluczowa sprawdzona metoda, która przynosi korzyści zarówno bibliotece, jak i aplikacjom, które z niej korzystają. Zbyt ogólne reguły zachowywania konsumentów zachowują nieużywany kod, co wpływa na optymalizację i wydajność aplikacji. Dzięki dodaniu do Konsoli Play statystyk dotyczących optymalizacji kodu DEX deweloperzy aplikacji będą widzieć dane odzwierciedlające łączny wpływ reguł z aplikacji i jej zintegrowanych bibliotek.
Zapewnianie równowagi między stabilnością a wydajnością
Dostawcy bibliotek często mają dobre intencje, gdy udostępniają szerokie reguły przechowywania dla konsumentów. Nikt nie chce, aby jego pakiet SDK powodował awarię z powodu usunięcia klasy podczas refleksji.
Jednak reguły zachowywania dotyczące całego pakietu lub inne szerokie reguły nie są zalecane jako długoterminowe rozwiązanie zapobiegające awariom, ponieważ znacznie ograniczają potencjał optymalizacji aplikacji przez R8. Oto kilka zalecanych strategii, które pomogą Ci tworzyć wąskie, wydajne reguły bez uszczerbku dla stabilności:
1. Testowanie i wdrażanie wąskich reguł
Aby ułatwić Ci bezpieczne wdrażanie wąskich reguł, przygotowaliśmy te sprawdzone metody:
- Testowanie w przykładowej aplikacji: wskazówki dotyczące testowania lokalnego podane w artykule Testowanie optymalizacji mają zastosowanie również do przykładowych aplikacji. Po włączeniu R8 przetestuj główne ścieżki użytkownika, aby upewnić się, że funkcje działają zgodnie z oczekiwaniami.
- Uruchom analizator konfiguracji R8 w przykładowej aplikacji, aby zobaczyć, co widzą deweloperzy aplikacji podczas sprawdzania konfiguracji R8. Umożliwia łatwe wizualizowanie wpływu reguł przechowywania na aplikacje podrzędne.
- Użyj polecenia analyze z interfejsu wiersza poleceń Androida, aby ocenić optymalizację pliku AAR lub JAR, w tym zachowane metody, klasy i pola. Możesz porównać te liczby w różnych wersjach, aby sprawdzić, czy nie wystąpiły regresje.
- Monitoruj użycie wersji biblioteki i awarie w Google Play SDK Console.
- Sprawdzone metody znajdziesz w wskazówkach dotyczących optymalizacji dla autorów bibliotek oraz w dokumentacji R8.
2. Preserving reflection and JNI targets without broad keep rules
Udostępnienie biblioteki z regułami zachowywania obejmującymi cały pakiet lub wiele pakietów wpływa nie tylko na Twój pakiet SDK, ale też zmusza deweloperów do akceptowania nadmiernego rozrostu kodu, który spowalnia uruchamianie aplikacji i zwiększa rozmiar pobieranej aplikacji, wykorzystanie pamięci oraz częstotliwość błędów ANR. Możliwe jest też, że aplikacje, których twórcy kładą nacisk na wydajność, będą pisać niestandardowe reguły zastępujące te dołączone do biblioteki. To również zniechęca do wdrażania przyszłych aktualizacji biblioteki w celu zmniejszenia ryzyka.
Jeśli pakiet SDK jest kierowany na kod natywny, np. w grach lub edytorach zdjęć i filmów, podaj reguły dla wszystkich klas, które używają JNI. Większość gier działa na silnikach gry takich jak Unity i Unreal, które kompilują grę do kodu natywnego. Kod natywny gry i wtyczka komunikują się z platformą Androida za pomocą wywołań JNI.
Adnotacje Jetpack Keep, które są obecnie w wersji alfa, mogą pomóc w ograniczeniu konserwacji wymaganej przez refleksję, umożliwiając dodawanie adnotacji do użycia refleksji, które można następnie wykorzystać do generowania reguł zachowywania podczas kompilacji.
Rozważ użycie generowania kodu zamiast refleksji
Aby uniknąć awarii spowodowanych refleksją, najlepiej jest unikać refleksji i w miarę możliwości używać codegen.
Refleksja w czasie działania ukrywa użycie kodu przed R8 podczas kompilacji, co wymaga reguł zachowywania, aby uniknąć awarii. Jeśli używasz generowania kodu, kod jest optymalizowany podczas procesu kompilacji, dzięki czemu R8 ma niezbędną widoczność, aby bezpiecznie optymalizować kod przy minimalnej liczbie reguł zachowywania. Typowe scenariusze, w których generowanie kodu jest świetnym wyborem, obejmują serializację i deserializację oraz wstrzykiwanie zależności (Hilt to przykład biblioteki, która używa generowania kodu).
Generowanie kodu nie jest jednak odpowiednim rozwiązaniem w każdej sytuacji. W przypadku wzorców takich jak opcjonalne zależności refleksja jest nadal konieczna. Zalecamy połączenie refleksji z wąskimi regułami zachowywania, które chronią tylko wymagane punkty wejścia, zgodnie z opisem w sekcji Refleksja do obsługi opcjonalnych zależności.
Reguły zakresu powinny być wąskie, nawet w przypadku wstępnie zoptymalizowanych kompilacji bibliotek
Jeśli nie można uniknąć refleksji, upewnij się, że reguły zachowywania konsumenta określają tylko to, co odzwierciedla biblioteka. Gdy biblioteka uzyskuje dostęp do klasy lub metody dynamicznie, musisz tylko określić punkt wejścia, a R8 zajmie się resztą. R8 używa punktów wejścia do utworzenia grafu kodu, do którego się odwołuje, i usunięcia wszystkich klas, metod i pól, do których nie ma odwołań.
Dotyczy to również sytuacji, gdy kompilacja biblioteki została już zoptymalizowana lub zaciemniona, co jest świetną praktyką zapewniającą wydajny i lekki pakiet SDK. Ponieważ reguły są stosowane podczas kompilacji aplikacji, R8 może nadal optymalizować bibliotekę na podstawie rzeczywistych klas i metod używanych przez aplikację niższego poziomu. Polecenie analizy interfejsu wiersza poleceń Androida proaktywnie wyświetla zarówno używane, jak i nieużywane reguły zachowywania na poziomie pakietu, które przyczyniają się do blokowania optymalizacji.
Wąski zakres reguł zachowywania w przypadku zależności od innych firm
Oto typowy wzorzec:
-keep public class com.google.android.gms.** { *; }Jeśli aplikacja integrująca Twój pakiet SDK używa też innej biblioteki GMS i zawiera regułę zachowywania, która ogranicza ilość zachowywanego kodu, ta ogólna reguła zastępuje ją, co przyczynia się do niepotrzebnego zwiększenia rozmiaru aplikacji.
Podczas wywoływania bibliotek zewnętrznych należy zaprojektować reguły zachowywania, które ściśle zachowują tylko te elementy, do których biblioteka uzyskuje dostęp przez refleksję. W rzeczywistości wiele bibliotek (w tym GMS) zawiera już własne reguły zachowywania dla klientów. Wprowadzenie reguły zachowywania dla całego pakietu może też obejmować starannie napisane, wąskie reguły dla klientów z biblioteki podrzędnej.
Rozważenie warunkowych reguł zachowywania dla adapterów zapośredniczenia reklam
Jeśli biblioteka reklam jest wczytywana za pomocą adapterów zapośredniczenia, nadal możesz używać reguł zachowywania wąskich. W takim przypadku zalecamy użycie warunkowych reguł zachowywania, aby zachować tylko określone funkcje lub formaty, jeśli aplikacja zawiera odpowiedni adapter. Dzięki temu R8 może nadal zmniejszać funkcje, których aplikacja nie używa. Zamiast pisać złożone reguły ręcznie, możesz też użyć adnotacji Jetpack Keep, aby dodawać adnotacje do wywołań refleksyjnych bezpośrednio w kodzie źródłowym i automatycznie generować warunkowe reguły zachowywania dla konsumentów, w tym dla opcjonalnych modułów dodatkowych.
Reguły wysyłki w regułach dla konsumentów, a nie w dokumentacji
Dostarczając reguły konsumenckie wraz z biblioteką, zapewniasz, że aplikacje z kompilacją z włączonym R8 mogą korzystać z biblioteki od razu po zainstalowaniu i uzyskać maksymalną optymalizację.
Określanie reguł w dokumentacji zwiększa trudność ręcznej konfiguracji (zwłaszcza że dołączone reguły przechowywania dla klientów są od lat obsługiwane w plikach AAR i JAR) i powoduje stałe obciążenie związane z konserwacją. Gdy aktualizujesz bibliotekę (w tym refaktoryzujesz, zmieniasz nazwy klas i sposób używania refleksji), musisz pamiętać o zaktualizowaniu dokumentacji, a aplikacje muszą sprawdzać, czy nie ma nowych reguł. Z czasem, gdy aplikacje są uaktualniane do kolejnych wersji biblioteki, mogą gromadzić starsze reguły zachowywania, które nie są już potrzebne, co prowadzi do niepotrzebnego zwiększania rozmiaru aplikacji.
3. Odczytywanie zrzutów stosu wersji
Zrzut stosu może być nieczytelny z powodu zaciemnionego kodu. Aby odblokować analizę krytyczną, można użyć keepnames, co umożliwia zmniejszanie, ale uniemożliwia dodatkowe optymalizacje, takie jak zmiana nazwy w aplikacji użytkownika – dokładne wartości, których potrzebujesz podczas debugowania zrzutu stosu.
Nie musisz zapobiegać dodatkowym optymalizacjom, aby uzyskać czytelne zrzuty stosu.
Firebase Crashlytics, Konsola Play i Logcat w Android Studio usuwają zaciemnienie kodu zrzutów stosu dla deweloperów aplikacji. Oznacza to, że jeśli deweloper aplikacji udostępni Ci zrzut stosu, nie musisz zapobiegać zaciemnianiu, aby móc go odczytać.
Jeśli prześlesz plik mapowania do SDK Console, będziesz mieć możliwość wyświetlania zrzutów stosu z usuniętym zaciemnieniem kodu w SDK Console.
Optymalizacja bez zgadywania
Optymalizacja biblioteki nie powinna być grą prób i błędów.
Dzięki zachowaniu reguł konsumentów dostawcy bibliotek mogą zapewnić, że aplikacje w całym ekosystemie nie będą blokowane przed optymalizacją.
Gdy biblioteki dostarczają lepsze reguły, aplikacje stają się mniejsze i szybsze. Zacznij sprawdzać reguły zachowywania konsumentów już dziś, aby pomóc aplikacjom, które zależą od Twojej biblioteki, działać jak najlepiej.
-
InstrukcjeOmówimy optymalizację na podstawie profilu, ulepszenia wydajności Jetpack Compose i kwestie związane z pracą za kulisami.
Ben Weiss, Breana Tate, Jossi Wolf • Czas czytania: 8 min -
InstrukcjeWitamy ponownie w serii postów na blogu „Tworzenie inteligentnych aplikacji na Androida”, w której przekształcamy podstawową aplikację na Androida w spersonalizowaną, inteligentną i agentową. W poprzednim poście dowiedzieliście się, jak połączyć się z systemem AI za pomocą funkcji AppFunctions.
Jolanda Verhoef • Czas czytania: 9 min -
InstrukcjeWydaliśmy Media3 1.11. Ta wersja, która obsługuje większość najpopularniejszych aplikacji do multimediów na Androida, zawiera nowe funkcje, poprawki błędów i ulepszenia dotyczące odtwarzania, edytowania i komponentów UI.
Toni Heidenreich • Czas czytania: 3 min
Otrzymuj co tydzień najnowsze informacje o tworzeniu aplikacji na Androida na swoją skrzynkę odbiorczą.