Urządzenie wirtualne z Androidem (AVD) to konfiguracja określająca cechy telefonu lub tabletu z Androidem, Wear OS, Androida TV lub urządzenia z systemem operacyjnym Automotive, które chcesz symulować w Emulatorze Androida. Menedżer urządzeń to narzędzie, które możesz uruchomić w Android Studio i pomaga ono tworzyć AVD i nim zarządzać.
Aby otworzyć nowego Menedżera urządzeń, wykonaj jedną z tych czynności:
- Na ekranie powitalnym Android Studio wybierz Więcej czynności > Menedżer urządzeń wirtualnych.
- Po otwarciu projektu wybierz na głównym pasku menu Widok > Okna narzędzi > Menedżer urządzeń, a następnie kliknij Utwórz urządzenie.
Jeśli chcesz używać urządzeń wirtualnych do przeprowadzania zautomatyzowanych testów instrumentalnych w skalowalny i samodzielny sposób, rozważ użycie urządzeń zarządzanych przez Gradle.
Informacje o AVD
AVD zawiera profil sprzętu, obraz systemu, obszar pamięci, motyw i inne właściwości.
Zalecamy utworzenie AVD dla każdego obrazu systemu, który może obsługiwać Twoja aplikacja, na podstawie ustawienia
<uses-sdk> w pliku manifestu.
Profil sprzętu
Profil sprzętu definiuje cechy urządzenia wysłanego z fabryki. W Menedżerze urządzeń są wstępnie zainstalowane niektóre profile sprzętu, np. urządzenia Pixel. 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 aktualizowania Usług Google Play na urządzeniu.
Urządzenia z tym logo oraz urządzeniem typu „Telefon” też są zgodne z CTS i mogą używać obrazów systemu z aplikacją Sklep Play.
Obrazy systemowe
Obraz systemu oznaczony za pomocą interfejsów API Google umożliwia dostęp do Usług Google Play.
Karta Zalecane zawiera listę zalecanych obrazów systemu. Pozostałe karty zawierają pełniejszą listę. Panel po prawej stronie opisuje wybrany obraz systemu.
Jeśli obok obrazu systemu widzisz ikonę pobierania, oznacza to, że ten obraz nie jest obecnie zainstalowany na komputerze, na którym jesteś deweloperem. Kliknij ikonę, aby pobrać obraz systemu. Aby pobierać obrazy systemu, musisz mieć połączenie z internetem.
Poziom interfejsu API urządzenia docelowego jest ważny, ponieważ aplikacja nie działa w obrazie systemu, którego poziom interfejsu API jest niższy od poziomu wymaganego przez aplikację, zgodnie z atrybutem
minSdk w pliku manifestu aplikacji. Więcej informacji o relacji między poziomem interfejsu API systemu a minSdk znajdziesz w artykule Tworzenie wersji aplikacji.
Jeśli aplikacja deklaruje w pliku manifestu element
<uses-library>, wymaga obrazu systemu zawierającego tę bibliotekę zewnętrzną.
Aby uruchomić aplikację w emulatorze, utwórz narzędzie AVD zawierające wymaganą bibliotekę. Aby to zrobić, może być konieczne użycie komponentu dodatku dla platformy AVD. Na przykład dodatek interfejsów API Google zawiera bibliotekę Map Google.
Aby zapewnić bezpieczeństwo aplikacji i spójność z urządzeniami fizycznymi, obrazy systemu dołączone do Sklepu Google Play są podpisywane kluczem wersji, co oznacza, że do tych obrazów nie można uzyskać podwyższonych uprawnień (root).
Jeśli do rozwiązywania problemów z aplikacją potrzebujesz podwyższonych uprawnień (root), możesz używać obrazów systemu Android Open Source Project (AOSP), które nie zawierają aplikacji ani usług Google. Następnie możesz używać 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 %
Powierzchnia przechowywania
System AVD ma wydzielone miejsce na dysku na komputerze, na którym pracujesz. Na urządzeniu są przechowywane dane użytkownika (np. zainstalowane aplikacje i ustawienia), a także emulowana karta SD. W razie potrzeby możesz użyć Menedżera urządzeń do wyczyszczenia danych użytkownika, aby na urządzeniu były te same dane, jakby były nowe.
Kolor skóry
Motyw emulatora określa wygląd urządzenia. W Menedżerze urządzeń są dostępne wstępnie zdefiniowane skórki. Możesz też definiować własne skórki lub używać skórek dostarczonych przez osoby trzecie.
AVD i funkcje aplikacji
Upewnij się, że definicja AVD obejmuje funkcje urządzenia, od których zależy Twoja aplikacja. Listę funkcji, które można zdefiniować w AVD, znajdziesz w sekcjach dotyczących właściwości profilu sprzętowego i właściwości AVD.
Tworzenie AVD
Aby utworzyć nowy AVD:
- Otwórz Menedżera urządzeń.
- Kliknij Utwórz urządzenie.
Pojawi się okno Select Hardware (Wybór sprzętu).
Zwróć uwagę, że tylko niektóre profile sprzętu obejmują Sklep Play. Te profile są w pełni zgodne z CTS i mogą wykorzystywać obrazy systemu zawierające aplikację Sklep Play.
- Wybierz profil sprzętu i kliknij Dalej.
Jeśli nie widzisz odpowiedniego profilu sprzętu, możesz go utworzyć lub zaimportować w sposób opisany w innych sekcjach tej strony.
Pojawi się okno Obraz systemu.
- Wybierz obraz systemu dla określonego 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ń, takich jak motyw.
Pojawi się okno Zweryfikuj konfigurację.
Nowy AVD pojawi się na karcie Wirtualny w Menedżerze urządzeń i w menu urządzenia docelowego.
Aby utworzyć AVD zaczynający się od kopii:
- Na karcie Wirtualny w Menedżerze urządzeń kliknij Menu
i wybierz Duplikuj.
Pojawi się okno Zweryfikuj konfigurację.
- Kliknij Wstecz, jeśli chcesz wprowadzić zmiany w oknach Obraz systemu lub Wybierz sprzęt.
- Wprowadź zmiany i kliknij Zakończ.
AVD pojawi się na karcie Wirtualny w Menedżerze urządzeń.
Tworzenie profilu sprzętu
Menedżer urządzeń ma wstępnie zdefiniowane profile sprzętowe popularnych urządzeń, dzięki czemu możesz łatwo dodać je do definicji AVD. Jeśli chcesz zdefiniować inne urządzenie, możesz utworzyć nowy profil sprzętu.
Możesz od początku zdefiniować nowy profil sprzętu lub skopiować go. Nie można edytować wstępnie wczytanych profili sprzętu.
Aby od razu utworzyć nowy profil sprzętu:
- W oknie Select Hardware (Wybierz sprzęt) kliknij New Hardware Profile (Nowy profil sprzętu).
W oknie Skonfiguruj profil sprzętu zmień właściwości profilu sprzętu według potrzeb.
- Kliknij Zakończ.
Nowy profil sprzętu pojawi się w oknie Wybierz sprzęt. Możesz utworzyć AVD, który korzysta z profilu sprzętu. Aby to zrobić, kliknij Dalej. Możesz też kliknąć Anuluj, aby wrócić na kartę Wirtualny lub do menu urządzenia docelowego.
Aby utworzyć profil sprzętu, na podstawie kopii jako punktu wyjścia:
- W oknie Wybierz sprzęt wybierz profil sprzętu i kliknij Sklonuj urządzenie lub kliknij profil sprzętu prawym przyciskiem myszy i wybierz Klonuj.
- W oknie Skonfiguruj profil sprzętu zmień właściwości profilu sprzętu według potrzeb.
- Kliknij Zakończ.
Nowy profil sprzętu pojawi się w oknie Wybierz sprzęt. Możesz utworzyć AVD, który korzysta z profilu sprzętu. Aby to zrobić, kliknij Dalej. Możesz też kliknąć Anuluj, aby wrócić na kartę Wirtualny lub do menu urządzenia docelowego.
Edytuj istniejące AVD
Na karcie Wirtualny 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 AVD INI i IMG 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 zespołowi Android Studio, kliknij Menu
i wybierz Wyświetl szczegóły.
Edytuj istniejące profile sprzętu
Nie możesz edytować ani usuwać wstępnie załadowanych profili sprzętu, ale w oknie Wybierz sprzęt możesz wykonać te operacje na innych profilach sprzętu:
- 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ętu, kliknij go prawym przyciskiem myszy i wybierz Usuń.
Uruchamianie i zatrzymywanie emulatora oraz czyszczenie danych
Na karcie Wirtualny możesz wykonać te operacje w emulatorze:
- Aby uruchomić emulator z programem 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ętu
W oknie Select Hardware (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. Wskaż lokalizację, w której chcesz zapisać plik XML zawierający definicję.
Właściwości AVD
Konfiguracja AVD określa interakcję między komputerem programistycznym a emulatorem oraz właściwości, które chcesz zastąpić w profilu sprzętowym. W oknie Zweryfikuj konfigurację możesz określić te właściwości konfiguracji AVD. Właściwości oznaczone etykietą (Zaawansowane) wyświetlą się tylko po kliknięciu Pokaż ustawienia zaawansowane.
Właściwości konfiguracji AVD zastępują właściwości profilu sprzętu, a właściwości emulatora ustawione podczas działania emulatora zastępują je obie.
Tabela 1. Właściwości konfiguracji AVD
| Właściwość AVD | Opis |
|---|---|
| Nazwa AVD | Wpisz nazwę AVD. Nazwa może zawierać wielkie i małe litery, cyfry, kropki, podkreślenia, nawiasy, łączniki i spacje. Nazwa pliku zawierającego konfigurację AVD pochodzi z 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ętu | Kliknij Zmień, aby wybrać inny profil sprzętu w oknie Wybierz sprzęt. |
| 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 uruchamiania | Wybierz opcję początkowej orientacji emulatora:
Opcja jest włączona tylko wtedy, gdy jest obsługiwana w profilu sprzętu. Uruchamiając AVD w emulatorze, możesz zmienić orientację, jeśli profil sprzętu obsługuje zarówno orientację pionową, jak i poziomą. |
| Aparat (zaawansowane) | Wybierz opcję dla wszystkich włączonych kamer. Ustawienia emulacji i wirtualnej sceny generują obraz generowany przez oprogramowanie, natomiast ustawienie Kamera internetowa używa kamery internetowej komputera programisty Opcje kamery są dostępne tylko wtedy, gdy profil sprzętowy obsługuje kamerę. Nie są one dostępne na urządzeniach z Wear OS, Androidem TV ani w Google TV. |
| Sieć: szybkość (zaawansowane) | Wybierz protokół sieciowy, aby określić szybkość przesyłania danych:
|
| Sieć: opóźnienie (zaawansowane) | Wybierz protokół sieciowy, aby ustawić czas potrzebny na przesłanie pakietu danych z jednego punktu do innego. |
| Emulowana wydajność: grafika | Wybierz sposób renderowania grafiki w emulatorze:
|
| Emulowana wydajność: opcja uruchamiania (zaawansowane) |
Wybierz sposób uruchamiania AVD: |
| Emulowana wydajność: procesory wielordzeniowe (zaawansowane) | Wybierz na komputerze liczbę rdzeni procesora, których chcesz używać w emulatorze. Większa liczba rdzeni procesora przyspiesza emulator. |
| Pamięć i miejsce na dane: RAM (zaawansowane) | Zastąp ilość pamięci RAM urządzenia ustawiona przez producenta sprzętu. Zwiększenie rozmiaru zużywa więcej zasobów komputera, ale umożliwia szybsze działanie emulatora. Wpisz rozmiar pamięci RAM i wybierz jednostki: B (bajty), KB (kilobajty), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: sterta maszyn wirtualnych (zaawansowane) | Zastąp rozmiar sterty maszyn wirtualnych ustawiony przez producenta sprzętu. Wpisz rozmiar stosu i wybierz jednostki: B (bajty), KB (kilobajty), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: pamięć wewnętrzna (zaawansowane) | Zastąp ilość niewymiennej pamięci dostępnej na urządzeniu ustawioną przez producenta sprzętu. Wpisz rozmiar i wybierz jednostki: B (bajty), KB (kilobajty), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Pamięć i miejsce na dane: Karta SD (zaawansowane) | Określ ilość wymiennej pamięci dostępnej na przechowywanie danych na urządzeniu. Aby użyć wirtualnej karty SD zarządzanej w Android Studio, wybierz Zarządzana przez Studio, wpisz rozmiar i wybierz jednostki: B (bajt), KB (kilobajt), MB (megabajt), GB (gigabajt) lub TB (terabajt). Do użycia kamery powinno być 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 opisie |
| Ramka urządzenia: włącz ramkę urządzenia | Wybierz, aby włączyć ramkę wokół okna emulatora, która imituje wygląd prawdziwego urządzenia. |
| Niestandardowa definicja skórki (zaawansowane) | Wybierz motyw, który określa wygląd urządzenia po wyświetleniu w emulatorze. Jeśli ekran będzie za duży dla skóry, ekran może zostać przycięty i nie będzie widać całego ekranu. Więcej informacji znajdziesz w sekcji Tworzenie motywu emulatora. |
| Klawiatura: włącz korzystanie z klawiatury (zaawansowane) | Wybierz tę opcję, aby używać klawiatury sprzętowej do interakcji z emulatorem. Ta opcja jest wyłączona na urządzeniach z Wear OS i Androidem TV. |
Właściwości profilu sprzętu
W oknie Skonfiguruj profil 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ętu, a właściwości emulatora ustawione w czasie działania emulatora zastępują je obie.
Wstępnie zdefiniowanych profili sprzętu dostępnych w Menedżerze urządzeń nie można edytować. Możesz jednak skopiować profile i edytować kopie.
Niektóre usługi są wyłączone na niektórych typach urządzeń. Na przykład właściwość „Rondo” jest dostępna tylko na urządzeniach z Wear OS.
Tabela 2. Właściwości konfiguracji profilu sprzętu
| Właściwość profilu sprzętu | Opis |
|---|---|
| Nazwa urządzenia | Wpisz nazwę profilu sprzętu. Nazwa może zawierać wielkie i małe litery, cyfry, kropki, podkreślenia, nawiasy i spacje. Nazwa pliku, w którym jest przechowywany profil sprzętu, pochodzi z nazwy profilu sprzętu. |
| Typ urządzenia | Wybierz jedną z tych opcji:
|
| Ekran: Rozmiar ekranu | Określ fizyczny rozmiar ekranu w calach (mierzony po przekątnej). Jeśli rozmiar jest większy niż ekran komputera, zostanie zmniejszony w momencie uruchomienia. |
| Ekran: rozdzielczość ekranu | Wpisz szerokość i wysokość w pikselach, by 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 (bajty), KB (kilobajty), MB (megabajt), GB (gigabajt) lub TB (terabajt). |
| Wejście: ma przyciski sprzętowe (Wstecz/Ekran główny/Menu) | Wybierz tę opcję, jeśli Twoje urządzenie ma sprzętowe przyciski nawigacyjne. Usuń zaznaczenie, jeśli przyciski są zaimplementowane wyłącznie w oprogramowaniu. Jeśli wybierzesz tę opcję, przyciski będą niewidoczne na ekranie. W obu przypadkach możesz symulować naciskanie przycisków za pomocą panelu bocznego emulatora. |
| Wejście: posiada klawiaturę sprzętową | Wybierz tę opcję, jeśli Twoje urządzenie ma klawiaturę sprzętową. Jeśli nie, odznacz ją. Jeśli wybierzesz tę opcję, na ekranie nie wyświetli się klawiatura. W obu przypadkach możesz przesyłać naciśnięcia klawiszy do emulatora za pomocą klawiatury komputera. |
| Wejście: Styl nawigacji | Wybierz jedną z tych opcji:
Te opcje służą do sterowania sprzętem na urządzeniu. Zdarzenia wysyłane do urządzenia 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. |
| kamery, | Aby włączyć aparat, wybierz jedną lub obie opcje:
Jeśli kamera jest włączona, możesz użyć kamery internetowej komputera lub zdjęcia z emulatora, aby przeprowadzić symulację robienia zdjęcia – w zależności od opcji wybranych w konfiguracji AVD. |
| Czujniki: akcelerometr | Wybierz tę opcję, jeśli urządzenie ma sprzęt pomagający określić jego orientację. |
| Czujniki: żyroskop | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który wykrywa obrót lub skręty. W połączeniu z akcelerometrem żyroskop zapewnia 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: zbliżeniowy | Wybierz tę opcję, jeśli urządzenie ma sprzęt, który wykrywa, kiedy podczas rozmowy telefonicznej znajduje się blisko twarzy użytkownika, aby wyłączyć wprowadzanie tekstu na ekranie. |
| Domyślna skórka | Wybierz motyw, który kontroluje wygląd urządzenia po wyświetleniu w emulatorze. Jeśli ekran będzie za duży do danej rozdzielczości, ekran może zostać przycięty i nie będzie widoczny na całym ekranie. Więcej informacji znajdziesz w sekcji poniżej o tworzeniu skóry emulatora. |
Tworzenie skórki emulatora
Motyw emulatora Androida to zbiór plików, które definiują elementy wizualne i sterujące wyświetlacza emulatora. Jeśli definicje skóry dostępne w ustawieniach AVD nie spełniają Twoich wymagań, możesz utworzyć własną definicję skóry, a potem 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świetlania, takich jak tło, klucze i przyciski
Aby utworzyć karnację niestandardową i jej używać:
- Utwórz katalog, w którym możesz zapisać pliki konfiguracji karnacji.
- Określ wygląd skóry w pliku tekstowym o nazwie
layout. Ten plik definiuje wiele cech wyglądu, np. rozmiar i zasoby graficzne dla 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 } } } ... } - Do tego samego katalogu dodaj pliki bitmapowe obrazów urządzeń.
- W pliku INI określ dodatkowe konfiguracje sprzętowe ustawień urządzeń, takie jak
hw.keyboardihw.lcd.density. - Zarchiwizuj pliki w folderze skóry i wybierz plik archiwum jako motyw niestandardowy.
Więcej informacji o tworzeniu skórek emulatorów znajdziesz w specyfikacji pliku skóry emulatora Androida w kodzie źródłowym narzędzi.