Wtyczka Androida do obsługi Gradle w wersji 8.3.0 to duża wersja oferująca wiele nowych funkcji i udoskonaleń.
Zgodność
Maksymalny poziom interfejsu API obsługiwany przez wtyczkę Androida do obsługi Gradle w wersji 8.3 to poziom API 34. Inne informacje dotyczące zgodności:
Wersja minimalna | Wersja domyślna | Notatki | |
---|---|---|---|
Gradle | 8.4 | 8.4 | Aby dowiedzieć się więcej, zobacz aktualizowanie Gradle. |
Narzędzia do kompilacji SDK | 34,0.0 | 34,0.0 | Zainstaluj lub skonfiguruj narzędzia do kompilacji SDK. |
Zestaw NDK | Nie dotyczy | 25.1.8937393 | Zainstaluj lub skonfiguruj inną wersję pakietu NDK. |
JDK | 17 | 17 | Więcej informacji znajdziesz w sekcji na temat ustawiania wersji JDK. |
Oto nowe funkcje wtyczki Androida do obsługi Gradle w wersji 8.3.
Wersje poprawek
Poniżej znajduje się lista poprawek wersji Androida Studio Iguana i wtyczki Androida do obsługi Gradle w wersji 8.3.
Android Studio Iguana | Poprawka 2 i 3.02.2023.2.1 (kwiecień 2024 r.)
Ta drobna aktualizacja zawiera poprawki błędów.
Android Studio Iguana | Poprawka 1 w wersji 1 i 8.3.1 w wersji 2023.2.1 (marzec 2024 r.)
Ta drobna aktualizacja zawiera poprawki błędów.
Obsługa katalogów wersji Gradle
Android Studio obsługuje katalogi wersji Gradle na platformie TOML, czyli funkcję, która umożliwia zarządzanie zależnościami w jednej centralnej lokalizacji i udostępnianie zależności między modułami lub projektami. Android Studio ułatwia teraz konfigurowanie katalogów wersji przez sugestie edytorów oraz integrację z oknem Struktura projektu. Dowiedz się, jak skonfigurować katalogi wersji Gradle lub jak przenieść kompilację do katalogów wersji.
Uzupełnianie kodu i poruszanie się po nim
Android Studio umożliwia uzupełnianie kodu podczas edytowania katalogu wersji w formacie pliku TOML lub dodawania zależności z katalogu wersji do pliku kompilacji. Aby użyć uzupełniania kodu, naciśnij Ctrl+spacja (Command+spacja w systemie macOS). Możesz też szybko przejść z odwołania do zależności w pliku build.gradle
aplikacji do miejsca zadeklarowanego w katalogu wersji, naciskając Ctrl+b (Command+b w systemie macOS).
Integracja z oknem Struktura projektu
Jeśli Twój projekt używa katalogu wersji zdefiniowanego w formacie pliku TOML, możesz edytować zdefiniowane w nim zmienne w oknie Struktura projektu w widoku Zmienne (Plik > Struktura projektu > Zmienne) w Android Studio. Dla każdego katalogu wersji dostępne jest menu z listą zmiennych. Aby edytować zmienną, kliknij jej wartość i zastąp ją. Po zapisaniu tych zmian plik TOML jest odpowiednio aktualizowany.
Zależności możesz też zaktualizować w widoku Zależności w oknie Struktura projektu (Plik > Struktura projektu > Zależności). Aby zaktualizować wersje za pomocą okna Struktura projektu, przejdź do modułu i zależności, które chcesz edytować, a następnie zaktualizuj pole Żądana wersja. Gdy zapiszesz te zmiany, plik TOML zostanie odpowiednio zaktualizowany. Pamiętaj, że jeśli wersja zależności została zdefiniowana za pomocą zmiennej, bezpośrednie zaktualizowanie wersji w ten sposób spowoduje zastąpienie zmiennej zakodowaną na stałe wartością. Pamiętaj też, że usunięcie zależności z pliku kompilacji niezależnie od tego, czy użyjesz okna Struktura projektu, nie usuwa zależności z katalogu wersji.
Znane problemy i ograniczenia
Poniżej znajdziesz znane problemy lub ograniczenia związane z obsługą katalogów wersji Gradle w Android Studio.
Podczas wyróżniania deklaracji aliasów wtyczek w plikach skryptu Kotlin wystąpił błąd: gdy dodajesz deklarację wtyczki w formularzu
alias(libs.plugins.example)
, edytor dodaje czerwone podkreślenie w częścilibs
. Jest to znany problem w Gradle w wersji 8.0 i starszych. Zostanie on rozwiązany w przyszłej wersji Gradle.Android Studio obsługuje tylko katalogi wersji w formacie TOML. Obecnie obsługa uzupełniania kodu, nawigacji i struktury projektu w Android Studio jest obecnie dostępna tylko w przypadku katalogów wersji zdefiniowanych w formacie pliku TOML. Nadal możesz jednak dodać katalog wersji bezpośrednio w pliku
settings.gradle
i używać jego zależności w projekcie.Nawigacja po plikach kompilacji KTS: przechodzenie do definicji zależności w katalogu wersji za pomocą skrótu Control+kliknięcie (Command + kliknięcie w systemie macOS) nie jest jeszcze obsługiwane w przypadku plików kompilacji napisanych za pomocą skryptu Kotlin.
Asystent Firebase dodaje zależności bezpośrednio w skryptach kompilacji: Asystent Firebase dodaje zależności bezpośrednio do skryptów kompilacji, a nie przez katalogi wersji.
Funkcja „Znajdź przypadki użycia” nie jest obsługiwana: znajdowanie przypadków użycia zmiennej katalogu wersji w innych plikach kompilacji nie jest jeszcze obsługiwane niezależnie od tego, czy plik kompilacji znajduje się w KTS, czy w Groovy. Oznacza to, że użycie Control i kliknięcie (Command w systemie macOS) definicji zmiennej w katalogu wersji nie prowadzi do plików kompilacji, w których jest ona używana.
Okno Struktura projektu w Android Studio pokazuje wiele plików katalogu, jeśli znajdują się one w głównym folderze
gradle
, ale nie pokazują katalogów w przypadku kompozytowej kompilacji. Jeśli na przykład masz 2 pliki katalogu – jeden dla aplikacji, a drugi dla kompilacji złożonej – w oknie Struktura projektu pojawi się tylko plik katalogu aplikacji. Możesz użyć kompilacji złożonej, ale musisz bezpośrednio edytować jej plik TOML.
Dodatkowe informacje o pakietach SDK: problemy ze zgodnością z zasadami
Android Studio wyświetla ostrzeżenia o lintowaniu w plikach build.gradle.kts
i build.gradle
oraz w oknie struktury projektu w przypadku publicznych pakietów SDK, które naruszają zasady Google Play na platformie Google Play SDK Index. Zaktualizuj wszystkie zależności, które naruszają zasady Google Play, ponieważ mogą one uniemożliwić Ci publikowanie treści w Konsoli Google Play w przyszłości. Ostrzeżenia o naruszeniu zasad stanowią uzupełnienie ostrzeżeń o nieaktualnych wersjach wyświetlanych w Android Studio.
Obsługa wersji pliku buildSdk w Android Studio
Android Studio wyświetla ostrzeżenie, jeśli w projekcie używasz zasobu compileSdk
, który nie jest obsługiwany w bieżącej wersji Android Studio. Jeśli to możliwe, sugeruje też przejście na wersję Android Studio, która obsługuje interfejs compileSdk
używany w Twoim projekcie. Pamiętaj, że uaktualnienie Androida Studio może też wymagać przejścia na AGP.
AGP wyświetla też ostrzeżenie w oknie narzędzia Build, jeśli compileSdk
używany w Twoim projekcie nie jest obsługiwany w bieżącej wersji AGP.
Zmiany działania lint
Począwszy od wtyczki Androida do obsługi Gradle w wersji 8.3.0-alfa02, gdy uruchamiasz lint w module, dla jego głównego i testowego komponentu są wykonywane osobne zadania analizy lint. Ta zmiana ma na celu poprawę skuteczności.
Aby przywrócić wcześniejsze działanie, ustaw parametr android.experimental.lint.analysisPerComponent=false
w pliku gradle.properties
.
Precyzyjne zmniejszanie zasobów domyślnie włączone
Precyzyjne zmniejszanie zasobów, które usuwa nieużywane wpisy z pliku resources.arsc
i eliminuje nieużywane pliki zasobów, jest domyślnie włączone.
Gdy to zmniejszanie jest włączone, tabela zasobów jest zmniejszona i w pliku APK uwzględniane są tylko odwołania do res
wpisów folderu.
Aby wyłączyć precyzyjne zmniejszanie zasobów, ustaw android.enableNewResourceShrinker.preciseShrinking
na false
w pliku gradle.properties
projektu.