Nowe funkcje w wersji testowej Android Studio

Na tej stronie znajdziesz listę nowych funkcji wprowadzonych w wersjach podglądowych Androida Studio. Wersje przedpremierowe zapewniają wcześniejszy dostęp do najnowszych funkcji i ulepszeń w Android Studio. Możesz pobrać te wersje. Jeśli podczas korzystania z wersji podglądowej Androida Studio napotkasz problemy, daj nam znać. Twoje raporty o błędach pomagają ulepszać Android Studio.

Wersje do wczesnych testów zawierają najnowsze funkcje, które są w trakcie aktywnego rozwijania i są testowane w niewielkim stopniu. Wersje Canary możesz wykorzystywać do programowania, ale pamiętaj, że funkcje mogą być dodawane lub zmieniane. Wersje kandydujące do publikacji (RC) to kolejne wersje Android Studio, które są prawie gotowe do wydania stabilnego. Zestaw funkcji w następnej wersji został ustabilizowany. Aby dowiedzieć się więcej o nazwach wersji Android Studio, zapoznaj się z artykułem Nazwy wersji Android Studio.

Najnowsze informacje o wersjach podglądowych Androida Studio, w tym listę ważnych poprawek w każdej z nich, znajdziesz w sekcji Aktualizacje wersji na blogu Androida Studio.

Obecne wersje Android Studio

W tabeli poniżej znajdziesz aktualne wersje Androida Studio i odpowiadające im kanały.

Wersja Kanał
Pakiet nowych funkcji Android Studio Narwhal | 2025.1.2 Stabilnie
Wtyczka Androida do obsługi Gradle w wersji 8.12.0 Stabilnie
Pakiet nowych funkcji Android Studio Narwhal 3 | 2025.1.3 RC
Pakiet nowych funkcji Android Studio Narwhal 4 | 2025.1.4 Canary

Zgodność z wersjami podglądowymi wtyczki Androida do obsługi Gradle

Każda wersja podglądowa Androida Studio jest publikowana wraz z odpowiednią wersją wtyczki Androida do obsługi Gradle (AGP). Wersje podglądowe Studio powinny działać z każdą zgodną stabilną wersją AGP. Jeśli jednak używasz wersji przedpremierowej AGP, musisz używać odpowiedniej wersji przedpremierowej Studio (np. Android Studio Chipmunk Canary 7 z AGP 7.2.0-alpha07). Próby użycia różnych wersji (np. Android Studio Chipmunk Beta 1 z AGP 7.2.0-alpha07) spowodują błąd synchronizacji, co spowoduje wyświetlenie prośby o aktualizację do odpowiedniej wersji AGP.

Szczegółowy dziennik wycofań i usunięć interfejsu API wtyczki Androida do obsługi Gradle znajdziesz w aktualizacjach interfejsu API wtyczki Androida do obsługi Gradle.

Studio Labs

Laboratorium Studio umożliwia wypróbowanie najnowszych eksperymentalnych funkcji AI w stabilnej wersji Android Studio, dzięki czemu możesz szybciej zintegrować nasze narzędzia oparte na AI ze swoim procesem tworzenia aplikacji. Więcej informacji znajdziesz w artykule Studio Labs.

Poniżej znajdziesz funkcje, które są obecnie dostępne w Laboratorium Studio.

Funkcja Opis Dokumenty
Generowanie podglądu w widoku tworzenia Gemini może automatycznie generować podglądy funkcji do tworzenia interfejsu, w tym dane testowe dla parametrów podglądu, dla konkretnej funkcji lub wszystkich funkcji w pliku. Generowanie podglądów Compose
Dołączanie obrazów Dołącz obraz do zapytania, aby ułatwić generowanie interfejsu, debugowanie błędów interfejsu, dokumentowanie architektury aplikacji i wykonywanie innych zadań. Załączanie obrazów
Dołącz pliki Dołącz pliki do zapytania, aby pomóc Gemini lepiej zrozumieć kontekst pytania i określić, który kod wymaga aktualizacji. Załączanie plików
Interfejs przekształcania Używaj języka naturalnego, aby aktualizować interfejs aplikacji bezpośrednio w panelu podglądu Compose. Interfejs przekształcania

Pakiet nowych funkcji Android Studio Narwhal 3 | 2025.1.3

Oto nowe funkcje w Android Studio Narwhal 3 Feature Drop | 2025.1.3.

Aby dowiedzieć się, co zostało naprawione w tej wersji Androida Studio, zapoznaj się z zamkniętymi problemami.

Podglądy Compose o zmienianym rozmiarze

Podgląd kompozycji obsługuje teraz dynamiczną zmianę rozmiaru, dzięki czemu możesz od razu zobaczyć, jak interfejs użytkownika dostosowuje się do różnych rozmiarów ekranu.

Aby skorzystać z tej funkcji, włącz tryb Skupienie w podglądzie kompozycji, zmieniając opcję widoku na pasku narzędzi:

Tryb pełnej koncentracji w widoku tworzenia
Tryb pełnej koncentracji w podglądzie kompozycji

Możesz teraz zmienić rozmiar okna podglądu, przeciągając jego krawędzie:

Zmiana rozmiaru okna podglądu przez przeciąganie jego krawędzi.

Możesz też użyć paska narzędzi zmiany rozmiaru, który pojawia się po zmianie rozmiaru podglądu:

Zmiana rozmiaru okna podglądu za pomocą paska narzędzi zmiany rozmiaru.

Jeśli chcesz zapisać nowy rozmiar jako nową adnotację Preview, użyj menu rozwijanego prawym przyciskiem myszy:

Zapisywanie nowego rozmiaru podglądu w widoku tworzenia
Compose Resizeable Preview save new size

Funkcja dynamicznej zmiany rozmiaru pomaga tworzyć interfejsy, które świetnie wyglądają na ekranach o dowolnym rozmiarze.

Ustawienie widoku Androida, które umożliwia wyświetlanie plików kompilacji w odpowiednich modułach

W widoku Androida jest nowe ustawienie, które umożliwia wyświetlanie plików kompilacji w odpowiednich modułach. Ten widok może być przydatny podczas pracy nad projektami z wieloma modułami. Aby włączyć widok, otwórz menu Opcje dostępne obok widoku Androida. Następnie wybierz Wygląd > Wyświetlaj pliki kompilacji w module.

Widok Androida: pliki kompilacji w module
Możliwość wyświetlania plików kompilacji w odpowiednich modułach w widoku Androida.

Wskazówki na temat zasad Google Play w Android Studio

Android Studio zawiera teraz bardziej szczegółowe informacje i wskazówki dotyczące zasad Google Play, które mogą mieć wpływ na Twoją aplikację. Te informacje pomagają Ci od początku tworzyć bezpieczniejsze aplikacje, zapobiegając problemom, które mogą zakłócić proces wprowadzania aplikacji na rynek i później wymagać więcej czasu i zasobów na rozwiązanie.

Od pakietu nowych funkcji Android Studio Narwhal 3 możesz wyświetlać wskazówki na temat zasad Google Play jako lintowanie. Te testy lint przedstawią te informacje:

  • Omówienie zasad.
  • wskazówki, jak uniknąć typowych błędów.
  • Linki do stron z zasadami Google Play, na których znajdziesz pełne zasady i więcej przydatnych informacji oraz materiałów.

Ta funkcja ma na celu dostarczenie przydatnych wskazówek przed przesłaniem aplikacji do sprawdzenia, aby ułatwić ten proces. Nie obejmuje wszystkich zasad ani nie zawiera ostatecznych decyzji dotyczących sprawdzania aplikacji. Wskazówki znajdziesz w pełnej wersji zasad w Centrum zasad. Stale rozwijamy i ulepszamy tę integrację. Jeśli masz jakieś uwagi, zgłoś je.

Aby sprawdzić, czy w projekcie są jakieś informacje o zgodności z zasadami Google Play, otwórz Kod > Sprawdź informacje o zgodności z zasadami Google Play… Informacje będą widoczne w oknie narzędziowym „Problemy”, a także jako ostrzeżenia Lint w odpowiednich plikach.

Wskazówki na temat zasad Google Play w Android Studio
Wskazówki na temat zasad Google Play w Android Studio Narwhal 3.

Testowanie i rozwijanie aplikacji za pomocą tworzenia i przywracania kopii zapasowych

Zapewnienie prawidłowego działania kopii zapasowej i przywracania na Androidzie w przypadku Twojej aplikacji jest kluczowe, aby użytkownicy nadal z niej korzystali po przejściu na nowe urządzenie lub przywróceniu danych z chmury. Sprawdzenie, czy tworzenie i przywracanie kopii zapasowej danych działa w przypadku Twojej aplikacji, może być jednak trudne.

Android Studio Narwhal umożliwia tworzenie kopii zapasowej aplikacji i przywracanie jej na innym urządzeniu. Może to być przydatne do testowania, czy aplikacja działa zgodnie z oczekiwaniami podczas przywracania danych aplikacji z urządzenia na urządzenie lub z kopii zapasowej w chmurze, albo jeśli chcesz szybciej skonfigurować urządzenie testowe z danymi potrzebnymi do tworzenia i debugowania aplikacji.

Generowanie kopii zapasowej

Aby wygenerować plik kopii zapasowej:

  1. Wdrażanie wersji debugowania aplikacji na połączonym urządzeniu
  2. Aby wygenerować kopię zapasową, wykonaj jedną z tych czynności:
    • W oknie Uruchomione urządzenie na pasku narzędzi kliknij działanie Utwórz kopię zapasową danych aplikacji.
    • Na pasku menu głównego kliknij Uruchom > Utwórz kopię zapasową danych aplikacji.
    • Na karcie Eksplorator urządzeń > Procesy kliknij prawym przyciskiem myszy proces aplikacji i wybierz Utwórz kopię zapasową danych aplikacji.
  3. W wyświetlonym oknie wykonaj te czynności:
    • Potwierdź identyfikator aplikacji, dla której chcesz wygenerować kopię zapasową.
      • Wybierz, czy chcesz wygenerować kopię zapasową z urządzenia na urządzenie, w chmurze czy w chmurze (niezaszyfrowaną).
    • Potwierdź nazwę i lokalizację kopii zapasowej, którą chcesz zapisać. Domyślnie kopia zapasowa jest zapisywana w katalogu głównym bieżącego projektu Android Studio.
      Wygeneruj kopię zapasową aplikacji.
  4. Gdy Android Studio zapyta, czy może zatrzymać aplikację, kliknij OK. Aby wygenerować kopię zapasową, Android Studio musi zatrzymać proces aplikacji.

Wygenerowane kopie zapasowe możesz wyświetlić w oknie narzędzi Projekt > Android w węźle Pliki kopii zapasowych.

Typy kopii zapasowych

Możesz wygenerować różne typy kopii zapasowych aplikacji. Podczas generowania kopii zapasowej wybierz typ, który odpowiada scenariuszowi, który chcesz przetestować:

  • Urządzenie – urządzenie: tworzy kopię zapasową aplikacji podobną do tej, która jest tworzona podczas przenoszenia danych z urządzenia na urządzenie. Podczas przenoszenia danych między urządzeniami dane kopii zapasowej aplikacji są wysyłane bezpośrednio na inne urządzenie, np. przez USB lub Wi-Fi.
  • Chmura: tworzy kopię zapasową aplikacji podobną do tej zapisanej na koncie Google użytkownika. Gdy użytkownik konfiguruje nowe urządzenie, może przywrócić dane z kopii zapasowej w chmurze.
  • Chmura (bez szyfrowania): tworzy kopię zapasową aplikacji podobną do tej, która jest zapisywana w pamięci konta Google użytkownika na urządzeniu bez włączonego szyfrowania po stronie klienta.

Uwaga: gdy używasz tej funkcji do testowania chmury, chmury (bez szyfrowania) lub kopii zapasowych z urządzenia na urządzenie, wygenerowana kopia zapasowa nie jest wysyłana do chmury ani na inne urządzenie, w przeciwieństwie do rzeczywistego procesu tworzenia kopii zapasowej. Generuje kopię zapasową aplikacji tak, jakby miała zostać zapisana w chmurze lub wysłana na inne urządzenie. Kopie zapasowe wygenerowane dla dowolnego typu kopii zapasowej mogą znajdować się w sekcji Pliki kopii zapasowej w oknie narzędzi Projekt > Android.

Przywracanie danych aplikacji

Aby przywrócić dane aplikacji:

  1. Wdróż aplikację na połączonym urządzeniu. Aplikacja powinna mieć ten sam identyfikator co plik kopii zapasowej, który chcesz przywrócić na urządzeniu.
  2. Przejdź do jednej z tych czynności i kliknij ją:
    • W oknie Running Device (Uruchomione urządzenie) kliknij na pasku narzędzi Restore App Data (Przywróć dane aplikacji) i wybierz plik kopii zapasowej z historii ostatnich działań lub kliknij Browse (Przeglądaj).
    • Na głównym pasku menu kliknij Uruchom > Przywróć dane aplikacji.
    • Na karcie Eksplorator urządzenia > Procesy kliknij prawym przyciskiem myszy proces aplikacji i wybierz Przywróć dane aplikacji.
    • W oknie narzędziowym Project > Android kliknij prawym przyciskiem myszy kopię zapasową w węźle Backup Files i wybierz Restore App Data (Przywróć dane aplikacji).
  3. W razie potrzeby wybierz kopię zapasową z historii ostatnich zmian lub kliknij Przeglądaj, aby wybrać plik kopii zapasowej do przywrócenia z pamięci lokalnej.

Możesz też dołączyć plik kopii zapasowej do konfiguracji uruchomienia, aby wdrożenie aplikacji przywracało też dane aplikacji z pliku kopii zapasowej. Aby to zrobić:

  1. Na pasku menu głównego kliknij Uruchom > Edytuj konfiguracje.
  2. Wybierz konfigurację uruchomienia aplikacji i przejdź do opcji przywracania.
    Przywracanie opcji w konfiguracji uruchomienia
  3. Aby przywrócić aplikację z kopii zapasowej, zaznacz pole obok opcji Przywróć stan aplikacji.
  4. Wybierz plik kopii zapasowej z historii ostatnich kopii lub wyszukaj i wybierz plik kopii zapasowej z pamięci lokalnej.
  5. Jeśli chcesz przywrócić dane aplikacji tylko w przypadku nowej instalacji, zaznacz pole obok opcji Przywróć tylko w przypadku nowej instalacji APK. Ta opcja może być przydatna, jeśli wdrażasz aplikację na nowe urządzenie testowe i chcesz przywrócić dane, aby ułatwić debugowanie i rozwój aplikacji.
  6. Aby zapisać konfigurację uruchomienia, kliknij OK.
  7. Wdróż aplikację za pomocą konfiguracji uruchamiania, aby przetestować przywracanie danych aplikacji na połączonym urządzeniu.

Inspekcje Proguard

Android Studio zawiera teraz inspekcje, które zapobiegają tworzeniu nieprawidłowo sformułowanych reguł Proguard lub reguł uniemożliwiających optymalizacje R8. Zbyt ogólne reguły zachowywania, takie jak -keep class **.*, oraz konfiguracje reguł ProGuard dla konsumentów, takie jak dontshrink-dontoptimize, wywołują teraz ostrzeżenie w środowisku IDE Studio. Aby utworzyć dobrą regułę zachowywania, która umożliwia zmniejszanie kodu, ogranicz jej zakres do konkretnego pakietu i określ, co chcesz zachować.

Pliki AGENT.md z kontekstem na poziomie projektu

Możesz teraz uwzględniać w swoim projekcie pliki AGENT.md. Są to pliki Markdown, które zawierają instrukcje dotyczące projektu, reguły stylu kodowania i inne wskazówki dla Gemini.

Gemini automatycznie wykrywa i stosuje instrukcje z dowolnego pliku o nazwie AGENT.md w Twoim projekcie. Jeśli plik AGENT.md nie jest dostępny, Gemini szuka pliku GEMINI.md jako alternatywy.

Nowe ustawienie wyłączające automatyczną synchronizację

Android Studio oferuje teraz ustawienie, które umożliwia przełączenie z domyślnego trybu automatycznej synchronizacji (np. synchronizacja jest uruchamiana automatycznie po otwarciu projektu) na nowy tryb synchronizacji ręcznej z przypomnieniami. Domyślnym działaniem jest nadal automatyczna synchronizacja. Aby przełączyć się na synchronizację ręczną, otwórz Plik (Android Studio na macOS) > Ustawienia > Kompilacja, wykonanie, wdrażanie > Narzędzia do kompilacji i ustaw Tryb synchronizacji projektu na Synchronizacja ręczna z przypomnieniami.

Funkcje, które wyszły z Laboratorium Studio

Te eksperymentalne funkcje z Laboratorium Studio są stabilne od pakietu nowych funkcji Narwhal 3:

Pakiet nowych funkcji Android Studio Narwhal 4 | 2025.1.4

Oto nowe funkcje w Android Studio Narwhal 4 Feature Drop | 2025.1.4.

Aby dowiedzieć się, co zostało naprawione w tej wersji Androida Studio, zapoznaj się z zamkniętymi problemami.

Journeys w Android Studio

Journeys for Android Studio ułatwia pisanie i utrzymywanie testów kompleksowych, ponieważ umożliwia opisywanie kroków i asercji każdego testu (zwanego ścieżką) za pomocą języka naturalnego. Dzięki wykorzystaniu funkcji Gemini związanych z widzeniem i rozumowaniem kroki napisane w języku naturalnym są przekształcane w działania, które Gemini wykonuje w Twojej aplikacji. Dzięki temu tworzenie i rozumienie ścieżek jest łatwe. Możesz też pisać i opisywać bardziej złożone asercje, które Gemini ocenia na podstawie tego, co widzi na urządzeniu, aby określić, czy ścieżki użytkownika są zaliczone.

A ponieważ Gemini analizuje, jakie działania należy wykonać, aby osiągnąć cele, ścieżki są bardziej odporne na subtelne zmiany w układzie lub działaniu aplikacji, co skutkuje mniejszą liczbą niestabilnych testów podczas uruchamiania ich w różnych wersjach aplikacji i na różnych konfiguracjach urządzeń.

Twórz i uruchamiaj ścieżki bezpośrednio w Android Studio na dowolnym lokalnym lub zdalnym urządzeniu z Androidem. Środowisko IDE zapewnia nowy edytor do tworzenia ścieżek oraz wyniki z elementami rozszerzonymi, które pomagają lepiej śledzić rozumowanie Gemini i wykonywanie ścieżki.

Kopia zapasowa i synchronizacja

Możesz teraz tworzyć kopie zapasowe ustawień Androida Studio w pamięci w chmurze, używając konta Google lub JetBrains. Ułatwia to synchronizację ustawień, takich jak mapy klawiszy, ustawienia edytora kodu, ustawienia systemu i inne. Aby rozpocząć, wykonaj jedną z tych czynności:

  • Po otwarciu projektu w Android Studio zaloguj się na konto Google, klikając awatara w prawym górnym rogu IDE i wybierając Zaloguj się.

    1. Postępuj zgodnie z instrukcjami w wyświetlonym oknie i zaznacz pole, aby zezwolić Androidowi Studio na dostęp do miejsca na koncie Google.
    2. Postępuj zgodnie z instrukcjami, aby autoryzować Androida Studio.
  • Wybierz Ustawienia > Kopia zapasowa i synchronizacja.

    1. Wybierz Google, aby używać miejsca na koncie Google do synchronizowania danych aplikacji na różnych instalacjach Androida Studio. Możesz też użyć konta JetBrains, aby synchronizować dane aplikacji między instalacjami IntelliJ i Android Studio.
    2. Po wykonaniu instrukcji autoryzacji dostępu Android Studio do pamięci preferowanego konta wróć do Android Studio.
    3. Na stronie Ustawienia > Kopia zapasowa i synchronizacja możesz sprawdzić kategorie danych aplikacji, które chcesz synchronizować z kontem.
    4. Aby wyłączyć Kopię zapasową i synchronizację, odznacz pole, które włącza tę funkcję.

Jeśli na wybranym urządzeniu są już zsynchronizowane dane, Android Studio daje Ci możliwość pobrania ustawień z pamięci zdalnej (jest to opcja domyślna) lub przesłania ustawień lokalnych i zastąpienia ustawień zsynchronizowanych z pamięcią zdalną.

Sugerowane rozwiązania problemów z awariami

W pakiecie Meerkat w Android Studio udostępniliśmy statystyki Gemini dotyczące awarii zgłaszanych w narzędziu Statystyki dotyczące jakości aplikacji. Android Studio może teraz używać Gemini do analizowania danych o awariach wraz z kodem źródłowym, aby sugerować potencjalne poprawki. Po wybraniu awarii w oknie narzędzia Statystyki jakości aplikacji otwórz kartę Statystyki i kliknij Zaproponuj rozwiązanie po tym, jak Gemini wygeneruje statystyki dotyczące awarii. Następnie Gemini generuje sugerowane zmiany w kodzie, które możesz przejrzeć i zaakceptować na karcie różnic w edytorze.

Nowe ustawienie otwierania nowych projektów w widoku Projekt

Jest nowe ustawienie, które pozwala domyślnie otwierać nowe projekty w widoku Projekt. Aby włączyć to ustawienie, kliknij Plik (Android Studio na macOS) > Ustawienia > Ustawienia zaawansowane > Widok projektu i wybierz Ustaw widok projektu jako domyślny.

Narzędzie do testowania zrzutów ekranu podglądu w widoku tworzenia

Użyj narzędzia do testowania zrzutów ekranu podglądu kompozycji, aby testować interfejsy Compose i zapobiegać regresjom. Nowe narzędzie pomaga generować raporty HTML, które umożliwiają wizualne wykrywanie zmian w interfejsie aplikacji. Więcej informacji znajdziesz w artykule Podgląd kompozycji Testowanie zrzutów ekranu.

Ulepszenie drzewa komponentów w umieszczonym narzędziu Layout Inspector

Dzięki kilku kluczowym ulepszeniom interakcja z drzewem komponentów w inspektorze układu umieszczonego jest teraz bardziej intuicyjna i wydajna. Te aktualizacje mają na celu uproszczenie przepływu pracy i zapewnienie większej przejrzystości struktur interfejsu Compose.

  1. Przewijanie w poziomie: możesz teraz przewijać w poziomie w drzewie komponentów, co ułatwia poruszanie się po szerokich lub głęboko zagnieżdżonych układach i ich sprawdzanie bez utraty kontekstu.
  2. Automatyczne przewijanie po zaznaczeniu: zaznaczenie elementu w drzewie komponentów spowoduje automatyczne przewinięcie widoku w pionie i w poziomie, aby zaznaczony element był dobrze widoczny. Dzięki temu wybrany element będzie zawsze na pierwszym planie.
  3. Ulepszona wizualizacja relacji: udoskonaliliśmy linie pomocnicze w drzewie komponentów, aby zapewnić bardziej wyraźne wskazówki wizualne ułatwiające zrozumienie relacji między węzłami. Linie przerywane wyraźnie wskazują teraz relację stosu wywołań między węzłem nadrzędnym a podrzędnym, co ułatwia śledzenie połączeń programowych. Linie ciągłe nadal reprezentują wszystkie inne standardowe relacje nadrzędne i podrzędne w drzewie.

Te ulepszenia mają na celu zapewnienie płynniejszego i wydajniejszego debugowania, dzięki czemu możesz szybko zrozumieć i dopracować interfejs.

Drzewo komponentów w inspektorze układu osadzonego obsługuje teraz przewijanie w poziomie i automatyczne przewijanie po zaznaczeniu.
Ulepszenie drzewa komponentów w inspektorze układu wbudowanego

Używanie lokalnego modelu LLM

Pakiet nowych funkcji Android Studio Narwhal 4 umożliwia wybór modelu LLM, który będzie obsługiwać funkcje AI w IDE.

Okno czatu Gemini w Android Studio z selektorem modeli z opcjami Gemini i lokalnego LLM.
Selektor modeli w Android Studio.

LLM musi znajdować się na Twoim komputerze lokalnym, co jest korzystne, jeśli masz ograniczony dostęp do internetu lub ograniczenia dotyczące korzystania z modeli AI albo po prostu chcesz eksperymentować z modelami badawczymi typu open source.

Lokalny LLM stanowi alternatywę dla obsługi LLM wbudowanej w Androida Studio. Jednak Gemini w Android Studio zwykle zapewnia najlepsze wrażenia podczas tworzenia aplikacji na Androida, ponieważ jest dostosowany do tego systemu i obsługuje wszystkie funkcje Android Studio. W przypadku zadań związanych z programowaniem na Androida możesz wybierać spośród różnych modeli Gemini, w tym bezpłatnego modelu domyślnego lub modeli, do których dostęp uzyskasz za pomocą płatnego klucza interfejsu Gemini API.

Obsługa lokalnych dużych modeli językowych wymaga zainstalowania na komputerze lokalnym dostawcy dużych modeli językowych, takiego jak LM Studio lub Ollama, oraz wybranego przez Ciebie zgodnego modelu.

Asystent uaktualniania pakietu Android SDK obsługuje teraz Androida 16 / API 36

Do Asystenta uaktualniania pakietu Android SDK dodaliśmy migrację z Androida 15 / API 35 na Androida 16 / API 36. Aby uzyskać pomoc w migracji, kliknij Narzędzia > Asystent uaktualniania pakietu Android SDK.

Wtyczka Androida do obsługi Gradle w wersji 9.0

Wtyczka Androida do obsługi Gradle w wersji 9.0 to nowa wersja główna AGP, która wprowadza zmiany w interfejsie API i działaniu.

Aby zaktualizować wtyczkę Androida do obsługi Gradle do wersji 9.0.0-alpha02, użyj Asystenta uaktualniania wtyczki Androida do obsługi Gradle w Android Studio Narwhal 4 Feature Drop | 2025.1.4.

Asystent uaktualniania AGP pomaga zachować dotychczasowe zachowania podczas uaktualniania projektu, gdy jest to odpowiednie. Umożliwia to uaktualnienie projektu do AGP 9.0, nawet jeśli nie chcesz jeszcze stosować wszystkich nowych ustawień domyślnych w AGP 9.0.

Zgodność

Maksymalny poziom interfejsu API Androida obsługiwany przez wtyczkę Androida do Gradle w wersji 9.0.0-alpha02 to poziom 36.

Wtyczka Androida do obsługi Gradle w wersji 9.0.0-alpha02 wymaga Gradle w wersji 9.0.0.

Zmiany w działaniu

Wtyczka Androida do obsługi Gradle w wersji 9.0 ma te nowe funkcje:

Działanie Rekomendacja
Wtyczka Androida do obsługi Gradle w wersji 9.0 domyślnie używa NDK w wersji r28c. Rozważ wyraźne określenie wersji NDK, której chcesz używać.
Wtyczka Androida do obsługi Gradle w wersji 9.0 domyślnie wymaga, aby użytkownicy biblioteki używali tej samej lub nowszej wersji pakietu SDK do kompilacji. Podczas korzystania z biblioteki używaj tego samego lub wyższego pakietu SDK do kompilacji. Jeśli nie jest to możliwe lub chcesz dać użytkownikom biblioteki, którą publikujesz, więcej czasu na przejście na nową wersję, ustaw wartość AarMetadata.minCompileSdk.

AGP 9.0 zawiera aktualizacje domyślnych wartości tych właściwości Gradle. Dzięki temu możesz zachować działanie AGP 8.13 podczas uaktualniania:

Właściwość Funkcja Zmiana z AGP 8.13 na AGP 9.0 Rekomendacja
android.uniquePackageNames Wymaga, aby każda biblioteka miała inną nazwę pakietu. falsetrue Podaj unikalne nazwy pakietów dla wszystkich bibliotek w projekcie. Jeśli to niemożliwe, możesz wyłączyć tę flagę na czas migracji.
android.dependency.useConstraints Określa, czy między konfiguracjami mają być używane ograniczenia zależności.
W AGP 9.0 domyślnym ustawieniem jest false, które używa ograniczeń tylko w testach urządzeń aplikacji (AndroidTest). Ustawienie tej wartości na true przywróci działanie wersji 8.13.
truefalse Nie używaj ograniczeń zależności wszędzie, chyba że jest to konieczne. Zaakceptowanie nowego domyślnego ustawienia tej flagi umożliwia też optymalizacje w procesie importowania projektu, co powinno skrócić czas importowania kompilacji z wieloma podprojektami biblioteki Androida.
aandroid.enableAppCompileTimeRClass Kompiluj kod w aplikacjach z użyciem nieostatecznej klasy R, aby kompilacja aplikacji była zgodna z kompilacją biblioteki.
Zwiększa to przyrostowość i przygotowuje grunt pod przyszłe optymalizacje wydajności w przepływie przetwarzania zasobów.
falsetrue Wiele projektów może po prostu przyjąć nowe zachowanie bez wprowadzania zmian w kodzie źródłowym. Jeśli pola klasy R są używane w miejscach, które wymagają stałej, np. w przypadkach instrukcji switch, zmień kod, aby używać połączonych instrukcji if.
android.sdk.defaultTargetSdkToCompileSdkIfUnset Używa wersji pakietu SDK do kompilacji jako wartości domyślnej wersji pakietu SDK docelowego w aplikacjach i testach.
Przed tą zmianą docelowa wersja pakietu SDK była domyślnie ustawiana na minimalną wersję pakietu SDK.
falsetrue Określ bezpośrednio docelową wersję pakietu SDK dla aplikacji i testów.
android.onlyEnableUnitTestForTheTestedBuildType Tworzy tylko komponenty testów jednostkowych dla testowanego typu kompilacji.
W projekcie domyślnym powoduje to utworzenie jednego testu jednostkowego do debugowania, podczas gdy wcześniej testy jednostkowe były uruchamiane do debugowania lub wydania.
falsetrue Jeśli Twój projekt nie wymaga uruchamiania testów w przypadku wersji debugowania i wersji do publikacji, nie musisz wprowadzać żadnych zmian.
android.proguard.failOnMissingFiles W przypadku braku na dysku któregokolwiek z plików do zachowania określonych w DSL AGP kompilacja zakończy się niepowodzeniem i wyświetli błąd. Przed tą zmianą literówki w nazwach plików powodowały, że pliki były cicho ignorowane. falsetrue Usuń wszystkie nieprawidłowe deklaracje plików ProGuard
android.r8.optimizedResourceShrinking Umożliwia R8 zachowanie mniejszej liczby zasobów Androida, ponieważ uwzględnia klasy i zasoby Androida razem. falsetrue Jeśli reguły przechowywania w projekcie są już kompletne, nie musisz wprowadzać żadnych zmian.
android.r8.strictFullModeForKeepRules Umożliwia R8 zachowanie mniejszej liczby elementów, ponieważ nie zachowuje domyślnego konstruktora, gdy klasa jest zachowywana. Oznacza to, że -keep class A nie implikuje już -keep class A { <init>(); }
falsetrue Jeśli reguły przechowywania w projekcie są już kompletne, nie musisz wprowadzać żadnych zmian.

Zastąp -keep class A w regułach przechowywania projektu wartością -keep class A { <init>(); } we wszystkich przypadkach, w których chcesz zachować domyślny konstruktor.
android.defaults.buildfeatures.shaders Umożliwia kompilację shaderów we wszystkich podprojektach. truefalse Włącz kompilację shaderów tylko w podprojektach, które zawierają shadery do skompilowania. W tym celu ustaw w plikach kompilacji Gradle tych projektów te wartości:
android {
  buildFeatures {
    shaders = true
  }
}

Usunięte funkcje

Wtyczka Androida do obsługi Gradle w wersji 9.0 usuwa te funkcje:

Zmieniony DSL

Wtyczka Androida do obsługi Gradle w wersji 9.0 zawiera te zmiany powodujące niezgodność w języku DSL:

Usunięto DSL

Wtyczka Androida do obsługi Gradle w wersji 9.0 usuwa:

Usunięte właściwości Gradle

Poniższe właściwości Gradle zostały początkowo dodane jako sposoby globalnego wyłączania funkcji, które były domyślnie włączone.

Te funkcje są domyślnie wyłączone od wersji AGP 8.0 lub starszej. Włącz te funkcje tylko w podprojektach, które z nich korzystają, aby usprawnić kompilację.

Właściwość Funkcja Wymiana
android.defaults.buildfeatures.aidl Umożliwia kompilację AIDL we wszystkich podprojektach. Włącz kompilację AIDL tylko w podprojektach, w których znajdują się źródła AIDL, ustawiając w plikach kompilacji Gradle tych projektów tę właściwość:
android {
  buildFeatures {
    aidl = true
  }
}
w pliku kompilacji Gradle każdego podprojektu zawierającego źródła AIDL
android.defaults.buildfeatures.renderscript Włącza kompilację RenderScript we wszystkich podprojektach. Włącz kompilację RenderScriptu tylko w podprojektach, w których znajdują się źródła RenderScriptu, ustawiając w plikach kompilacji Gradle tych projektów tę właściwość:
android {
  buildFeatures {
    renderScript = true
  }
}

Usunięte interfejsy API

Wtyczka Androida do obsługi Gradle w wersji 9.0 usuwa:

  • Wycofane i wyłączone interfejsy APIBaseExtension.registerTransform, które były dostępne tylko po to, aby umożliwić kompilowanie pod kątem najnowszej wersji AGP przy jednoczesnym kierowaniu na AGP 4.2 lub starszą.

Wymuszane właściwości Gradle

AGP 9.0 zgłasza błąd, jeśli ustawisz te właściwości Gradle.

Asystent uaktualniania wtyczki Androida do obsługi Gradle nie uaktualni projektów do wersji 9.0 wtyczki AGP, jeśli używają one tych właściwości.

Właściwość Funkcja
android.r8.integratedResourceShrinking Zmniejszanie zasobów jest teraz zawsze przeprowadzane w ramach R8, a poprzednia implementacja została usunięta.