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 z pewnymi profilami sprzętowymi, takimi jak profile urządzeń Pixel. W razie potrzeby możesz je zdefiniować lub dostosować.
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:
- Otwórz Menedżera urządzeń.
- 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.
- 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 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. Wstępnie załadowanych profili sprzętowych nie można edytować.
Aby utworzyć nowy profil sprzętowy od początku:
- W oknie Wybierz sprzęt kliknij Nowy profil sprzętowy.
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.
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 myszy 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, który korzysta z AVD, kliknij Uruchom
. - Aby zatrzymać uruchomiony emulator, kliknij Menu
i wybierz Zatrzymaj.
- Aby wyczyścić dane emulatora, 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łać 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 w oknie 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ć, ile czasu zajmuje przesyłanie pakietu danych z jednego punktu do drugiego. |
| Emulowana wydajność: grafika | Wybierz sposób renderowania grafiki w emulatorze:
|
| Emulowana wydajność: 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ąpić ilość nieusuwalnej pamięci dostępnej na urządzeniu, która została określona przez producenta sprzętu. 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, podaj rozmiar i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). Do korzystania z aparatu zalecamy co najmniej 100 MB. Aby zarządzać miejscem 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 skórkę, która określa wygląd urządzenia na ekranie emulatora. 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 skórki emulatora. |
| Klawiatura: włącz emotikony 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 mogą być edytowane. 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” 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 | Aby określić łączną liczbę pikseli na symulowanym ekranie, wpisz szerokość i wysokość w pikselach. |
| 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 to pole, jeśli te przyciski są implementowane 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. |
| Dane wejściowe: czy 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ę, klawiatura nie będzie widoczna na ekranie. 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 może zapewniać płynniejsze wykrywanie orientacji i obsługiwać 6-osiowy system orientacji. |
| Czujniki: GPS | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który obsługuje system nawigacji satelitarnej Global Positioning System (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ć skórkę niestandardową i z niej korzystać:
- Utwórz katalog, w którym będziesz zapisywać pliki konfiguracji skórki.
- 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. Może to obejmować np. te funkcje: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ń na potrzeby ustawień sprzętowych, takie jak
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.