Uruchamianie emulatora z poziomu wiersza poleceń

Zawartość partycji danych, wyświetlana w emulowanym systemie jako data/. Gdy tworzysz nowy AVD lub używasz opcji -wipe-data do przywrócenia jego ustawień fabrycznych, emulator kopiuje plik userdata.img w katalogu systemowym, aby go utworzyć.

Każda instancja urządzenia wirtualnego korzysta z obrazu danych użytkownika z możliwością zapisu do przechowywania danych dotyczących użytkownika i sesji. Służy on np. do przechowywania danych, ustawień, baz danych i plików zainstalowanych przez użytkownika. Każdy użytkownik ma inny katalog ANDROID_SDK_HOME, w którym przechowywane są katalogi danych utworzonych przez niego plików AVD. Każdy AVD ma 1 plik userdata-qemu.img.

(Opcjonalnie) Obraz partycji karty SD, który umożliwia symulowanie działania karty SD na urządzeniu wirtualnym. Plik obrazu karty SD możesz utworzyć w AVD Manager lub za pomocą narzędzia mksdcard. Plik jest przechowywany na komputerze programistycznym i musi być wczytywany przy uruchamianiu.

Do określenia pliku AVD w Menedżerze AVD możesz użyć automatycznie zarządzanego pliku karty SD lub pliku utworzonego za pomocą narzędzia mksdcard. Plik sdcard.img powiązany z narzędziem AVD możesz wyświetlić w Menedżerze AVD. Opcja -sdcard zastępuje plik karty SD podany w komponencie AVD.

Gdy urządzenie wirtualne działa, możesz przeglądać i wysyłać pliki na symulowaną kartę SD oraz kopiować je i usuwać, korzystając z interfejsu emulatora lub narzędzia adb. Nie można usunąć symulowanej karty SD z działającego urządzenia wirtualnego.

Aby przed wczytaniem skopiować pliki na kartę SD, zamontuj plik obrazu jako urządzenie pętli, a następnie skopiuj pliki. Możesz też użyć narzędzia, takiego jak pakiet mtools, aby skopiować pliki bezpośrednio do obrazu.

Emulator traktuje plik jako pulę bajtów, więc format karty SD nie ma znaczenia.

Opcja -wipe-data nie ma wpływu na ten plik. W celu wyczyszczenia pliku usuń go, a następnie utwórz go ponownie za pomocą narzędzia AVD Manager lub mksdcard. Zmiana rozmiaru pliku powoduje też usunięcie go i utworzenie nowego.

mode może mieć dowolną z tych wartości:

• emulated – emulator w oprogramowaniu symuluje kamerę.
• webcamn – emulator korzysta z kamery internetowej podłączonej do komputera, którego używasz do programowania, (wskazaną liczbę). Aby zobaczyć listę kamer internetowych, wybierz -webcam-list. Przykład: webcam0.
• none – wyłącza kamerę w urządzeniu wirtualnym.

Przykład:

emulator @Nexus_5X_API_23 -camera-back webcam0

emulator @Nexus_5X_API_23 -webcam-list
        List of web cameras connected to the computer:
        Camera 'webcam0' is connected to device 'webcam0'
        on channel 0 using pixel format 'UYVY'

W tym przykładzie pierwszy webcam0 to nazwa użyta w wierszu poleceń. Druga wartość webcam0 to nazwa używana przez system operacyjny na komputerze programistycznym. Druga nazwa różni się w zależności od systemu operacyjnego.

Od wersji 25.2.4 narzędzi SDK nazwa AVD jest wymagana.

Określa rozmiar fizycznej pamięci RAM – od 128 do 4096 MB. Na przykład:

emulator @Nexus_5X_API_23 -memory 2048

Ta wartość zastępuje ustawienie AVD.

emulator @Nexus_5X_API_23 -sdcard C:/sd/sdcard.img

Jeśli plik się nie znajdzie, emulator się uruchomi, ale bez karty SD. Polecenie zwraca ostrzeżenie Brak obrazu karty SD.

Jeśli nie określisz tej opcji, domyślną wartością w katalogu danych będzie sdcard.img, chyba że AVD określa coś innego. Więcej informacji na temat emulowanych kart SD znajdziesz w sekcji Katalog danych AVD.

emulator @Nexus_5X_API_23 -wipe-data

Domyślnie plik danych użytkownika to userdata-qemu.img, a początkowy plik danych to userdata.img. Oba te pliki znajdują się w katalogu danych. Opcja -wipe-data nie ma wpływu na plik sdcard.img. Więcej informacji o danych użytkownika znajdziesz w sekcji Omówienie domyślnych katalogów i plików.

$ emulator @Nexus_5X_API_23 -debug init,metrics

Aby wyłączyć tag, umieść przed nim łącznik (-). Na przykład przykład poniżej pokazuje wszystkie komunikaty debugowania oprócz tych związanych z gniazdami sieciowymi i wskaźnikami:

-debug all,-socket,-metrics

Aby skorzystać z listy tagów i opisów, użyj opcji -help-debug-tags. Na przykład:

emulator -help-debug-tags

Domyślne tagi debugowania możesz zdefiniować w zmiennej środowiskowej ANDROID_VERBOSE. Zdefiniuj tagi, których chcesz używać, na liście rozdzielanej przecinkami. Ten przykład pokazuje, jak określić tagi socket i gles:

ANDROID_VERBOSE=socket,gles

Jest to odpowiednik użycia:

-debug-socket -debug-gles

lub

-debug socket,gles

emulator @Nexus_5X_API_23 -debug-all -debug-no-metrics

Listę tagów znajdziesz w poleceniu emulator -help-debug-tags.

emulator @Nexus_5X_API_23 -logcat *:e

logtags używa tego samego formatu co polecenie adb logcat logtags. Wpisz adb logcat -help, aby uzyskać więcej informacji. Jest to lista filtrów logu w formacie componentName:logLevel rozdzielonych spacjami lub przecinkami. componentName to gwiazdka wieloznaczna (*) lub nazwa komponentu, np. ActivityManager, SystemServer, InputManager lub WindowManager.

logLevel to jedna z tych wartości:

• v – szczegółowe
• d – debugowanie
• i – informacje
• w – poziom rejestrowania ostrzeżeń
• e – błąd
• s – cichy

Ten przykład zawiera komunikaty komponentu GSM z informacjami na poziomie dziennika:

emulator @Nexus_5X_API_23 -logcat '*:s GSM:i'

Jeśli nie podasz opcji -logcat w wierszu poleceń, emulator szuka zmiennej środowiskowej ANDROID_LOG_TAGS. Jeśli zasada ANDROID_LOG_TAGS jest zdefiniowana z prawidłową wartością logtags i nie jest pusta, emulator używa jej wartości, aby domyślnie włączyć dane wyjściowe Logcat w terminalu. Możesz też przekierować te same lub inne komunikaty logu do terminala za pomocą funkcji adb.

Więcej informacji o Logcat i adb znajdziesz w artykułach na temat narzędzia wiersza poleceń Logcat oraz artykułów na temat wyświetlania i zapisywania logów przy użyciu Logcat, klas Log oraz wydania poleceń adb.

emulator @Nexus_5X_API_23 -show-kernel

Jednym z zastosowań tej opcji jest sprawdzenie, czy proces uruchamiania działa prawidłowo.

emulator @Nexus_5X_API_23 -verbose

Pokazuje, które pliki i ustawienia są wybierane podczas uruchamiania urządzenia wirtualnego zdefiniowanego w AVD. Ta opcja działa tak samo jak określenie -debug-init.

emulator @Nexus_5X_API_23 -dns-server 192.0.2.0,
192.0.2.255

Domyślnie emulator próbuje wykryć używane serwery DNS i konfiguruje specjalne aliasy w emulowanej sieci zapory sieciowej, aby umożliwić systemowi Android bezpośrednie łączenie się z serwerami. Użyj opcji -dns-server, aby podać inną listę serwerów DNS.

emulator @Nexus_5X_API_23 -http-proxy myserver:1981

proxy może być jedną z tych wartości:

http://server:port
http://username:password@server:port

Prefiks http:// można pominąć.

Jeśli ta opcja nie zostanie podana, emulator wyszukuje zmienną środowiskową http_proxy i automatycznie używa dowolnej wartości pasującej do formatu proxy. Więcej informacji znajdziesz w sekcji o korzystaniu z emulatora w połączeniu z serwerem proxy.

Ustawia emulację opóźnienia sieci na jedną z tych wartości delay w milisekundach:

• gsm – GSM/CSD (min. 150, maks. 550).
• hscsd – HSCSD (min. 80, maks. 400).
• gprs – GPRS (min. 35, maks. 200).
• edge – EDGE/EGPRS (min. 80, maks. 400).
• umts – UMTS/3G (min. 35, maks. 200).
• hsdpa – HSDPA (min. 0, maks. 0).
• lte – LTE (min. 0, maks. 0).
• evdo – EVDO (min. 0, maks. 0).
• none – brak czasu oczekiwania, wartość domyślna (min. 0, maks. 0).
• num – określa dokładny czas oczekiwania.
• min:max – określa minimalne i maksymalne opóźnienia.

Przykład:

emulator @Nexus_5X_API_23 -netdelay gsm

Emulator obsługuje ograniczanie przepustowości sieci oraz wyższe opóźnienia połączenia. Możesz go zdefiniować w konfiguracji karnacji lub za pomocą opcji ‑netspeed i -netdelay.

emulator @Nexus_5X_API_23 -netfast

Ta opcja działa tak samo jak określenie -netspeed full -netdelay none. To są wartości domyślne tych opcji.

Ustawia emulację szybkości sieci. Określa maksymalną szybkość przesyłania i pobierania w sieci, korzystając z jednej z tych wartości speed w kb/s:

• gsm – GSM/CSD (góra: 14.4, dół: 14.4).
• hscsd – HSCSD (wzrost: 14.4, dół: 57,6).
• gprs – GPRS (góra: 28,8, dół: 57,6).
• edge – EDGE/EGPRS (w górę: 473.6, w dół: 473,6).
• umts – UMTS/3G (w górę: 384,0, w dół: 384,0).
• hsdpa – HSDPA (wzrost: 5760,0, dół: 13 980,0).
• lte – LTE (wzrost: 58 000, dół: 173 000).
• evdo – EVDO (wzrost: 75 000, dół: 280 000).
• full – brak limitu, wartość domyślna (góra: 0,0, dół: 0,0).
• num – określa szybkość wysyłania i pobierania.
• up:down – określa poszczególne szybkości zwiększania i zmniejszania szybkości.

Przykład:

emulator @Nexus_5X_API_23 -netspeed edge

Emulator obsługuje ograniczanie przepustowości sieci oraz wyższe opóźnienia połączenia. Możesz go zdefiniować w konfiguracji karnacji lub za pomocą opcji ‑netspeed i -netdelay.

emulator @Nexus_5X_API_23 -port 5556

Wartość domyślna to 5554 w przypadku pierwszej instancji urządzenia wirtualnego działającej na Twoim maszynie. Urządzenie wirtualne zajmuje zwykle parę sąsiadujących portów: port konsoli i port adb. Konsola pierwszego urządzenia wirtualnego działającego na danej maszynie korzysta z portu 5554 konsoli i portu 5555 adb. Kolejne instancje używają numerów portów zwiększanych o 2. np. 5556/5557, 5558/5559 itd. Zakres wynosi od 5554 do 5682, co pozwala na 64 równoczesne urządzenia wirtualne.

Przypisania portów są często takie same jak określenie -ports port,{port + 1}. Domena {port + 1} musi być bezpłatna i zarezerwowana dla domeny adb. Jeśli którykolwiek z portów konsoli lub adb jest już używany, emulator się nie uruchomi.

Opcja ‑port podaje porty i numery seryjne używane przez urządzenie wirtualne i ostrzega, jeśli wystąpią problemy z podanymi przez Ciebie wartościami. W interfejsie emulatora numer portu konsoli wyświetla się w tytule okna. Aby wyświetlić numer portu adb, wybierz Pomoc > Informacje.

Pamiętaj, że jeśli wartość port nie jest parzysta i mieści się w zakresie od 5554 do 5584, urządzenie wirtualne uruchomi się, ale nie będzie widoczne, gdy użyjesz polecenia adb devices, jeśli adb server rozpoczyna się po emulatorze. Z tego powodu zalecamy użycie parzystego numeru portu w konsoli.

emulator @Nexus_5X_API_23 -ports 5556,5559

Prawidłowy zakres portów to od 5554 do 5682, co pozwala na używanie 64 równoczesnych urządzeń wirtualnych. Opcja -ports informuje, których portów i numerów seryjnych używa instancja emulatora, i ostrzega w przypadku problemów z podanymi przez Ciebie wartościami.

Zamiast tego zalecamy używanie opcji -port, jeśli jest to możliwe. Opcja -ports jest dostępna w przypadku konfiguracji sieci, które wymagają specjalnych ustawień.

Więcej informacji o konfigurowaniu konsoli i portów adb znajdziesz w sekcji -port.

emulator @Nexus_5X_API_23 -tcpdump /path/dumpfile.cap

Użyj tej opcji, aby rozpocząć przechwytywanie wszystkich pakietów sieciowych wysyłanych przez wirtualną sieć LAN Ethernet emulatora. Następnie możesz go przeanalizować za pomocą narzędzia takiego jak Wireshark.

Pamiętaj, że ta opcja wychwytuje wszystkie pakiety Ethernet i nie jest ograniczona do połączeń TCP.

emulator @Nexus_5X_API_23 -accel auto

Emulacja przyspieszona działa tylko w przypadku obrazów systemowych x86 i x86_64. W systemie Linux korzysta z KVM. W systemach Windows i macOS korzysta z procesora Intel i sterownika Intel HAXM. Ta opcja jest ignorowana, jeśli nie emulujesz urządzeń x86 ani x86_64.

Prawidłowe wartości pola mode to:

• auto – określa automatycznie, czy przyspieszenie jest obsługiwane, i używa go, gdy to możliwe (domyślnie).
• off – całkowicie wyłącza przyspieszenie, co przydaje się przede wszystkim do debugowania.
• on – wymusza przyspieszenie. Jeśli KVM lub HAXM nie są zainstalowane lub nie można ich używać, emulator się nie uruchomi i wyświetli komunikat o błędzie.

Więcej informacji znajdziesz w artykule o konfigurowaniu akceleracji sprzętowej emulatora Androida.

emulator -accel-check

Więcej informacji znajdziesz w artykule Sprawdzanie, czy zainstalowany jest hipernadzorca.

Określa mechanizm emulatora:

• auto – automatycznie wybiera wyszukiwarkę (domyślnie).
• classic – używa starszego silnika QEMU 1.
• qemu2 – używa nowszego silnika QEMU 2.

Na przykład:

emulator @Nexus_5X_API_23 -engine auto

Funkcja automatycznego wykrywania powinna wybrać wartość, która zapewnia największą wydajność podczas emulacji konkretnego AVD. Używaj opcji -engine tylko do debugowania i porównywania.

emulator @Nexus_5X_API_23 -gpu swiftshader_indirect

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji graficznej.

emulator @Nexus_5X_API_23 -no-accel

Więcej informacji znajdziesz w artykule o konfigurowaniu akceleracji sprzętowej emulatora Androida.

emulator @Nexus_5X_API_23 -nojni

Po uruchomieniu urządzenia wirtualnego rozszerzone testy JNI są domyślnie włączone. Więcej informacji znajdziesz w artykule ze wskazówkami dotyczącymi JNI.

me-linux$ emulator @Nexus_5X_API_23 -selinux permissive

Domyślnie SELinux działa w trybie enforcing, co oznacza, że wymuszana jest zasada zabezpieczeń. Tryb permissive wczytuje zasadę SELinux, ale jej nie wymusza. Ta opcja powoduje rejestrowanie tylko naruszeń zasad. Tryb disabled wyłącza obsługę jądra na potrzeby SELinux.

Ustawia strefę czasową urządzenia wirtualnego na timezone zamiast strefy czasowej hosta. Na przykład:

emulator @Nexus_5X_API_23 -timezone Europe/Paris

Domyślnie emulator używa strefy czasowej komputera, którego używasz do programowania. Użyj tej opcji, aby określić inną strefę czasową lub jeśli automatyczne wykrywanie nie działa prawidłowo. Wartość timezone musi mieć format zoneinfo, czyli area/location lub area/subarea/location. Na przykład:

• America/Los_Angeles
• Europe/Paris
• America/Argentina/Buenos_Aires

Podana strefa czasowa musi znajdować się w bazie danych Zoneinfo.

emulator @Nexus_5X_API_23 -version

lub

emulator -version

emulator @Nexus_5X_API_23 -no-boot-anim

Na wolniejszych komputerach ta opcja może znacznie przyspieszyć sekwencję uruchamiania.

emulator @Nexus_5X_API_23 -screen no-touch

mode może mieć dowolną z tych wartości:

• touch – emuluje ekran dotykowy (domyślnie).
• multi-touch – emuluje ekran wielodotykowy.
• no-touch – wyłącza emulację ekranu dotykowego i ekranu wielodotykowego.

Włącza schematy rozruchowe z czasem oczekiwania w sekundach. Niektóre obrazy systemu Android mają zmodyfikowany system inicjujący, który jest zintegrowany z programem rozruchowym. Za pomocą tej opcji możesz przekazać systemowi czas oczekiwania na uruchomienie. Jeśli w systemie inicjującym nie jest włączony program rozruchowy, opcja nie przyniesie żadnego efektu. Ta opcja jest przydatna głównie dla deweloperów platform, a nie zewnętrznych deweloperów aplikacji.

Na przykład:

emulator @Nexus_5X_API_23 -bootchart 120

Określa plik obrazu partycji pamięci podręcznej. Zawiera nazwę pliku i ścieżkę bezwzględną lub ścieżkę względną do katalogu danych, aby skonfigurować trwały plik pamięci podręcznej. Jeśli plik nie istnieje, emulator utworzy go jako pusty plik.

Na przykład:

emulator @Nexus_5X_API_23 -cache
   ~/.android/avd/Nexus_5X_API_23.avd/cache_persistent.img

Jeśli nie użyjesz tej opcji, domyślnie będzie to plik tymczasowy o nazwie cache.img. Więcej informacji znajdziesz w katalogu danych AVD.

Ustawia rozmiar partycji pamięci podręcznej w MB.

Na przykład:

emulator @Nexus_5X_API_23 -cache-size 1000

Jeśli nie określisz tej opcji, domyślnie przyjęta zostanie wartość 66 MB. Zwykle większość deweloperów aplikacji nie potrzebuje tej opcji, chyba że pobiera bardzo duże pliki, które są większe niż domyślna pamięć podręczna. Więcej informacji o pliku pamięci podręcznej znajdziesz w artykule Katalog danych AVD.

Ustawia plik obrazu partycji danych użytkownika. Zawiera nazwę pliku i ścieżkę bezwzględną lub względną do katalogu roboczego, aby skonfigurować trwały plik danych użytkownika. Jeśli taki plik nie istnieje, emulator tworzy obraz z domyślnego pliku userdata.img, zapisuje go pod wpisaną przez Ciebie nazwą i pozostawia dane użytkownika w momencie wyłączenia.

Na przykład:

emulator @Nexus_5X_API_23 -data
   ~/.android/avd/Nexus_5X_API_23.avd/userdata-test.img

Jeśli nie użyjesz tej opcji, domyślną nazwą będzie plik o nazwie userdata-qemu.img. Więcej informacji o pliku danych użytkownika znajdziesz w artykule Katalog danych AVD.

Określa katalog danych przy użyciu ścieżki bezwzględnej. Więcej informacji znajdziesz w artykule Katalog danych AVD.

Na przykład:

emulator @Nexus_5X_API_23 -datadir
   ~/.android/avd/Nexus_5X_API_23.avd/mytest

Używa 32-bitowego emulatora na platformach 64-bitowych. Czasami ta opcja jest przydatna do testowania lub debugowania. Występował na przykład problem polegający na tym, że emulator czasem nie uruchamiał się w 64-bitowym systemie Windows, a w systemie 32-bitowym. Ta opcja była pomocna przy przeprowadzaniu porównań w celu debugowania problemu. Oto przykład:

emulator @Nexus_5X_API_23 -force-32bit

Uzyskiwanie pomocy dotyczącej obrazów dysków. Ta opcja dostarcza informacji zarówno dla deweloperów aplikacji, jak i platform. Na przykład:

emulator -help-disk-images

Uzyskiwanie pomocy dotyczącej specyfikacji znaków device. Niektóre opcje emulatora wymagają parametru device. Na przykład:

emulator -help-char-devices

Uzyskiwanie pomocy dotyczącej obrazów dysków przydatnych dla deweloperów aplikacji. Ta opcja umożliwia uzyskanie informacji o lokalizacji plików graficznych w przypadku komponentu AVD utworzonego za pomocą narzędzi SDK. Na przykład:

emulator -help-sdk-images

Uzyskiwanie pomocy dotyczącej obrazów dysków istotnych dla programistów platform. Na przykład:

emulator -help-build-images

Określa początkową wersję partycji danych. Po wyczyszczeniu danych użytkownika emulator kopiuje zawartość określonego pliku do danych użytkownika (domyślnie jest to plik userdata-qemu.img), zamiast używać domyślnego pliku userdata.img jako wersji początkowej. Określa nazwę pliku i ścieżkę bezwzględną lub ścieżkę względną do katalogu roboczego.

Na przykład:

emulator @Nexus_5X_API_23 -initdata
   ~/Library/Android/sdk/system-images/android-23/
   google_apis/x86/userdata-test.img

Jeśli nie określisz ścieżki, plik zostanie umieszczony w katalogu systemowym. Więcej informacji znajdziesz w katalogu systemu AVD.

Korzysta z określonego emulowanego jądra. Jeśli nie określisz ścieżki, emulator będzie szukał w katalogu systemowym.

Na przykład:

emulator @Nexus_5X_API_23 -kernel
   ~/Library/Android/sdk/system-images/android-23/
   google_apis/x86/kernel-test.img -show-kernel

Jeśli nie określisz tej opcji, domyślną wartością będzie kernel-ranchu. Więcej informacji znajdziesz w katalogu systemu AVD.

Wyłącza obsługę dźwięku przez to urządzenie wirtualne. Niektóre komputery z systemem Linux i Windows mają uszkodzone sterowniki audio, które powodują inne objawy, na przykład uniemożliwiają uruchomienie emulatora. W takiej sytuacji skorzystaj z tej opcji, aby rozwiązać problem. Aby zmienić backend audio, możesz też użyć zmiennej środowiskowej QEMU_AUDIO_DRV.

Na przykład:

emulator @Nexus_5X_API_23 -noaudio

Uruchamia emulator bez partycji pamięci podręcznej. Jeśli nie użyjesz tej opcji, domyślnie będzie to plik tymczasowy o nazwie cache.img. Ta opcja jest dostępna tylko dla deweloperów platform. Więcej informacji znajdziesz w artykule Katalog danych AVD.

Na przykład:

emulator @Nexus_5X_API_23 -nocache

Blokuje operacje automatycznego wczytywania i zapisywania, co powoduje, że emulator wykonuje pełną sekwencję rozruchu, a po zamknięciu traci swój stan. Zastępuje opcję -snapshot.

Na przykład:

emulator @Nexus_5X_API_23 -no-snapshot

Uniemożliwia emulatorowi wczytywanie stanu AVD z pamięci zrzutu. Wykonuje pełne uruchomienie.

Na przykład:

emulator @Nexus_5X_API_23 -no-snapshot-load

Zapobiega to zapisywaniu stanu AVD w pamięci zrzutu przez emulator przy zamykaniu, co oznacza, że wszystkie zmiany zostaną utracone.

Na przykład:

emulator @Nexus_5X_API_23 -no-snapshot-save

Nie próbuje skorygować czasu AVD od razu po przywróceniu zrzutu. Ta opcja może być przydatna podczas testowania, ponieważ pozwala uniknąć nagłych skoków w czasie. Aktualne informacje o czasie są wysyłane do AVD co około 15 sekund.

Na przykład:

emulator @Nexus_5X_API_23 -no-snapshot-update-time

Uruchamia emulator bez podłączania pliku w celu przechowywania lub wczytywania zrzutów stanu, wymuszając pełny rozruch i wyłączając funkcję zrzutu stanu. Ta opcja zastępuje opcje -snapstorage i -snapshot.

Na przykład:

emulator @Nexus_5X_API_23 -no-snapstorage

Wyłącza graficzne wyświetlanie okna w emulatorze. Ta opcja jest przydatna, gdy emulator działa na serwerach, które nie mają wyświetlacza. Emulator możesz otworzyć przez adb lub w konsoli. Na przykład:

emulator @Nexus_5X_API_23 -no-window

Określa rozmiar systemowej partycji danych w MB. Na przykład:

emulator @Nexus_5X_API_23 -partition-size 1024

Ustawia właściwość systemu Android w emulatorze podczas uruchamiania. name musi być nazwą właściwości oznaczoną etykietą qemu_prop o długości maksymalnie 32 znaków bez spacji, a value musi być ciągiem o długości maksymalnie 92 znaków. Przykład: plik property_contexts. W jednym wierszu polecenia można określić kilka opcji ‑prop. Ta opcja może być przydatna podczas debugowania. Na przykład:

emulator @Nexus_5X_API_23 -prop qemu.name=value -prop qemu.abc=xyz

Wyświetla pomoc na temat: -qemu. Na przykład:

emulator -qemu -h

Określa obraz rozruchowy Ramdisk. Określa nazwę pliku i ścieżkę bezwzględną lub ścieżkę względną do katalogu roboczego.

Na przykład:

emulator @Nexus_5X_API_23 -ramdisk
   ~/Library/Android/sdk/system-images/android-23/
   google_apis/x86/ramdisk-test.img

Jeśli nie używasz tej opcji, domyślną wartością jest plik ramdisk.img w katalogu systemowym. Więcej informacji znajdziesz w katalogu systemu AVD.

Raportuje port konsoli zdalnej firmie zewnętrznej przed rozpoczęciem emulacji. Może być przydatna w przypadku automatycznego skryptu testowania. socket musi używać jednego z tych formatów:

• tcp:port[,server][,max=seconds][,ipv6]
• unix:port[,server][,max=seconds][,ipv6]

Aby uzyskać więcej informacji, użyj opcji -help-report-console w sposób opisany w sekcji dotyczącej pomocy dotyczącej określonych opcji.

Tworzy główną konsolę powłoki na bieżącym terminalu. Ta opcja różni się od polecenia adb shell tym, że:

• Tworzy powłokę główną, która umożliwia modyfikowanie wielu części systemu.
• Działa nawet wtedy, gdy adb daemon w emulowanym systemie jest uszkodzony.
• Naciśnij Control+C (lub Command+C w systemie macOS), aby zatrzymać emulator zamiast powłoki.

Na przykład:

emulator @Nexus_5X_API_23 -shell

Określa nazwę zrzutu w pliku pamięci masowej na potrzeby automatycznego uruchamiania i zapisywania operacji.

Zamiast wykonywać pełną sekwencję rozruchu, emulator może wznowić wykonywanie z wcześniejszego zrzutu stanu, co zwykle jest znacznie szybsze. Jeśli podasz tę opcję, emulator wczytuje zrzut o tej nazwie z obrazu zrzutu i zapisuje go z powrotem pod tą samą nazwą przy zamykaniu.

Jeśli nie użyjesz tej opcji, domyślnie będzie to pełna sekwencja rozruchu. Jeśli określony zrzut nie istnieje, emulator wykonuje sekwencję pełnego rozruchu i zapisuje operację.

Informacje o określaniu plików do przechowywania zrzutów oraz pliku domyślnego znajdziesz w sekcji -snapstorage.

emulator @Nexus_5X_API_23 -snapshot snapshot2

Pamiętaj, że podczas wczytywania zrzutu cała zawartość systemu, dane użytkownika i obrazy kart SD są zastępowane zawartością, która była przechowywana podczas tworzenia zrzutu. Jeśli nie zapiszesz tych informacji w innym zrzucie, wszystkie zmiany wprowadzone od tego momentu zostaną utracone.

Zrzut możesz też utworzyć w konsoli emulatora za pomocą polecenia avd snapshot save name. Więcej informacji znajdziesz w artykule o wysyłaniu poleceń konsoli emulatora.

Wyświetla listę dostępnych zrzutów. To polecenie wyświetla tabelę zrzutów zapisanych w pliku pamięci masowej, na którym został uruchomiony emulator, a następnie zamykane jest. Jeśli podasz także -snapstorage file, to polecenie wyświetli tabelę zrzutów zapisanych w pliku.

Na przykład:

emulator @Nexus_5X_API_23 -snapshot-list -snapstorage
   ~/.android/avd/Nexus_5X_API_23.avd/snapshots-test.img

Możesz użyć wartości kolumn ID i TAG w danych wyjściowych jako argumentów dla opcji -snapshot.

Określa plik repozytorium, który zawiera wszystkie zrzuty stanu. W tym pliku zapisywane są wszystkie zrzuty utworzone podczas wykonywania. Podczas działania emulatora można przywrócić tylko zrzuty z tego pliku.

Na przykład:

emulator @Nexus_5X_API_23 -snapstorage
   ~/.android/avd/Nexus_5X_API_23.avd/snapshots-test.img

Jeśli nie określisz tej opcji, domyślną wartością w katalogu danych będzie snapshots.img. Jeśli podany plik nie istnieje, emulator uruchomi się, ale nie będzie obsługiwać zapisywania ani wczytywania zrzutów stanu.

Określa katalog systemowy przy użyciu ścieżki bezwzględnej. Więcej informacji znajdziesz w katalogu systemu AVD. Na przykład:

emulator @Nexus_5X_API_23 -sysdir
   ~/Library/Android/sdk/system-images/android-23/
   google_apis/x86/test

Określa początkowy plik systemowy. Zawiera nazwę pliku i ścieżkę bezwzględną lub ścieżkę względną do katalogu roboczego.

Na przykład:

emulator @Nexus_5X_API_23 -system
   ~/Library/Android/sdk/system-images/android-23/
   google_apis/x86/system-test.img

Jeśli nie używasz tej opcji, domyślną wartością jest plik system.img w katalogu systemowym. Więcej informacji znajdziesz w katalogu systemu AVD.

W Linuksie zamiast wersji pakietu z emulatorem używany jest system libstdc++. Użyj tej opcji tylko wtedy, gdy emulator nie uruchamia się prawidłowo i pamiętaj, że nie zawsze działa. Możesz też ustawić zmienną środowiskową ANDROID_EMULATOR_USE_SYSTEM_LIBS na 1.

Na przykład:

me-linux$ emulator @Nexus_5X_API_23 -use-system-libs

Ta opcja umożliwia uzyskanie obrazu systemu z możliwością zapisu podczas sesji emulacji. Aby to zrobić:

1. Uruchom urządzenie wirtualne za pomocą opcji -writable-system.
2. Wpisz polecenie adb remount z terminala poleceń, aby nakazać emulatorowi ponowne podłączenie system/ do odczytu i zapisu. Domyślnie jest dostępny tylko do odczytu.

Użycie tej flagi powoduje utworzenie tymczasowej kopii obrazu systemu. Może ona mieć bardzo duży rozmiar, do kilkuset MB, ale zostanie zniszczona po zamknięciu emulatora.