Urządzenie wirtualne z Androidem (AVD) to konfiguracja określająca cechy telefonu, tabletu z Androidem, Wear OS, Androida TV lub 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 uruchamiać automatyczne testy z użyciem urządzeń wirtualnych 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 średniego harmonogramu dla każdego obrazu systemu, który może obsługiwać Twoja aplikacja 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 z pewnymi profilami sprzętowymi, takimi jak profile urządzeń Pixel. W razie potrzeby możesz je zdefiniować lub dostosować.
Definicja urządzenia oznaczona logo Google Play w kolumnie Sklep Play obejmuje zarówno aplikację Sklep Google Play, jak i dostęp do Usług Google Play, w tym kartę Google Play w oknie Rozszerzone elementy sterujące, która zawiera wygodny przycisk do aktualizowania 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 zawierają aplikację Sklep Play.
Obrazy systemu
Obraz systemu oznaczony etykietą interfejsów API Google zapewnia dostęp do Usług Google Play.
Na karcie Zalecane znajdziesz listę zalecanych 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 ten obraz nie jest obecnie zainstalowany na komputerze, na którym pracujesz. 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 z obrazem systemu z poziomem interfejsu API niższym niż wymagany przez aplikację, zgodnie z atrybutem
minSdk w pliku manifestu aplikacji. Więcej informacji o związku między poziomem interfejsu API systemu a minSdk znajdziesz w artykule o wersji 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ą podpisane kluczem wersji, co oznacza, że nie można uzyskać rozszerzonych uprawnień (root) za pomocą tych obrazów.
Jeśli do rozwiązywania problemów z aplikacjami potrzebujesz podwyższonych uprawnień (root), możesz użyć obrazów systemowych Android Open Source Project (AOSP), które nie obejmują 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 obejmuje funkcje urządzenia, od których zależy Twoja aplikacja. W sekcji dotyczącej 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:
- Otwórz Menedżera urządzeń.
- Kliknij Utwórz urządzenie.
Pojawi się okno Wybieranie sprzętu.
Zwróć uwagę, że tylko niektóre profile sprzętu zawierają Sklep Play. Te profile są w pełni zgodne z pakietem CTS i mogą używać obrazów systemowych, które zawierają aplikację Sklep Play.
- Wybierz profil sprzętu i 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.
- Wybierz obraz systemu dla konkretnego poziomu interfejsu API, a następnie kliknij Dalej.
- 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ę.
Pojawi się okno Sprawdzanie konfiguracji.
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:
- Na karcie Wirtualne w Menedżerze urządzeń kliknij Menu
i wybierz Duplikuj.
Pojawi się okno Sprawdzanie konfiguracji.
- Jeśli chcesz wprowadzić zmiany w oknie Obraz systemu lub Wybierz sprzęt, kliknij Wstecz.
- 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. Nie można edytować wstępnie załadowanych profili sprzętowych.
Aby utworzyć nowy profil sprzętowy od początku:
- W oknie Wybierz sprzęt kliknij Nowy profil sprzętowy.
W oknie Skonfiguruj profil sprzętu zmień właściwości profilu sprzętu zgodnie z potrzebami.
- 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:
- W oknie Wybierz sprzęt wybierz profil sprzętowy i kliknij Klonuj urządzenie lub kliknij prawym przyciskiem profil sprzętowy i wybierz Klonuj.
- W oknie Konfigurowanie profilu sprzętowego zmień w razie potrzeby właściwości profilu sprzętowego.
- 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 używający 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ść AVD | Opis |
|---|---|
| Nazwa AVD | Wpisz nazwę AVD. Nazwa może zawierać wielkie lub małe litery, cyfry, kropki, podkreślenia, nawiasy, myślniki i spacje. Nazwa pliku przechowującego konfigurację AVD jest pochodną nazwy AVD. |
| Identyfikator AVD (zaawansowane) | Wyświetl identyfikator AVD. Identyfikator AVD pochodzi z nazwy AVD. Możesz użyć tego identyfikatora, aby odwoływać się do AVD z poziomu wiersza poleceń. |
| Profil sprzętowy | Kliknij Zmień, aby wybrać inny profil sprzętowy w oknie Wybieranie sprzętu. |
| Obraz systemu | Kliknij Zmień, aby wybrać inny obraz systemu z okna Obraz systemu. Aby pobrać nowy obraz, musisz mieć aktywne połączenie z internetem. |
| Orientacja podczas uruchamiania | Wybierz opcję początkowej orientacji emulatora:
Opcja jest włączona tylko wtedy, gdy jest obsługiwana w profilu sprzętowym. Podczas uruchamiania AVD w emulatorze możesz zmienić orientację, jeśli profil sprzętowy obsługuje zarówno orientację poziomą, jak i pionową. |
| Aparat (zaawansowane) | Wybierz opcję dla dowolnej włączonej kamery. Ustawienia Emulated i VirtualScene generują obraz za pomocą oprogramowania, a ustawienie Webcam używa kamery internetowej komputera programisty do zrobienia zdjęcia. Opcje aparatu są dostępne tylko wtedy, gdy aparat jest obsługiwany w profilu sprzętowym. Nie są one dostępne na Wear OS, Androida TV ani Google TV. |
| Sieć: szybkość (zaawansowane) | Wybierz protokół sieciowy, aby określić szybkość przesyłania danych:
|
| Sieć: opóźnienie (zaawansowane) | Wybierz protokół sieciowy, aby określić czas potrzebny na przesłanie pakietu danych z jednego punktu do drugiego. |
| Emulowana wydajność: grafika | Wybierz sposób renderowania grafiki w emulatorze:
|
| Emulacja wydajności: opcja uruchamiania (zaawansowane) |
Wybierz sposób uruchamiania AVD: |
| Emulowana wydajność: procesor wielordzeniowy (zaawansowane) | Wybierz liczbę rdzeni procesora na komputerze, które chcesz wykorzystać w emulatorze. Użycie większej liczby rdzeni procesora przyspiesza działanie emulatora. |
| Pamięć i miejsce na dane: pamięć RAM (zaawansowane) | Zastąpić ilość pamięci RAM na urządzeniu ustawioną przez producenta sprzętu. Zwiększenie rozmiaru powoduje wykorzystanie większej ilości zasobów komputera, ale pozwala na szybsze działanie emulatora. Wpisz rozmiar pamięci RAM i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: sterta maszyny wirtualnej (zaawansowane) | Zastąpić rozmiar stosu maszyny wirtualnej ustawiony przez producenta sprzętu. Wpisz rozmiar stosu i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: pamięć wewnętrzna (zaawansowane) | Zastąp ustawioną przez producenta sprzętu ilość niewymiennej ilości miejsca dostępnej na urządzeniu. Wpisz rozmiar i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: karta SD (zaawansowane) | Określ ilość miejsca na wymiennej pamięci dostępnej do przechowywania danych na urządzeniu. Aby użyć wirtualnej karty SD zarządzanej przez Android Studio, wybierz Zarządzana przez Studio, wpisz rozmiar i wybierz jednostki: B (bajty), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajty). Do korzystania z aparatu zalecamy co najmniej 100 MB. Aby zarządzać pokojem w pliku, wybierz Plik zewnętrzny i kliknij ..., aby określić plik i lokalizację. Więcej informacji znajdziesz w artykule |
| Ramka urządzenia: włącz ramkę urządzenia | Wybierz, aby włączyć ramkę wokół okna emulatora, która naśladuje wygląd prawdziwego urządzenia. |
| Definicja niestandardowej skórki (zaawansowana) | Wybierz wygląd urządzenia, które będzie wyświetlane w emulatorze. Podanie rozmiaru ekranu, który jest za duży dla skórki, może spowodować, że ekran będzie przycięty i nie będzie widoczny w całości. Więcej informacji znajdziesz w sekcji Tworzenie motywu emulatora. |
| Klawiatura: włącz wprowadzanie z klawiatury (zaawansowane) | Wybierz tę opcję, aby używać klawiatury sprzętowej do interakcji z emulatorem. Ta opcja jest wyłączona w przypadku Wear OS i Androida TV. |
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 ustawione podczas jego uruchamiania 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.
Na niektórych typach urządzeń niektóre właściwości są wyłączone. Na przykład właściwość „Round” jest dostępna tylko na urządzeniach z Wear OS.
Tabela 2. Właściwości konfiguracji profilu sprzętowego
| Właściwość profilu sprzętowego | Opis |
|---|---|
| Nazwa urządzenia | Wpisz nazwę profilu sprzętowego. Nazwa może zawierać wielkie i małe litery, cyfry, kropki, podkreślenia, nawiasy i spacje. Nazwa pliku przechowującego profil sprzętowy jest pochodną nazwy profilu sprzętowego. |
| Typ urządzenia | Wybierz jedną z tych opcji:
|
| Ekran: rozmiar ekranu | Określ fizyczny rozmiar ekranu (w calach) mierzony na przekątnej. Jeśli rozmiar jest większy niż ekran komputera, podczas uruchamiania zostanie on zmniejszony. |
| Ekran: rozdzielczość ekranu | Wpisz szerokość i wysokość w pikselach, aby określić łączną liczbę pikseli na symulowanym ekranie. |
| Ekran: okrągły | Wybierz tę opcję, jeśli urządzenie ma okrągły ekran, np. niektóre urządzenia z Wear OS. |
| Pamięć: RAM | Wpisz rozmiar pamięci RAM urządzenia i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Input: Has Hardware Buttons (Back/Home/Menu) | Wybierz tę opcję, jeśli urządzenie ma przyciski nawigacji. Odznacz je, jeśli te przyciski są zaimplementowane tylko w oprogramowaniu. Jeśli wybierzesz tę opcję, przyciski nie będą widoczne na ekranie. W obu przypadkach możesz użyć panelu bocznego emulatora, aby symulować naciśnięcie przycisków. |
| Wejście: ma klawiaturę sprzętową | Wybierz tę opcję, jeśli Twoje urządzenie ma klawiaturę sprzętową. Odznacz je, jeśli nie. Jeśli wybierzesz tę opcję, na ekranie nie pojawi się klawiatura. W obu przypadkach możesz użyć klawiatury komputera, aby przesyłać naciśnięcia klawiszy do emulatora. |
| Dane wejściowe: styl nawigacji | Wybierz jedną z tych opcji:
Te opcje dotyczą elementów sterujących sprzętowych na samym urządzeniu. Zdarzenia wysyłane na urządzenie przez zewnętrzny kontroler są jednak takie same. |
| Obsługiwane stany urządzeń | Wybierz jedną lub obie opcje:
Musisz wybrać co najmniej 1 opcję. Jeśli wybierzesz obie opcje, możesz przełączać się między orientacjami w emulatorze. |
| Aparaty | Aby włączyć kamerę, wybierz jedną lub obie opcje:
Jeśli kamera jest włączona, możesz użyć kamery internetowej na komputerze programisty lub zdjęcia dostarczonego przez emulator, aby symulować zrobienie zdjęcia. Wszystko zależy od opcji wybranych w konfiguracji AVD. |
| Czujniki: akcelerometr | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który pomaga określić jego orientację. |
| Czujniki: żyroskop | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który wykrywa obracanie lub przekręcanie. W połączeniu z akcelerometrem żyroskop umożliwia płynniejsze wykrywanie orientacji i obsługuje 6-osiowy system orientacji. |
| Czujniki: GPS | Wybierz tę opcję, jeśli urządzenie ma sprzęt obsługujący system nawigacji satelitarnej GPS. |
| Czujniki: czujnik zbliżeniowy | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który wykrywa, że podczas rozmowy telefonicznej znajduje się ono blisko twarzy użytkownika, aby wyłączyć wprowadzanie danych na ekranie. |
| Domyślna skórka | Wybierz skórkę, która określa wygląd urządzenia na ekranie emulatora. Podanie rozmiaru ekranu, który jest za duży dla danej rozdzielczości, może spowodować, że ekran będzie przycięty i nie będzie można zobaczyć całego ekranu. Więcej informacji znajdziesz w sekcji Tworzenie skórki emulatora. |
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ć karnację niestandardową i jej użyć:
- Utwórz katalog, w którym będziesz zapisywać pliki konfiguracji skórki.
- Określ wygląd wizualny 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. 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 } } } ... } - Dodaj do tego samego katalogu pliki bitmapowe obrazów urządzenia.
- W pliku INI określ dodatkowe konfiguracje urządzeń dla określonych ustawień sprzętowych, na przykład
hw.keyboardihw.lcd.density. - 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.