Uruchamianie emulatora z poziomu wiersza poleceń

Zawartość partycji danych, która w emulowanym systemie jest oznaczona symbolem data/. Gdy tworzysz nowy AVD lub używasz opcji -wipe-data, aby przywrócić AVD do ustawień fabrycznych, emulator kopiuje plik userdata.img w katalogu systemowym, aby utworzyć ten plik.

Każda instancja urządzenia wirtualnego używa obrazu danych użytkownika z możliwością zapisu do przechowywania danych użytkownika i danych sesji. Na przykład używa obrazu do przechowywania danych zainstalowanych aplikacji, ustawień, baz danych i plików unikalnego użytkownika. Każdy użytkownik ma inny katalog ANDROID_SDK_HOME, w którym są przechowywane katalogi danych dla utworzonych przez niego wirtualnych urządzeń z Androidem. Każdy AVD ma 1 plik userdata-qemu.img.

(Opcjonalnie) Obraz partycji karty SD, który umożliwia symulowanie 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 deweloperskim i musi być wczytywany podczas uruchamiania.

Podczas definiowania AVD w AVD Managerze możesz użyć automatycznie zarządzanego pliku karty SD lub pliku utworzonego za pomocą narzędzia mksdcard. W Menedżerze AVD możesz wyświetlić sdcard.img powiązany z AVD. Opcja -sdcard zastępuje plik karty SD określony w AVD. Pamiętaj, że ta opcja karty SD nie będzie działać na komputerach Mac z Apple Silicon.

Podczas działania urządzenia wirtualnego możesz przeglądać, wysyłać, kopiować i usuwać pliki z symulowanej karty SD za pomocą interfejsu emulatora lub narzędzia adb. Nie możesz usunąć symulowanej karty SD z działającego urządzenia wirtualnego.

Aby skopiować pliki na kartę SD przed załadowaniem, zamontuj plik obrazu jako urządzenie pętli, a następnie skopiuj pliki. Możesz też użyć narzędzia, np. pakietu 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. Jeśli chcesz wyczyścić plik, usuń go, a następnie utwórz ponownie za pomocą Menedżera AVD lub narzędzia mksdcard. Zmiana rozmiaru pliku również powoduje usunięcie pliku i utworzenie nowego.

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

• emulated – emulator symuluje aparat w oprogramowaniu.
• webcamn – emulator używa kamery internetowej podłączonej do komputera deweloperskiego, określonej numerem. Listę kamer internetowych znajdziesz w sekcji -webcam-list. Na przykład: webcam0.
• none – wyłącza aparat na urządzeniu wirtualnym.

Na przykład:

emulator @Pixel8_API_34 -camera-back webcam0

emulator @Pixel8_API_34 -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 znak webcam0 to nazwa używana w wierszu poleceń. Drugi znak webcam0 to nazwa używana przez system operacyjny na komputerze deweloperskim. Druga nazwa różni się w zależności od systemu operacyjnego.

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

Określa rozmiar pamięci RAM (od 1536 MB do 8192 MB). Na przykład:

emulator @Pixel8_API_34 -memory 2048

Ta wartość zastępuje ustawienie AVD.

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

Jeśli plik nie zostanie znaleziony, emulator uruchomi się bez karty SD. Polecenie zwraca ostrzeżenie No SD Card Image (Brak obrazu karty SD).

Jeśli nie określisz tej opcji, domyślnie będzie używana wartość sdcard.img w katalogu danych, chyba że AVD określa inną wartość. Więcej informacji o emulowanych kartach SD znajdziesz w artykule Katalog danych AVD.

emulator @Pixel8_API_34 -wipe-data

Domyślnie plik danych użytkownika to userdata-qemu.img, a plik danych początkowych 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 @Pixel8_API_34 -debug init,metrics

Aby wyłączyć tag, umieść przed nim myślnik (-). Na przykład ta opcja wyświetla wszystkie komunikaty debugowania z wyjątkiem tych, które są związane z gniazdami sieciowymi i danymi:

-debug all,-socket,-metrics

Aby wyświetlić listę 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. Określ tagi, których chcesz używać, na liście rozdzielonej przecinkami. Oto przykład, który pokazuje, jak określić tagi socket i gles:

ANDROID_VERBOSE=socket,gles

Jest to równoznaczne z użyciem:

-debug-socket -debug-gles

lub

-debug socket,gles

emulator @Pixel8_API_34 -debug-all -debug-no-metrics

Aby wyświetlić listę tagów, użyj polecenia emulator -help-debug-tags.

emulator @Pixel8_API_34 -logcat *:e

logtags używa tego samego formatu co polecenie adb logcat logtags. Więcej informacji znajdziesz w sekcji adb logcat -help. Jest to lista filtrów logów rozdzielonych spacjami lub przecinkami w formacie componentName:logLevel. componentName to symbol wieloznaczny w postaci gwiazdki (*) lub nazwa komponentu, np. ActivityManager, SystemServer, InputManager lub WindowManager.

logLevel to jedna z tych wartości:

• v – szczegółowe
• d – debugowanie
• i – informacyjny
• w – poziom logowania ostrzeżeń
• e – błąd
• s – wyciszony

Ten przykład pokazuje komunikaty komponentu GSM na poziomie dziennika informacyjnego:

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

Jeśli nie podasz opcji -logcat w wierszu poleceń, emulator wyszuka zmienną środowiskową ANDROID_LOG_TAGS. Jeśli ANDROID_LOG_TAGS jest zdefiniowane z prawidłową wartością logtags i nie jest puste, emulator domyślnie używa tej wartości, aby włączyć dane wyjściowe Logcat w terminalu. Możesz też przekierować te same lub inne wiadomości dziennika do terminala za pomocą adb.

Więcej informacji o Logcat i adb znajdziesz w narzędziu wiersza poleceń Logcat, wyświetlaniu i pisaniu logów za pomocą Logcat, klasie Log i wydawaniu poleceń adb.

emulator @Pixel8_API_34 -show-kernel

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

emulator @Pixel8_API_34 -verbose

Wyświetla, które pliki i ustawienia są faktycznie wybrane podczas uruchamiania urządzenia wirtualnego zdefiniowanego w AVD. Ta opcja jest równoznaczna z określeniem -debug-init.

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

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

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy może mieć 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 wyszuka zmienną środowiskową http_proxy i automatycznie użyje dowolnej wartości pasującej do formatu proxy. Więcej informacji znajdziesz w artykule Korzystanie z emulatora z serwerem proxy.

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

• 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, max 0).
• lte – LTE (min. 0, maks. 0).
• evdo – EVDO (min. 0, maks. 0).
• none – brak opóźnienia, wartość domyślna (min. 0, maks. 0).
• num – określa dokładny czas oczekiwania.
• min:max – określa poszczególne minimalne i maksymalne opóźnienia.

Na przykład:

emulator @Pixel8_API_34 -netdelay gsm

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

emulator @Pixel8_API_34 -netfast

Ta opcja jest taka sama jak określenie -netspeed full -netdelay none. Są to domyślne wartości tych opcji.

Ustawia emulację prędkości sieci. Określa maksymalną szybkość przesyłania i pobierania danych w sieci za pomocą jednej z tych speed wartości w kb/s:

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

Na przykład:

emulator @Pixel8_API_34 -netspeed edge

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

emulator @Pixel8_API_34 -port 5556

Wartość domyślna to 5554 w przypadku pierwszej instancji urządzenia wirtualnego uruchomionej na Twoim komputerze. 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 konkretnej maszynie korzysta z portu konsoli 5554 i adb portu 5555. Kolejne instancje używają numerów portów zwiększanych o 2. Na przykład 5556/5557, 5558/5559 itd. Zakres to 5554–5682, co pozwala na 64 wirtualne urządzenia jednocześnie.

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

Opcja ‑port podaje, których portów i numeru seryjnego używa urządzenie wirtualne, i ostrzega, jeśli występują problemy z podanymi wartościami. W interfejsie emulatora numer portu konsoli jest widoczny w tytule okna. Numer portu adb możesz też sprawdzić, klikając Pomoc > Informacje.

Jeśli wartość port nie jest parzysta i mieści się w zakresie od 5554 do 5584, urządzenie wirtualne zostanie uruchomione, ale nie będzie widoczne po użyciu polecenia adb devices, jeśli adb server zostanie uruchomiony po emulatorze. Dlatego zalecamy używanie parzystego numeru portu konsoli.

emulator @Pixel8_API_34 -ports 5556,5559

Prawidłowy zakres portów to 5554–5682, co pozwala na 64 równoczesne urządzenia wirtualne. Opcja -ports informuje, których portów i numeru seryjnego używa instancja emulatora, i ostrzega, jeśli występują problemy z podanymi wartościami.

W miarę możliwości zalecamy używanie opcji -port. Opcja -ports jest dostępna w przypadku konfiguracji sieci, które wymagają specjalnych ustawień.

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

emulator @Pixel8_API_34 -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 użyć narzędzia takiego jak Wireshark, aby przeanalizować ruch.

Pamiętaj, że ta opcja rejestruje wszystkie pakiety Ethernet i nie ogranicza się do połączeń TCP.

emulator @Pixel8_API_34 -accel auto

Przyspieszona emulacja działa tylko w przypadku obrazów systemu x86 i x86_64. W systemie Linux korzysta z KVM. W systemach Windows i Mac korzysta z procesora Intel i sterownika Intel HAXM. Ta opcja jest ignorowana, jeśli nie emulujesz urządzenia x86 ani x86_64.

Prawidłowe wartości w polu mode:

• auto – automatycznie określa, czy akceleracja jest obsługiwana, i w razie potrzeby jej używa (domyślnie).
• off – całkowicie wyłącza akcelerację, co jest przydatne głównie do debugowania.
• on – wymusza przyspieszenie. Jeśli KVM lub HAXM nie jest zainstalowany lub nie można go używać, emulator nie uruchomi się i wyświetli komunikat o błędzie.

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji sprzętowej na potrzeby emulatora Androida.

emulator -accel-check

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

Określa silnik emulatora:

• auto – automatycznie wybiera wyszukiwarkę (domyślnie).
• classic – korzysta ze starszego silnika QEMU 1 (wycofany).
• qemu2 – korzysta z nowszego silnika QEMU 2.

Na przykład:

emulator @Pixel8_API_34 -engine auto

Automatyczne wykrywanie powinno wybierać wartość, która zapewnia najlepszą wydajność podczas emulowania konkretnego AVD. Opcji -engine używaj tylko do debugowania i porównywania.

emulator @Pixel8_API_34 -gpu swiftshader_indirect

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji grafiki.

emulator @Pixel8_API_34 -no-accel

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji sprzętowej na potrzeby emulatora Androida.

emulator @Pixel8_API_34 -nojni

Gdy uruchamiasz urządzenie wirtualne, rozszerzone sprawdzanie JNI jest domyślnie włączone. Więcej informacji znajdziesz w wskazówkach dotyczących JNI.

me-linux$ emulator @Pixel8_API_34 -selinux permissive

Domyślnie SELinux działa w trybie enforcing, co oznacza, że zasady zabezpieczeń są wymuszane. Tryb permissive wczytuje zasady SELinux, ale ich nie egzekwuje. Ta opcja rejestruje tylko naruszenia zasad. Tryb disabled wyłącza obsługę SELinux w jądrze.

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

emulator @Pixel8_API_34 -timezone Europe/Paris

Domyślnie emulator używa strefy czasowej komputera deweloperskiego. 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

Określona strefa czasowa musi znajdować się w bazie danych zoneinfo.

emulator @Pixel8_API_34 -version

Lub

emulator -version

emulator @Pixel8_API_34 -no-boot-anim

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

emulator @Pixel8_API_34 -screen no-touch

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

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

Włącza tworzenie wykresu rozruchu z limitem czasu w sekundach. Niektóre obrazy systemu Android mają zmodyfikowany system inicjowania, który integruje funkcję tworzenia wykresu rozruchu. Za pomocą tej opcji możesz przekazać do systemu okres limitu czasu uruchamiania. Jeśli system inicjujący nie ma aktywnego narzędzia bootcharting, ta opcja nie będzie miała żadnego wpływu. Ta opcja jest przydatna głównie dla deweloperów platform, a nie deweloperów aplikacji zewnętrznych.

Na przykład:

emulator @Pixel8_API_34 -bootchart 120

Określa plik obrazu partycji pamięci podręcznej. Podaje nazwę pliku oraz ścieżkę bezwzględną lub 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 @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

Jeśli nie użyjesz tej opcji, domyślnie zostanie utworzony 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 @Pixel8_API_34 -cache-size 1000

Jeśli nie określisz tej opcji, domyślna wartość to 66 MB. Zwykle większość deweloperów aplikacji nie potrzebuje tej opcji, chyba że muszą pobrać 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 katalogu danych AVD.

Ustawia plik obrazu partycji danych użytkownika. Podaje nazwę pliku oraz ścieżkę bezwzględną lub ścieżkę względną do katalogu roboczego, aby skonfigurować trwały plik danych użytkownika. Jeśli plik nie istnieje, emulator tworzy obraz z domyślnego pliku userdata.img, zapisuje go w określonym pliku i zapisuje w nim dane użytkownika po wyłączeniu.

Na przykład:

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

Jeśli nie użyjesz tej opcji, domyślnie zostanie użyty plik o nazwie userdata-qemu.img. Więcej informacji o pliku danych użytkownika znajdziesz w katalogu danych AVD.

Określa katalog danych za pomocą ścieżki bezwzględnej. Więcej informacji znajdziesz w artykule Katalog danych AVD.

Na przykład:

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

Używa emulatora 32-bitowego na platformach 64-bitowych. Czasami ta opcja jest przydatna do testowania lub debugowania. Na przykład występował problem, który powodował, że emulator czasami nie działał w 64-bitowej wersji systemu Windows, ale działał w 32-bitowej. Ta opcja była przydatna do porównywania i debugowania problemu. Oto przykład:

emulator @Pixel8_API_34 -force-32bit

Wyświetla pomoc dotyczącą obrazów dysków. Ta opcja zawiera informacje istotne zarówno dla deweloperów aplikacji, jak i dla deweloperów platform. Na przykład:

emulator -help-disk-images

Uzyskaj pomoc dotyczącą specyfikacji znaku device. Parametr A device jest wymagany w przypadku niektórych opcji emulatora. Na przykład:

emulator -help-char-devices

Uzyskiwanie pomocy dotyczącej obrazów dysków przydatnych dla deweloperów aplikacji. Ta opcja pobiera informacje o tym, gdzie znajdują się pliki obrazów w przypadku AVD utworzonego za pomocą narzędzi SDK. Na przykład:

emulator -help-sdk-images

Uzyskiwanie pomocy dotyczącej obrazów dysków przydatnych dla deweloperó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 pliku userdata-qemu.img) zamiast używać domyślnego pliku userdata.img jako wersji początkowej. Określa nazwę pliku oraz ścieżkę bezwzględną lub ścieżkę względną do katalogu roboczego.

Na przykład:

emulator @Pixel8_API_34 -initdata
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/userdata-test.img

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

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

Na przykład:

emulator @Pixel8_API_34 -kernel
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/kernel-test.img -show-kernel

Jeśli nie podasz tej opcji, domyślną wartością będzie kernel-ranchu. Więcej informacji znajdziesz w artykule Katalog systemowy AVD.

Wyłącza obsługę dźwięku na tym urządzeniu wirtualnym. Niektóre komputery z systemem Linux i Windows mają wadliwe sterowniki audio, które powodują różne objawy, np. uniemożliwiają uruchomienie emulatora. W takim przypadku użyj tej opcji, aby rozwiązać problem. Możesz też użyć QEMU_AUDIO_DRV zmiennej środowiskowej, aby zmienić backend audio.

Na przykład:

emulator @Pixel8_API_34 -noaudio

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

Na przykład:

emulator @Pixel8_API_34 -nocache

Blokuje automatyczne wczytywanie i zapisywanie, co powoduje, że emulator wykonuje pełną sekwencję uruchamiania i traci stan po zamknięciu. Zastępuje opcję -snapshot.

Na przykład:

emulator @Pixel8_API_34 -no-snapshot

Uniemożliwia emulatorowi wczytywanie stanu AVD z pamięci zrzutów. Przeprowadza pełne uruchomienie.

Na przykład:

emulator @Pixel8_API_34 -no-snapshot-load

Uniemożliwia zapisywanie stanu AVD w pamięci zrzutów po zamknięciu emulatora, co oznacza, że wszystkie zmiany zostaną utracone.

Na przykład:

emulator @Pixel8_API_34 -no-snapshot-save

Nie próbuje od razu korygować czasu zegara AVD po przywróceniu migawki. Ta opcja może być przydatna podczas testowania, ponieważ pozwala uniknąć nagłego przeskoku w czasie. Aktualizacje czasu są nadal wysyłane do AVD co około 15 sekund.

Na przykład:

emulator @Pixel8_API_34 -no-snapshot-update-time

Uruchamia emulator bez montowania pliku do przechowywania lub wczytywania zrzutów stanu, co wymusza pełne uruchomienie i wyłącza funkcję zrzutów stanu. Ta opcja zastępuje opcje -snapstorage i -snapshot.

Na przykład:

emulator @Pixel8_API_34 -no-snapstorage

Wyłącza wyświetlanie okien graficznych w emulatorze. Ta opcja jest przydatna, gdy emulator jest uruchamiany na serwerach bez wyświetlacza. Dostęp do emulatora możesz uzyskać za pomocą adb lub konsoli. Na przykład:

emulator @Pixel8_API_34 -no-window

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

emulator @Pixel8_API_34 -partition-size 1024

Ustawia właściwość systemu Android w emulatorze podczas jego uruchamiania. name musi być nazwą właściwości oznaczoną jako qemu_prop, która może mieć maksymalnie 32 znaki i nie może zawierać spacji, a value musi być ciągiem znaków o długości maksymalnie 92 znaków. Przykład znajdziesz w property_contextspliku. W jednym wierszu poleceń możesz określić kilka opcji ‑prop. Ta opcja może być przydatna podczas debugowania. Na przykład:

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

Wyświetla pomoc dotyczącą -qemu. Na przykład:

emulator -qemu -h

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

Na przykład:

emulator @Pixel8_API_34 -ramdisk
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/ramdisk-test.img

Jeśli nie użyjesz tej opcji, domyślnie używany będzie plik ramdisk.img w katalogu systemowym. Więcej informacji znajdziesz w artykule Katalog systemowy AVD.

Zgłasza port konsoli zdalnej osobie trzeciej przed rozpoczęciem emulacji. Może być przydatne w przypadku skryptu testów automatycznych. socket musi używać jednego z tych formatów:

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

Więcej informacji znajdziesz w sekcji Pomoc dotycząca konkretnych opcji, w której opisano używanie opcji -help-report-console.

Tworzy konsolę powłoki roota w bieżącym terminalu. Ta opcja różni się od polecenia adb shell w tych aspektach:

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

Na przykład:

emulator @Pixel8_API_34 -shell

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

Zamiast wykonywać pełną sekwencję uruchamiania, emulator może wznowić działanie ze zrzutu wcześniejszego stanu, co zwykle jest znacznie szybsze. Jeśli podasz tę opcję, emulator wczyta zrzut o tej nazwie z obrazu zrzutu i zapisze go z powrotem pod tą samą nazwą po zakończeniu działania.

Jeśli nie użyjesz tej opcji, domyślnie zostanie wykonana pełna sekwencja uruchamiania. Jeśli określony stan nie istnieje, emulator przeprowadzi pełną sekwencję uruchamiania i wykona operację zapisywania.

Informacje o określaniu pliku pamięci masowej migawki i pliku domyślnego znajdziesz w sekcji -snapstorage.

emulator @Pixel8_API_34 -snapshot snapshot2

Pamiętaj, że podczas wczytywania migawki wszystkie treści w systemie, dane użytkownika i obrazy na karcie SD zostaną zastąpione treściami, które były w nich zapisane w momencie tworzenia migawki. Jeśli nie zapiszesz tych informacji w innym migawce, wszystkie zmiany wprowadzone od tego czasu zostaną utracone.

Migawkę możesz też utworzyć w konsoli emulatora za pomocą poleceniaavd snapshot save name. Więcej informacji znajdziesz w artykule Wysyłanie poleceń do konsoli emulatora.

Wyświetla listę dostępnych zrzutów. To polecenie wyświetla tabelę zrzutów zapisanych w pliku pamięci zrzutów, z którego emulator został uruchomiony, a następnie kończy działanie. Jeśli określisz też -snapstorage file, to polecenie wydrukuje tabelę z migawkami przechowywanymi w pliku.

Na przykład:

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

Wartości kolumn ID i TAG w danych wyjściowych możesz wykorzystać jako argumenty opcji -snapshot.

Określa plik repozytorium zawierający wszystkie zrzuty stanu. Wszystkie migawki wykonane podczas wykonywania są zapisywane w tym pliku. Podczas działania emulatora można przywrócić tylko zrzuty w tym pliku.

Na przykład:

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

Jeśli nie określisz tej opcji, domyślnie będzie to snapshots.img w katalogu danych. Jeśli określony plik nie istnieje, emulator uruchomi się, ale bez możliwości zapisywania ani wczytywania zrzutów stanu.

Określa katalog systemowy za pomocą ścieżki bezwzględnej. Więcej informacji znajdziesz w artykule Katalog systemowy AVD. Na przykład:

emulator @Pixel8_API_34 -sysdir
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/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 @Pixel8_API_34 -system
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/system-test.img

Jeśli nie użyjesz tej opcji, domyślnie używany będzie plik system.img w katalogu systemowym. Więcej informacji znajdziesz w artykule Katalog systemowy AVD.

Użyj tej opcji, aby mieć obraz systemu z możliwością zapisu podczas sesji emulacji. Aby to zrobić:

1. Uruchom wirtualne urządzenie za pomocą opcji -writable-system.
2. Wpisz polecenie adb remount w terminalu, aby poinformować emulator o ponownym zamontowaniu system/ w trybie odczytu/zapisu. Domyślnie jest on montowany jako tylko do odczytu.

Użycie tej flagi powoduje utworzenie tymczasowej kopii obrazu systemu, która może być bardzo duża (nawet kilkaset MB), ale zostanie usunięta po zamknięciu emulatora.