Włączanie optymalizacji aplikacji za pomocą R8

android skills add 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,
• ograniczenie wykorzystania 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. Najważniejsze operacje:

• 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 graf odwołań do kodu i usuwa wszystko, do czego nie ma odwołań.

• Optymalizacje logiczne: R8 przepisuje kod, aby zwiększyć wydajność wykonywania i zmniejszyć obciążenie. Najważniejsze techniki:

  • Wstawianie metod: R8 zastępuje miejsce wywołania metody rzeczywistą treścią 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 reguły zachowywania do pliku z sufiksem .keep w src/<variant>/keepRules zestawie źródeł. 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ć możliwości R8, stosuj te sprawdzone metody:

• 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 zachowywania, aby umożliwić maksymalną optymalizację klas, pól i metod.

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

Analizator konfiguracji R8 umożliwia:

• śledzenie i poprawianie ogólnej jakości konfiguracji R8 przez monitorowanie danych podanych w raporcie analizatora konfiguracji R8;
• znajdowanie najszerszych reguł zachowywania, 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 zachowywania, 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 graf odwołań. Gdy do zbioru kodu lub zasobów nie ma odwołań, nie jest on chroniony przez regułę zachowywania 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 do pliku gradle.properties projektu te informacje:

android.r8.optimizedResourceShrinking=true

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:

android.enableR8.fullMode=false

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 zachowywania, aby zachować część kodu bez zmian.
• Wdrażaj 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 ś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.

Używanie R8 z innymi systemami kompilacji

AGP jest zalecanym i oficjalnie obsługiwanym systemem kompilacji aplikacji na Androida , ale możesz używać alternatywnego systemu kompilacji, takiego jak Bazel. Jeśli używasz Bazela, możesz zintegrować R8 z potokiem kompilacji, aby zmniejszać, zaciemniać i optymalizować aplikację.

Informacje o optymalizowaniu aplikacji na Androida za pomocą Bazela znajdziesz w dokumentacji rules_android Bazela. Pamiętaj, że Bazel nie jest oficjalnie obsługiwany w przypadku tworzenia aplikacji na Androida.