Tworzenie urządzeń wirtualnych i zarządzanie nimi

Wirtualne urządzenie z Androidem (AVD) to konfiguracja, która określa charakterystykę telefonu, tabletu, zegarka z Wear OS, urządzenia z Androidem TV lub urządzenia z systemem operacyjnym Android Automotive, które chcesz symulować w emulatorze Androida. Menedżer urządzeń to narzędzie, które możesz uruchomić z 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 More Actions (Więcej działań) > Virtual Device Manager (Menedżer urządzeń wirtualnych).

• Po otwarciu projektu wybierz View (Widok) > Tool Windows (Okna narzędzi) > Device Manager (Menedżer urządzeń) na głównym pasku menu, 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 zautomatyzowanych testów z instrumentacją w skalowalny i samodzielny sposób, rozważ użycie urządzeń zarządzanych przez Gradle.

Informacje o średnim czasie oglądania

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 może być obsługiwany przez aplikację na podstawie ustawienia <uses-sdk> w pliku manifestu.

Profil sprzętu

Profil sprzętu określa charakterystykę urządzenia w momencie wysyłki z fabryki. Menedżer urządzeń jest wstępnie załadowany z określonymi profilami sprzętowymi, takimi jak urządzenia Pixel. Możesz definiować lub dostosowywać profile sprzętowe w zależności od potrzeb.

Definicja urządzenia oznaczona logo Google Play w kolumnie Sklep Play obejmuje aplikację Sklep Google Play i dostęp do Usług Google Play, w tym kartę Google Play w oknie Rozszerzone ustawienia, która zawiera wygodny przycisk do aktualizowania Usług Google Play na urządzeniu.

Urządzenia z tym logo i typem „Telefon” są również zgodne z CTS i mogą używać obrazów systemu, które zawierają aplikację Sklep Play.

Obrazy systemu

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

Na karcie Rekomendowane znajdują się rekomendowane obrazy systemu. Na pozostałych kartach znajdziesz pełniejszą listę. W panelu po prawej stronie znajduje się opis wybranego obrazu systemu.

Jeśli obok obrazu systemu widzisz ikonę pobierania, oznacza to, że obraz nie jest obecnie zainstalowany na komputerze deweloperskim. 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ę, co jest określone w atrybucie minSdk w pliku manifestu aplikacji. Więcej informacji o zależności między poziomem interfejsu API systemu a minSdk znajdziesz w artykule Wersjonowanie 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 dodatkowego dla platformy AVD, np. dodatek Google API zawiera bibliotekę Map Google.

Aby zapewnić bezpieczeństwo aplikacji i spójność działania z urządzeniami fizycznymi, obrazy systemu z wbudowanym Sklepem Google Play są podpisywane kluczem wersji, co oznacza, że nie można uzyskać podwyższonych uprawnień (root) w przypadku tych obrazów.

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 uprawnieniami normalnymi i podwyższonymi:

  % 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 na komputerze deweloperskim wydzielony obszar pamięci. 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 wyczyścić dane użytkownika, dzięki czemu urządzenie będzie zawierać te same dane co nowe.

Skóra

Skórka emulatora określa wygląd urządzenia. Menedżer urządzeń udostępnia kilka predefiniowanych skórek. Możesz też zdefiniować własne lub użyć skórek dostarczonych przez osoby trzecie.

Funkcje AVD i aplikacji

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

Tworzenie AVD

Aby utworzyć nowe urządzenie AVD:

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

   Pojawi się okno Wybierz sprzęt.

   

   Zwróć uwagę, że tylko niektóre profile sprzętowe zawierają Sklep Play. Te profile są w pełni zgodne z CTS i mogą korzystać z obrazów systemu, które zawierają aplikację Sklep Play.

3. Wybierz profil sprzętowy, a następnie kliknij Dalej.

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

   Pojawi się okno Obraz systemu.

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

Pojawi się okno Weryfikacja konfiguracji.


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

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

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

Aby utworzyć AVD na podstawie kopii:

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

   Pojawi się okno Weryfikacja konfiguracji.

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

   AVD pojawi się na karcie Wirtualne w Menedżerze urządzeń.

Tworzenie profilu sprzętu

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

Nowy profil sprzętu możesz zdefiniować od początku lub skopiować istniejący profil i użyć go jako punktu wyjścia. Wstępnie załadowanych profili sprzętowych nie można edytować.

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

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

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

   
3. Kliknij Zakończ.

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

Aby utworzyć profil sprzętu, używając kopii jako punktu wyjścia:

1. W oknie Wybierz sprzęt wybierz profil sprzętu i kliknij Sklonuj urządzenie lub kliknij prawym przyciskiem myszy profil sprzętu i wybierz Sklonuj.

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

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

Edytowanie istniejących AVD

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

• 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 przesyłanych do zespołu Android Studio, kliknij Menu i wybierz Wyświetl szczegóły.

Edytowanie dotychczasowych profili sprzętowych

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

• Aby edytować profil sprzętu, wybierz go i kliknij Edytuj urządzenie. Możesz też kliknąć prawym przyciskiem myszy profil sprzętu 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 Wirtualne możesz wykonywać na emulatorze te działania:

• Aby uruchomić emulator korzystający z AVD, kliknij Uruchom .
• Aby zatrzymać działający emulator, kliknij Menu i wybierz Zatrzymaj.
• Aby wyczyścić dane emulatora, kliknij Menu i wybierz Wyczyść dane.

Importowanie i eksportowanie profili sprzętowych

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

• Aby zaimportować profil sprzętu, kliknij Importuj profile sprzętu i wybierz na komputerze plik XML zawierający definicję.
• Aby wyeksportować profil sprzętu, kliknij go prawym przyciskiem myszy i wybierz Eksportuj. Określ miejsce, w którym 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 Sprawdź konfigurację możesz określić te właściwości konfiguracji AVD: Właściwości oznaczone jako (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ą oba te rodzaje właściwości.

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

Właściwości profilu sprzętu

W oknie Konfigurowanie profilu sprzętu możesz określić te właściwości profili sprzętu: 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ą oba te rodzaje właściwości.

Wstępnie zdefiniowane profile sprzętowe dołączone do Menedżera urządzeń nie są edytowalne. Możesz jednak skopiować profile i edytować kopie.

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

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

Tworzenie skórki emulatora

Skórka emulatora Androida to zbiór plików, które określają 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ę niestandardową, a potem zastosować ją w AVD.

Każda skórka emulatora zawiera:

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

Aby utworzyć i używać niestandardowego wyglądu:

1. Utwórz katalog, w którym możesz zapisywać pliki konfiguracji skórek.
2. Określ wygląd skórki w pliku tekstowym o nazwie layout. Ten plik określa wiele cech skórki, takich jak rozmiar i komponenty z obrazem dla poszczególnych przycisków. Na 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 pliki bitmapowe obrazów urządzeń do tego samego katalogu.
4. W pliku INI określ dodatkowe konfiguracje urządzenia, takie jak hw.keyboard i hw.lcd.density.
5. Skompresuj pliki w folderze motywu i wybierz plik archiwum jako motyw niestandardowy.

Szczegółowe informacje o tworzeniu skórek emulatora znajdziesz w  specyfikacji plików skórek emulatora Androida w kodzie źródłowym narzędzi.