Wtyczka Androida do obsługi Gradle 8.0.0 (kwiecień 2023 r.)

Wtyczka Androida do obsługi Gradle w wersji 8.0.0 to duża aktualizacja, która zawiera wiele nowych funkcji i ulepszeń.

Zgodność

Wersje poprawek

Poniżej znajdziesz listę wersji poprawek wtyczki Androida do obsługi Gradle w wersji 8.0.

Wtyczka Androida do obsługi Gradle 8.0.2 (maj 2023 r.)

Listę błędów naprawionych w wersji AGP 8.0.2 znajdziesz w artykule Android Studio 2022.2.1: zamknięte problemy.

Wtyczka Androida do obsługi Gradle 8.0.1 (maj 2023 r.)

Ta niewielka aktualizacja zawiera następujące poprawki błędów:

Zmiana powodująca przerwanie działania: w skrypcie kompilacji na poziomie modułu wymagana jest nazwa przestrzeni nazw

Przestrzeń nazw należy ustawić w pliku build.gradle.kts na poziomie modułu, a nie w pliku manifestu. Możesz zacząć korzystać z usługi DSL namespace, począwszy od wersji AGP 7.3. Więcej informacji znajdziesz w artykule Konfigurowanie przestrzeni nazw.

Podczas migracji do DSL nazwy domeny pamiętaj o tych kwestiach:

• W poprzednich wersjach AGP w niektórych przypadkach przestrzeń nazw testu była nieprawidłowo wywnioskowywana z przestrzeni głównej lub identyfikatora aplikacji. Asystent uaktualnienia AGP blokuje uaktualnienie, jeśli stwierdzi, że główna i testowa przestrzeń nazw Twojego projektu są takie same. Jeśli uaktualnienie jest zablokowane, musisz ręcznie zmienić testNamespacei odpowiednio zmodyfikować kod źródłowy.
• Po zmianie przestrzeni nazw testów kod może się kompilować, ale testy z instrumentacją mogą się nie uruchomić. Może się tak zdarzyć, jeśli zmodyfikowany kod źródłowy testu odwołuje się do zasobu zdefiniowanego zarówno w źródłach androidTest, jak i w źródłach aplikacji.

Więcej informacji znajdziesz w komentarzu 19 do zgłoszenia issue #191813691.

Zmiany wpływające na działanie aplikacji: domyślne wartości opcji kompilacji

Od wersji AGP 8.0 domyślne wartości tych flag zostały zmienione, aby poprawić wydajność kompilacji. Aby dowiedzieć się, jak dostosować kod do obsługi niektórych z tych zmian, skorzystaj z Asystenta przejścia na AGP (Narzędzia > Asystent przejścia na AGP). Asystent uaktualniania poprowadzi Cię przez proces aktualizowania kodu w celu dostosowania go do nowego zachowania lub ustawiania flag, aby zachować poprzednie zachowanie.

Zmiany powodujące przerwanie działania: wymuszone wartości opcji kompilacji

Od wersji 8.0 AGP nie można już zmieniać wartości tych flag. Jeśli określisz je w pliku gradle.properties, zostaną one zignorowane, a AGP wypisze ostrzeżenia.

Nowa flaga stabilności dla profilu wykonania

AGP zawiera nową flagę android.settings.executionProfile. Użyj tej flagi, aby zastąpić domyślny profil wykonania z SettingsExtension. Więcej informacji znajdziesz w dokumentacji wtyczki ustawień.

Aby wyświetlić flagi eksperymentalne, zapoznaj się z informacjami o wersji zapoznawczej.

Nieobsługiwane przypisanie właściwości opóźnionej w Kotlinie

Jeśli w swoich skryptach kompilacji używasz języka Kotlin DSL w Gradle, pamiętaj, że Android Studio i AGP 8.0 nie obsługują eksperymentalnego przypisywania właściwości za pomocą operatora =. Więcej informacji o tej funkcji znajdziesz w informacjach o wersji i dokumentacji.

Kategorie zadań w analizatorze

Począwszy od Android Studio Flamingo, analiza kompilacji ma nowy widok domyślny zadań, które wpływają na czas kompilacji. Jeśli Twój projekt używa AGP 8.0 lub nowszej wersji, zamiast wyświetlać zadania pojedynczo, analizator kompilacji grupował je według kategorii. Na przykład zadania związane z zasobami Androida, Kotlinem lub Dexingiem są grupowane, a następnie sortowane według czasu trwania kompilacji. Dzięki temu łatwo dowiesz się, która kategoria ma największy wpływ na czas kompilacji. Rozwinięcie każdej kategorii powoduje wyświetlenie listy odpowiednich zadań. Aby wyświetlać zadania pojedynczo, bez grupowania, użyj menu Grupuj według.

Nowa wtyczka ustawień

Wersja AGP 8.0.0-alpha09 wprowadza nowy moduł ustawień. Dzięki niemu możesz centralizować konfiguracje globalne (czyli konfiguracje, które mają zastosowanie do wszystkich modułów) w jednym miejscu, dzięki czemu nie musisz kopiować i wklejać konfiguracji w różnych modułach. Dodatkowo za pomocą wtyczki ustawień możesz tworzyć profile wykonania narzędzia lub różne instrukcje dotyczące jego uruchamiania i przełączać się między nimi.

Aby użyć wtyczki ustawień, zastosuj ją w pliku settings.gradle:

apply plugin 'com.android.settings'

Centralizacja konfiguracji globalnych

Aby skonfigurować konfiguracje globalne, użyj nowego bloku android w pliku settings.gradle. Oto przykład:

android {
  compileSdk 31
  minSdk 28
  ...
}

Profile wykonania narzędzia

Dzięki wtyczce z ustawieniami możesz też tworzyć profile wykonywania niektórych narzędzi. Profil wykonania określa sposób działania narzędzia. W zależności od środowiska możesz wybrać różne profile wykonania. W profilu wykonania możesz ustawić argumenty JVM dla narzędzia i skonfigurować je tak, aby działało w osobnym procesie. Obecnie obsługiwane jest tylko narzędzie R8.

Utwórz profile wykonania i ustaw domyślny profil wykonania w pliku settings.gradle, jak pokazano w tym przykładzie:

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

Aby zastąpić profil domyślny, wybierz inny profil za pomocą właściwości android.experimental.settings.executionProfile w pliku gradle.properties:

android.experimental.settings.executionProfile=high

Możesz też ustawić tę właściwość za pomocą wiersza poleceń, co pozwoli Ci skonfigurować różne przepływy pracy. Jeśli na przykład masz proces ciągłej integracji, możesz użyć wiersza poleceń, aby zmienić profil wykonania bez konieczności zmiany pliku settings.gradle:

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

Do uruchamiania AGP 8.0 wymagana jest wersja JDK 17

Jeśli do kompilowania aplikacji używasz wtyczki Androida do obsługi Gradle w wersji 8.0, do uruchomienia Gradle wymagana jest teraz wersja JDK 17. Android Studio Flamingo zawiera pakiet JDK 17 i konfiguruje Gradle do użycia go domyślnie, co oznacza, że większość użytkowników Android Studio nie musi wprowadzać żadnych zmian konfiguracyjnych w swoich projektach.

Jeśli musisz ręcznie ustawić wersję pakietu JDK używanego przez AGP w Android Studio, musisz użyć pakietu JDK 17 lub nowszego.

Jeśli używasz AGP niezależnie od Android Studio, zaktualizuj wersję JDK, ustawiając zmienną środowiskową JAVA_HOME lub opcję wiersza poleceń -Dorg.gradle.java.home w katalogu instalacyjnym JDK 17.

Rozwiązane problemy

Wtyczka Androida do obsługi Gradle 8.0.0

Wtyczka Androida do obsługi Gradle 8.0.1

Wtyczka Androida do obsługi Gradle 8.0.2