Włączanie optymalizacji aplikacji za pomocą R8

android skills add --skill r8-analyzer

Aby zapewnić użytkownikom jak najlepsze wrażenia, zoptymalizuj aplikację, aby była jak najmniejsza i jak najszybsza. Nasz optymalizator aplikacji, R8, usprawnia aplikację, usuwając nieużywany kod i zasoby, przepisując kod w celu optymalizacji wydajności środowiska wykonawczego i nie tylko. Dla użytkowników oznacza to:

• szybsze uruchamianie aplikacji,
• mniejsze zużycie pamięci,
• lepsze renderowanie i wydajność środowiska wykonawczego,
• mniej błędów ANR.

Omówienie optymalizacji R8

R8 używa procesu wieloetapowego, aby zoptymalizować aplikację pod kątem rozmiaru i szybkości. Główne operacje obejmują:

• Zmniejszanie kodu (nazywane też tree shaking): R8 identyfikuje i usuwa nieosiągalny kod z aplikacji i jej zależności bibliotecznych. Analizując punkty wejścia aplikacji (takie jak Activities czy Services zdefiniowane w manifeście), R8 tworzy wykres kodu, do którego się odwołuje, i usuwa wszystko, do czego nie ma odniesień.

• Optymalizacje logiczne: R8 przepisuje kod, aby zwiększyć wydajność wykonywania i zmniejszyć obciążenie. Główne techniki obejmują:

  • Wstawianie metod: R8 zastępuje miejsce wywołania metody rzeczywistym ciałem wywoływanej metody. Eliminuje to obciążenie związane z wywołaniem funkcji i umożliwia R8 przeprowadzanie dalszych optymalizacji.

  • Scalanie klas: R8 łączy zestawy klas i interfejsów w jedną klasę. Zmniejsza to liczbę klas w aplikacji, co zmniejsza obciążenie pamięci i zwiększa szybkość uruchamiania.

• Zaciemnianie kodu (nazywane też minifikacją): aby zmniejszyć rozmiar pliku DEX , R8 skraca nazwy klas, pól i metod (np. com.example.MyActivity może stać się a.b.a).

Od wersji 8.12.0 wtyczki Androida do obsługi Gradle (AGP) R8 optymalizuje też zasoby w ramach etapów optymalizacji. Więcej informacji znajdziesz w artykule Zoptymalizowane zmniejszanie zasobów.

Włączanie optymalizacji

Aby włączyć optymalizację aplikacji, użyj odpowiedniego DSL na podstawie wersji AGP projektu. Zalecamy włączanie optymalizacji aplikacji tylko w ostatecznej wersji aplikacji, którą testujesz przed opublikowaniem – zwykle w kompilacji do publikacji – ponieważ optymalizacje zwiększają czas kompilacji projektu i mogą utrudniać debugowanie ze względu na sposób modyfikowania kodu.

W przypadku AGP w wersji 9.3 lub nowszej

Aby włączyć optymalizację aplikacji w AGP w wersji 9.3 lub nowszej:

• Ustaw enable = true w bloku optimization w skrypcie kompilacji na poziomie aplikacji w kompilacji do publikacji.
• Dodaj swoje reguły keep do pliku z sufiksem .keep w zestawie źródeł src/<variant>/keepRules. Na przykład src/main/keepRules/custom-rules.keep.

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

Starszy DSL w przypadku AGP w wersji starszej niż 9.3

Aby włączyć optymalizację aplikacji, ustaw isMinifyEnabled = true (w przypadku optymalizacji kodu) i isShrinkResources = true (w przypadku optymalizacji zasobów) w skrypcie kompilacji na poziomie aplikacji w kompilacji do publikacji build's. Zalecamy, aby zawsze włączać oba ustawienia.

android {
    buildTypes {
        release {

            // Enables code optimizations.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code optimizations.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

Ulepszanie optymalizacji R8

Korzyści z wydajności R8 są bezpośrednio związane z tym, jak dużą część bazy kodu R8 może zoptymalizować. Aby w pełni wykorzystać R8, postępuj zgodnie z tymi sprawdzonymi metodami:

• Włącz R8 w trybie pełnym.
• Włącz zaciemnianie kodu, optymalizację i zmniejszanie
• Włącz zmniejszanie zasobów i zoptymalizowane zmniejszanie zasobów
• Doprecyzuj reguły keep, aby umożliwić maksymalną optymalizację klas, pól i metod.

Aby doprecyzować reguły keep, użyj analizatora konfiguracji R8.

Analizator konfiguracji R8 umożliwia:

• śledzenie i poprawianie ogólnej jakości konfiguracji R8 przez monitorowanie danych podawanych w raporcie analizatora konfiguracji R8;
• znajdowanie najszerszych reguł keep, które uniemożliwiają największą optymalizację;
• poznawanie, jakiej optymalizacji zapobiegają, aby je doprecyzować.

Analizator konfiguracji R8 jest dostępny w AGP w wersji 9.3.0-alpha05 lub w R8 w wersji 9.3.7-dev. Więcej informacji znajdziesz w artykule Analizowanie konfiguracji R8.

Optymalizowanie zmniejszania zasobów, aby aplikacje były jeszcze mniejsze

Wersja 8.12.0 AGP wprowadza zoptymalizowane zmniejszanie zasobów, które ma na celu zintegrowanie optymalizacji zasobów i kodu, aby tworzyć jeszcze mniejsze i szybsze aplikacje. Przed zoptymalizowanym zmniejszaniem zasobów narzędzie Android Asset Packaging Tool (AAPT2) generowało reguły keep, które skutecznie traktowały zmniejszanie zasobów oddzielnie od kodu, często zachowując niedostępny kod lub zasoby, które się wzajemnie odwoływały.

W przypadku zoptymalizowanego zmniejszania zasobów zasoby są traktowane jako część kodu programu, tworząc wykres odniesień. Gdy do zbioru kodu lub zasobów nie ma odniesień, nie jest on chroniony przez regułę keep i można go usunąć.

Włączanie zoptymalizowanego zmniejszania zasobów

Aby włączyć nowy potok zoptymalizowanego zmniejszania zasobów w AGP w wersji 8.12 lub 8.13, dodaj te wiersze do pliku gradle.properties projektu:

Jeśli używasz AGP w wersji 9.0.0 lub nowszej, nie musisz ustawiać android.r8.optimizedResourceShrinking=true. Zoptymalizowane zmniejszanie zasobów jest stosowane automatycznie, gdy w konfiguracji kompilacji włączysz isShrinkResources = true.

Sprawdzanie i konfigurowanie ustawień optymalizacji R8

Aby umożliwić R8 korzystanie z pełnych możliwości optymalizacji, usuń z pliku gradle.properties projektu ten wiersz, jeśli istnieje:

bash android.enableR8.fullMode=false # Remove this line from your codebase.

Pamiętaj, że włączenie optymalizacji aplikacji utrudnia zrozumienie śladów stosu, zwłaszcza jeśli R8 zmienia nazwy klas lub metod. Aby uzyskać ślady stosu, które prawidłowo odpowiadają kodowi źródłowemu, przeczytaj artykuł Przywracanie oryginalnego śladu stosu.

Jeśli R8 jest włączony, warto też utworzyć profile uruchamiania, aby jeszcze bardziej zwiększyć wydajność uruchamiania.

Jeśli włączenie optymalizacji aplikacji powoduje błędy, możesz je naprawić, stosując te strategie:

• Dodaj reguły keep, aby zachować część kodu bez zmian.
• Wprowadzaj optymalizacje stopniowo.
• Zaktualizuj kod, aby używać bibliotek, które lepiej nadają się do optymalizacji.

Jeśli chcesz zoptymalizować szybkość kompilacji, przeczytaj artykuł Konfigurowanie sposobu działania R8 runs, aby dowiedzieć się, jak skonfigurować R8 na podstawie swojego środowiska.

Zmiany w działaniu AGP i R8

W tabeli poniżej znajdziesz najważniejsze funkcje wprowadzone w różnych wersjach wtyczki Androida do obsługi Gradle (AGP) i kompilatora R8.