Pakiet nowych funkcji Android Studio Narwhal 3 | 2025.1.3

Android Studio to oficjalne zintegrowane środowisko programistyczne do tworzenia aplikacji na Androida, które zawiera wszystko, czego potrzebujesz do tego celu.

Ta strona zawiera listę nowych funkcji i ulepszeń w najnowszej wersji w kanale stabilnym, czyli pakiecie nowych funkcji Android Studio Narwhal 3. Możesz pobrać go tutaj lub zaktualizować go w Android Studio, klikając Pomoc > Sprawdź dostępność aktualizacji (Android Studio > Sprawdź dostępność aktualizacji na macOS).

Jest to stabilna wersja Androida Studio. Pamiętaj, że poprawki mogą zawierać nowe, drobne funkcje i poprawki błędów. Aby dowiedzieć się więcej o nazwach wersji Android Studio, zapoznaj się z artykułem Nazwy wersji Android Studio.

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

Informacje o wersjach starszych znajdziesz w sekcji Poprzednie wersje.

Aby uzyskać wcześniejszy dostęp do nadchodzących funkcji i ulepszeń, zapoznaj się z wersjami podglądowymi Androida Studio.

Jeśli napotkasz problemy w Android Studio, sprawdź stronę Znane problemy lub Rozwiązywanie problemów.

Zgodność wtyczki Androida do obsługi Gradle i Androida Studio

System kompilacji Androida Studio jest oparty na Gradle, a wtyczka Androida do obsługi Gradle (AGP) dodaje kilka funkcji, które są specyficzne dla kompilowania aplikacji na Androida. W tabeli poniżej znajdziesz informacje o tym, która wersja AGP jest wymagana w przypadku poszczególnych wersji Androida Studio.

Wersja Android Studio Wymagana wersja AGP
Pakiet nowych funkcji Narwhal 3 | 2025.1.3 4,0–8,13
Pakiet nowych funkcji Narwhal | 2025.1.2 4,0–8,12
Narwhal | 2025.1.1 3.2-8.11
Pakiet nowych funkcji Meerkat | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3,2–8,9
Pakiet nowych funkcji Ladybug | 2024.2.2 3,2–8,8
Ladybug | 2024.2.1 3,2–8,7
Pakiet nowych funkcji Koala | 2024.1.2 3,2–8,6
Koala | 2024.1.1 3,2–8,5
Jellyfish | 2023.3.1 3,2–8,4
Iguana | 2023.2.1 3,2–8,3
Jeż | 2023.1.1 3.2-8.2
Żyrafa | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3,2–8,0

Starsze wersje

Wersja Android Studio Wymagana wersja AGP
Electric Eel | 2022.1.1 3,2–7,4
Dolphin | 2021.3.1 3,2–7,3
Chipmunk | 2021.2.1 3,2–7,2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3,1–7,0

Informacje o nowościach we wtyczce Androida do obsługi Gradle znajdziesz w informacjach o wersji wtyczki Androida do obsługi Gradle.

Minimalne wersje narzędzi dla poziomu interfejsu API Androida

Istnieją minimalne wersje Androida Studio i AGP, które obsługują określony poziom API. Używanie starszych wersji Androida Studio lub AGP niż wymagane przez targetSdk lub compileSdk projektu może prowadzić do nieoczekiwanych problemów. Do pracy nad projektami, które są przeznaczone dla wersji przedpremierowych systemu operacyjnego Android, zalecamy używanie najnowszej wersji przedpremierowej Androida Studio i AGP. Możesz zainstalować wersje podglądowe Androida Studio obok wersji stabilnej.

Minimalne wersje Android Studio i AGP są następujące:

Poziom interfejsu API Minimalna wersja Android Studio Minimalna wersja AGP
36,0 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Pakiet nowych funkcji Koala | 2024.2.1 8.6.0
34 Jeż | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2

Zgodność Androida Studio z usługami w chmurze

Android Studio zawiera integracje usług, które pomagają Tobie i Twojemu zespołowi szybciej tworzyć, publikować i utrzymywać aplikacje na Androida. Dotyczy to usług w chmurze, takich jak Gemini w Android Studio, Statystyki Play i Firebase Crashlytics. Usługi w chmurze są dostępne tylko w najnowszej stabilnej wersji Androida Studio, w 3 ostatnich poprzednich wersjach głównych i w poprawkach powiązanych z tymi wersjami. Jeśli wersja wykracza poza to okno zgodności, integracje usług zostaną wyłączone i konieczne będzie zaktualizowanie Androida Studio.

Wersje Android Studio, które są obecnie zgodne z usługami w chmurze

Od momentu udostępnienia wersji stabilnej pakietu Meerkat w Android Studio wszystkie wersje Studio są zgodne z usługami w chmurze. Egzekwowanie zasad rozpocznie się wraz z pakietem nowych funkcji Android Studio Narwhal.

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
Interfejs przekształcania Używaj języka naturalnego, aby aktualizować interfejs aplikacji bezpośrednio w panelu podglądu Compose. Interfejs przekształcania

Oto nowe funkcje w pakiecie nowych funkcji Android Studio Narwhal 3.

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.

Pakiet nowych funkcji Android Studio Narwhal 3 umożliwia generowanie 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.

Obraz w załączniku w Gemini

Teraz możesz dołączać pliki graficzne i podawać dodatkowe informacje wraz z promptem. Możesz na przykład dołączyć makiety interfejsu lub zrzuty ekranu, aby przekazać Gemini kontekst dotyczący układu aplikacji. Dzięki temu Gemini może generować kod Compose na podstawie podanego obrazu lub wyjaśniać komponenty i przepływ danych na zrzucie ekranu interfejsu. Więcej informacji znajdziesz w artykule Dołączanie obrazu do zapytania.

Okno Gemini z załącznikami w postaci obrazów
Generowanie załączników z obrazami i podglądów za pomocą Gemini w Android Studio

@Kontekst pliku w Gemini

Możesz teraz załączać pliki projektu jako kontekst w interakcjach na czacie z Gemini w Android Studio. Dzięki temu możesz szybko odwoływać się do plików w promptach dla Gemini. W oknie czatu Gemini wpisz @, aby wyświetlić menu uzupełniania plików, i wybierz pliki do załączenia. Możesz też kliknąć menu Kontekst, aby sprawdzić, które pliki zostały automatycznie załączone przez Gemini. Dzięki temu zyskasz większą kontrolę nad kontekstem wysyłanym do Gemini. Więcej informacji znajdziesz w artykule Dołączanie pliku do zapytania.

@Kontekst pliku w Gemini
@Kontekst pliku w Gemini