Tworzenie urządzeń wirtualnych i zarządzanie nimi

Wirtualne urządzenie Android (AVD) to konfiguracja, która definiuje cechy telefonu, tabletu, Wear OS, Androida TV lub urządzenia z systemem Automotive OS, które chcesz symulować w emulatorze Androida. Menedżer urządzeń to narzędzie, które możesz uruchomić w Android Studio. Pomaga ono tworzyć urządzenia wirtualne z Androidem i nimi zarządzać.

Aby otworzyć nowy Menedżer urządzeń, wykonaj jedną z tych czynności:

• Na ekranie powitalnym Android Studio wybierz Więcej działań > Menedżer urządzeń wirtualnych.

• Po otwarciu projektu na głównym pasku menu wybierz Widok > Okna narzędzia > Menedżer urządzeń, a następnie kliknij + i Utwórz urządzenie wirtualne.

Po utworzeniu urządzeń zobaczysz listę wszystkich urządzeń w panelu menedżera urządzeń.

Jeśli chcesz używać urządzeń wirtualnych do uruchamiania automatycznych testów z instrumentacją w skalowalny i samodzielny sposób, rozważ użycie urządzeń zarządzanych przez Gradle.

Informacje o AVD

AVD zawiera profil sprzętowy, obraz systemu, obszar pamięci, skórkę i inne właściwości.

Zalecamy utworzenie AVD dla każdego obrazu systemu, który Twoja aplikacja może obsługiwać na podstawie ustawienia <uses-sdk> w pliku manifestu.

Profil sprzętowy

Profil sprzętowy określa właściwości urządzenia w wersji fabrycznej. Menedżer urządzeń jest wstępnie załadowany określonymi profilami sprzętowymi, takimi jak urządzenia Pixel. W razie potrzeby możesz definiować lub dostosowywać profile sprzętowe.

Definicja urządzenia z logo Google Play w kolumnie Sklep Play obejmuje aplikację Sklep Play oraz dostęp do usług Google Play, w tym kartę Google Play w oknie Rozszerzone ustawienia, która zawiera przycisk umożliwiający wygodne aktualizowanie usług Google Play na urządzeniu.

Urządzenia z tym logo i typu „Telefon” są też zgodne z CTS i mogą używać obrazów systemowych, które obejmują aplikację Sklep Play.

Obrazy systemu

Obraz systemu oznaczony etykietą Interfejsy API Google zapewnia dostęp do usług Google Play.

Na karcie Rekomendowane znajduje się lista rekomendowanych obrazów systemowych. Pozostałe karty zawierają bardziej kompletną listę. W panelu po prawej stronie znajdziesz opis wybranego obrazu systemu.

Jeśli obok obrazu systemu widzisz ikonę pobierania, oznacza to, że obraz nie jest obecnie zainstalowany na komputerze programisty. Kliknij ikonę, aby pobrać obraz systemu. Aby pobrać obrazy systemu, musisz mieć połączenie z internetem.

Poziom interfejsu API urządzenia docelowego jest ważny, ponieważ aplikacja nie działa na obrazie systemu z poziomem interfejsu API niższym niż wymagany przez aplikację, zgodnie z informacjami w atribute minSdk w pliku manifestu aplikacji. Więcej informacji o zależności między poziomem interfejsu API systemu a minSdk znajdziesz w artykule Aktualizowanie aplikacji.

Jeśli aplikacja deklaruje element <uses-library> w pliku manifestu, wymaga obrazu systemu, który zawiera tę bibliotekę zewnętrzną. Aby uruchomić aplikację na emulatorze, utwórz AVD, który zawiera wymaganą bibliotekę. W tym celu może być konieczne użycie komponentu dodatku do platformy AVD. Na przykład dodatek interfejsów API Google zawiera bibliotekę Map Google.

Aby zapewnić bezpieczeństwo aplikacji i spójność na urządzeniach fizycznych, obrazy systemów z wbudowanym Sklepem Google Play są podpisywane kluczem wersji, co oznacza, że nie można uzyskać rozszerzonych uprawnień (root) w tych obrazach.

Jeśli do rozwiązywania problemów z aplikacją potrzebujesz podwyższonych uprawnień (root), możesz użyć obrazów systemu Android Open Source Project (AOSP), które nie zawierają aplikacji ani usług Google. Następnie możesz użyć poleceń adb root i adb unroot, aby przełączać się między zwykłymi a podwyższonymi uprawnieniami:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

Miejsce na dane

AVD ma dedykowane miejsce na dane na Twoim komputerze deweloperskim. przechowuje dane użytkownika urządzenia, takie jak zainstalowane aplikacje i ustawienia, a także emulowaną kartę SD. W razie potrzeby możesz użyć Menedżera urządzeń, aby wymazać dane użytkownika, tak aby urządzenie miało te same dane, co nowe.

Skóra

Skórka do emulatora określa wygląd urządzenia. Menedżer urządzeń udostępnia kilka wstępnie zdefiniowanych motywów. Możesz też zdefiniować własne skórki lub używać skórek udostępnianych przez osoby trzecie.

AVD i funkcje aplikacji

Upewnij się, że definicja AVD zawiera funkcje urządzenia, od których zależy Twoja aplikacja. W sekcji Właściwości profilu sprzętowego i Właściwości AVD znajdziesz listy funkcji, które możesz zdefiniować w AVD.

Tworzenie AVD

Aby utworzyć nowy AVD:

1. Otwórz Menedżera urządzeń.
2. Kliknij Utwórz urządzenie.

   Pojawi się okno Wybieranie sprzętu.

   

   Pamiętaj, że tylko niektóre profile sprzętu obejmują Play Store. Te profile są w pełni zgodne z pakietem CTS i mogą używać obrazów systemowych, które zawierają aplikację Sklep Play.

3. Wybierz profil sprzętowy, a potem kliknij Dalej.

   Jeśli nie widzisz odpowiedniego profilu sprzętowego, możesz go utworzyć lub zaimportować zgodnie z opisem w innych sekcjach tej strony.

   Pojawi się okno Obraz systemu.

   
4. Wybierz obraz systemu dla konkretnego poziomu interfejsu API, a następnie kliknij Dalej.

Pojawi się okno Sprawdzanie konfiguracji.


5. W razie potrzeby zmień właściwości AVD, a następnie kliknij Zakończ.

   Kliknij Pokaż ustawienia zaawansowane, aby wyświetlić więcej ustawień, np. skórę.

Nowy AVD pojawi się na karcie Wirtualne w Menedżerze urządzeń oraz w menu urządzenia docelowego.

Aby utworzyć AVD, zaczynając od kopii:

1. Na karcie Wirtualne w Menedżerze urządzeń kliknij Menu i wybierz Duplikuj.

   Pojawi się okno Sprawdzanie konfiguracji.

2. Jeśli chcesz wprowadzić zmiany w oknie Obraz systemu lub Wybierz sprzęt, kliknij Wstecz.
3. Wprowadź zmiany i kliknij Zakończ.

   AVD jest widoczne na karcie Wirtualne w Menedżerze urządzeń.

Tworzenie profilu sprzętowego

Menedżer urządzeń udostępnia wstępnie zdefiniowane profile sprzętowe dla popularnych urządzeń, dzięki czemu możesz je łatwo dodawać do definicji AVD. Jeśli chcesz zdefiniować inne urządzenie, możesz utworzyć nowy profil sprzętowy.

Możesz zdefiniować nowy profil sprzętu od początku lub skopiować profil sprzętu jako punkt wyjścia. Wstępnie załadowanych profili sprzętowych nie można edytować.

Aby utworzyć nowy profil sprzętowy od początku:

1. W oknie Wybierz sprzęt kliknij Nowy profil sprzętowy.

2. W oknie Konfigurowanie profilu sprzętowego zmień w razie potrzeby właściwości profilu sprzętowego.

   
3. Kliknij Zakończ.

   Nowy profil sprzętowy pojawi się w oknie Wybierz sprzęt. Możesz utworzyć AVD, które używa profilu sprzętowego, klikając Dalej lub Anuluj, aby wrócić do karty Wirtualne lub do menu urządzenia docelowego.

Aby utworzyć profil sprzętowy, korzystając z kopii jako punktu wyjścia:

1. W oknie Wybierz sprzęt wybierz profil sprzętowy i kliknij Klonuj urządzenie lub kliknij prawym przyciskiem profil sprzętowy i wybierz Klonuj.

2. W oknie Konfigurowanie profilu sprzętowego zmień w razie potrzeby właściwości profilu sprzętowego.
3. Kliknij Zakończ.

Nowy profil sprzętowy pojawi się w oknie Wybierz sprzęt. Możesz utworzyć AVD, które używa profilu sprzętowego, klikając Dalej lub Anuluj, aby wrócić do karty Wirtualne lub do menu urządzenia docelowego.

Edytowanie dotychczasowych AVD

Na karcie Wirtualne w Menedżerze urządzeń możesz wykonywać te operacje na urządzeniu AVD:

• Aby edytować AVD, kliknij Edytuj ten AVD i wprowadź zmiany.
• Aby usunąć AVD, kliknij Menu i wybierz Usuń.
• Aby wyświetlić powiązane pliki INI i IMG AVD na dysku, kliknij Menu i wybierz Pokaż na dysku.
• Aby wyświetlić szczegóły konfiguracji AVD, które możesz uwzględnić w raportach o błędach wysyłanych do zespołu Android Studio, kliknij Menu i wybierz Wyświetl szczegóły.

Edytowanie istniejących profili sprzętowych

Nie możesz edytować ani usuwać wstępnie załadowanych profili sprzętowych, ale w oknie Wybierz sprzęt możesz wykonać te czynności dotyczące innych profili sprzętowych:

• Aby edytować profil sprzętowy, wybierz go i kliknij Edytuj urządzenie. Możesz też kliknąć profil sprzętowy prawym przyciskiem myszy i wybrać Edytuj. Następnie wprowadź zmiany.
• Aby usunąć profil sprzętowy, kliknij go prawym przyciskiem myszy i wybierz Usuń.

Uruchamianie i zatrzymywanie emulatora oraz czyszczenie danych

Na karcie Wirtualny możesz wykonywać te operacje na emulatorze:

• Aby uruchomić emulator, który korzysta z AVD, kliknij Uruchom .
• Aby zatrzymać uruchomiony emulator, kliknij Menu i wybierz Zatrzymaj.
• Aby wyczyścić dane w emulatorze, kliknij Menu i wybierz Wymaż dane.

Importowanie i eksportowanie profili sprzętowych

W oknie Wybieranie sprzętu możesz importować i eksportować profile sprzętu w ten sposób:

• Aby zaimportować profil sprzętowy, kliknij Importuj profile sprzętowe i wybierz na komputerze plik XML zawierający definicję.
• Aby wyeksportować profil sprzętowy, kliknij go prawym przyciskiem myszy i wybierz Eksportuj. Określ lokalizację, w której chcesz zapisać plik XML zawierający definicję.

Właściwości AVD

Konfiguracja AVD określa interakcję między komputerem deweloperskim a emulatorem, a także właściwości, które chcesz zastąpić w profilu sprzętowym. W oknie Sprawdzanie konfiguracji możesz określić te właściwości konfiguracji AVD: Usługi opisane etykietą (Zaawansowane) są wyświetlane tylko wtedy, gdy klikniesz Pokaż ustawienia zaawansowane.

Właściwości konfiguracji AVD zastępują właściwości profilu sprzętowego, a właściwości emulatora ustawione podczas jego działania zastępują obie te właściwości.

Tabela 1. Właściwości konfiguracji AVD

Właściwości profilu sprzętu

W oknie Konfigurowanie profilu sprzętowego możesz określić te właściwości profili sprzętowych: Właściwości konfiguracji AVD zastępują właściwości profilu sprzętowego, a właściwości emulatora, które ustawisz podczas jego działania, zastępują obie te właściwości.

Wstępnie zdefiniowane profile sprzętowe dostępne w Menedżerze urządzeń nie można edytować. Możesz jednak skopiować profile i zmodyfikować ich kopie.

Niektóre właściwości są wyłączone w przypadku niektórych typów urządzeń. Na przykład właściwość „Round” (Półokrągła) jest dostępna tylko na urządzeniach z Wear OS.

Tabela 2. Właściwości konfiguracji profilu sprzętowego

Tworzenie skórki emulatora

Skórka do emulatora Androida to zbiór plików, które definiują elementy wizualne i sterujące wyświetlacza emulatora. Jeśli definicje skórek dostępne w ustawieniach AVD nie spełniają Twoich wymagań, możesz utworzyć własną definicję skórki niestandardowej i zastosować ją do AVD.

Każda skórka emulatora zawiera:

• Plik hardware.ini
• Pliki układu dla obsługiwanych orientacji i konfiguracji fizycznych
• Pliki graficzne elementów wyświetlanych na ekranie, takich jak tło, klawisze i przyciski

Aby utworzyć skórkę niestandardową i z niej korzystać:

1. Utwórz katalog, w którym będziesz zapisywać pliki konfiguracji skórki.
2. Określ wizualny wygląd skórki w pliku tekstowym o nazwie layout. Ten plik definiuje wiele cech skórki, takich jak rozmiar i zasoby obrazów konkretnych przycisków. Przykład:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. Dodaj do tego samego katalogu pliki bitmapowe obrazów urządzenia.
4. W pliku INI określ dodatkowe konfiguracje urządzeń na potrzeby ustawień sprzętowych, takie jak hw.keyboard i hw.lcd.density.
5. Zarchiwizuj pliki w folderze skórki i wybierz plik archiwum jako skórkę niestandardową.

Więcej informacji o tworzeniu skórek emulatora znajdziesz w  specyfikacji pliku skórki emulatora Androida w źródłowym kodzie narzędzi.