Uruchamianie emulatora z poziomu wiersza poleceń

Zawartość partycji danych, która w emulowanym systemie jest wyświetlana jako data/. Gdy tworzysz nowy AVD lub używasz opcji -wipe-data, aby zresetować 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 urządzeń AVD. Każdy AVD ma jeden userdata-qemu.imgplik.

(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 narzędziu AVD Manager 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 uruchomionego 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 powoduje również usunięcie pliku i utworzenie nowego.

Ustawia tryb emulacji dla kamery skierowanej do tyłu lub do przodu. Spowoduje to zastąpienie wszystkich ustawień kamery na urządzeniu AVD.

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

• emulated – emulator symuluje aparat w oprogramowaniu.
• environment – emulator używa wirtualnej sceny zdefiniowanej w pliku konfiguracji środowiska AVD.
• webcamn – emulator używa kamery internetowej podłączonej do komputera deweloperskiego, określonej numerem. Aby wyświetlić listę kamer internetowych, użyj opcji -webcam-list. Na przykład: webcam0.
• imagefile:filename – emulator używa pliku obrazu jako wyjścia z kamery.
• videofile:filename – emulator używa filmu jako wyjścia kamery.
• image360:filename – emulator używa do wyjścia z kamery panoramicznego obrazu w projekcji równokątowej. Dostępne w wersji 36.6.4 i nowszych.
• none – wyłącza kamerę na urządzeniu wirtualnym.

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 element 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 nazwa AVD jest wymagana.

Określa rozmiar fizycznej pamięci RAM w zakresie od 1536 MB do 8192 MB. Przykład:

emulator @Pixel8_API_34 -memory 2048

Ta wartość zastępuje ustawienie AVD.

Określa nazwę pliku i ścieżkę do pliku obrazu partycji karty SD. Na przykład:

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 na karcie SD).

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

Usuwa dane użytkownika i kopiuje dane z początkowego pliku danych. Ta opcja usuwa dane urządzenia wirtualnego i przywraca je do stanu, w jakim było, gdy zostało po raz pierwszy zdefiniowane. Wszystkie zainstalowane aplikacje i ustawienia zostaną usunięte. Przykład:

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.

Włącza lub wyłącza wyświetlanie komunikatów debugowania w przypadku co najmniej 1 tagu. Poszczególne tagi oddziel spacją, przecinkiem lub dwukropkiem. Przykład:

$ 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 ich opisów, użyj opcji -help-debug-tags. 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

Włącza określony typ wiadomości debugowania. Użyj formularza no, aby wyłączyć typ wiadomości debugowania. Przykład:

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

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

Umożliwia wyświetlanie wiadomości Logcat dla co najmniej 1 tagu i zapisywanie ich w oknie terminala. Na przykład to polecenie włącza komunikaty o błędach ze wszystkich komponentów:

emulator @Pixel8_API_34 -logcat *:e

logtags używa tego samego formatu co polecenie adb logcat logtags. Więcej informacji znajdziesz na stronie adb logcat -help. Jest to lista filtrów dziennika 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 – debug
• i – informacyjny
• w – poziom logowania ostrzeżeń
• e – błąd
• s – wyciszony

Poniższy 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 parametr ANDROID_LOG_TAGS jest zdefiniowany z prawidłową wartością logtags i nie jest pusty, emulator domyślnie używa jego 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 zapisywaniu logów za pomocą Logcat, klasie Log i wydawaniu poleceń adb.

Wyświetla komunikaty debugowania jądra w oknie terminala. Przykład:

emulator @Pixel8_API_34 -show-kernel

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

Wyświetla komunikaty inicjowania emulatora w oknie terminala. Na przykład:

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.

Używa określonych serwerów DNS. servers to lista rozdzielona przecinkami maksymalnie 4 nazw serwerów DNS lub adresów IP. Na przykład:

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.

Umożliwia nawiązywanie wszystkich połączeń TCP przez określony serwer proxy HTTP/HTTPS. Jeśli emulator musi uzyskiwać dostęp do internetu przez serwer proxy, możesz użyć tej opcji lub zmiennej środowiskowej http_proxy, aby skonfigurować odpowiednie przekierowanie. Przykład:

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.

Uwaga: jeśli uruchamiasz wiele emulatorów, ten flagę należy ustawić przy pierwszym uruchomieniu.

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, 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 poszczególne minimalne i maksymalne opóźnienia.

Przykład:

emulator @Pixel8_API_34 -netdelay gsm

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

Uwaga: to ustawienie dotyczy sieci Ethernet i komórkowej.

Wyłącza ograniczanie wykorzystania sieci. Przykład:

emulator @Pixel8_API_34 -netfast

Ta opcja jest równoznaczna z określeniem ustawienia -netspeed full -netdelay none. Są to domyślne wartości tych opcji.

Uwaga: to ustawienie dotyczy sieci Ethernet i komórkowej.

Ustawia emulację szybkości sieci. Określa maksymalną szybkość przesyłania i pobierania 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 kb/s, pobieranie: 57,6 kb/s).
• 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 (w górę: 58 000, w dół: 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 indywidualne szybkości przesyłania i pobierania.

Przykład:

emulator @Pixel8_API_34 -netspeed edge

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

Uwaga: to ustawienie dotyczy sieci Ethernet i komórkowej.

Przekazuje dodatkowe argumenty do symulatora sieci (netsim). arguments to lista flag rozdzielonych spacjami.

Aby na przykład włączyć przechwytywanie pakietów i przekierować logowanie do stderr:

emulator @Pixel8_API_34 -netsim-args="--pcap --logtostderr"

Więcej informacji znajdziesz w artykule Zaawansowane funkcje sieciowe emulatora.

Ustawia numer portu TCP używanego w konsoli i adb. Przykład:

emulator @Pixel8_API_34 -port 5556

Wartość domyślna to 5554 w przypadku pierwszej instancji urządzenia wirtualnego uruchomionej na komputerze. Urządzenie wirtualne zwykle zajmuje 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 się nie uruchomi.

Opcja ‑port informuje, 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 możesz zobaczyć numer portu konsoli w tytule okna i wyświetlić numer portu adb, wybierając 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 zostanie uruchomione, ale nie będzie widoczne, gdy użyjesz polecenia adb devices, jeśli adb server zostanie uruchomiony po emulatorze. Z tego powodu zalecamy używanie parzystego numeru portu konsoli.

Ustawia porty TCP używane przez konsolę i adb. Przykład:

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 opisie opcji -port.

Przechwytuje pakiety sieciowe i zapisuje je w pliku. Przykład:

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

Użyj tej opcji, aby rozpocząć przechwytywanie wszystkich pakietów sieciowych wysyłanych przez wirtualną sieć Ethernet LAN 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 jest ograniczona do połączeń TCP.

Konfiguruje akcelerację maszyny wirtualnej emulatora. Przykład:

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 zależy od procesora Intel i sterownika Intel HAXM. Ta opcja jest ignorowana, jeśli nie emulujesz urządzenia x86 ani x86_64.

Prawidłowe wartości parametru mode to:

• auto – automatycznie określa, czy akceleracja jest obsługiwana, i w miarę możliwości 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 Android Emulator.

Sprawdza, czy wymagany hiperwizor do przyspieszania działania maszyny wirtualnej emulatora jest zainstalowany (HAXM lub KVM). Przykład:

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.

Przykład:

emulator @Pixel8_API_34 -engine auto

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

Wybiera tryb emulacji GPU. Przykład:

emulator @Pixel8_API_34 -gpu swiftshader_indirect

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji grafiki.

Wyłącza akcelerację maszyny wirtualnej emulatora podczas korzystania z obrazu systemu x86 lub x86_64. Jest to przydatne tylko do debugowania i działa tak samo jak określenie wartości -accel off. Przykład:

emulator @Pixel8_API_34 -no-accel

Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji sprzętowej na potrzeby Android Emulator.

Wyłącza rozszerzone sprawdzanie interfejsu Java Native Interface (JNI) w środowisku wykonawczym Androida Dalvik lub ART. Przykład:

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.

Ustawia moduł zabezpieczeń Security-Enhanced Linux (SELinux) w trybie disabled lub permissive w systemie operacyjnym Linux. Przykład:

me-linux$ emulator @Pixel8_API_34 -selinux permissive

Domyślnie SELinux działa w trybie enforcing, co oznacza, że zasady zabezpieczeń są wymuszane. W trybie permissive zasada SELinux jest wczytywana, ale nie jest egzekwowana. 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. 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. Przykład:

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

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

Wyświetla numer wersji emulatora. Przykład:

emulator @Pixel8_API_34 -version

lub

emulator -version

Wyłącza animację rozruchu podczas uruchamiania emulatora, aby przyspieszyć rozruch. Przykład:

emulator @Pixel8_API_34 -no-boot-anim

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

Ustawia tryb emulowanego ekranu dotykowego. Przykład:

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 wielodotykowy.
• 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 init, który integruje funkcję tworzenia wykresu rozruchu. Za pomocą tej opcji możesz przekazać do systemu okres oczekiwania na uruchomienie. 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.

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 ś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.

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.

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 sekcji Katalog danych AVD.

Ustawia plik obrazu partycji danych użytkownika. Podaje nazwę pliku oraz ścieżkę bezwzględną lub 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.

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.

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 rozwiązywania problemów. Oto przykład:

emulator @Pixel8_API_34 -force-32bit

Uzyskuje pomoc dotyczącą obrazów dysków. Ta opcja zawiera informacje przydatne zarówno dla deweloperów aplikacji, jak i dla deweloperów platform. Przykład:

emulator -help-disk-images

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

emulator -help-char-devices

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

emulator -help-sdk-images

Uzyskiwanie pomocy dotyczącej obrazów dysków istotnych dla programistów platform. 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 względną do katalogu roboczego.

Przykład:

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

Jeśli nie podasz ś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 podasz ścieżki, emulator będzie szukać w katalogu systemowym. Użyj opcji ‑show‑kernel, aby wyświetlić komunikaty debugowania jądra.

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ć zmiennej środowiskowej QEMU_AUDIO_DRV, aby zmienić backend audio.

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.

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.

Przykład:

emulator @Pixel8_API_34 -no-snapshot

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

Przykład:

emulator @Pixel8_API_34 -no-snapshot-load

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

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.

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.

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ć w adblub w konsoli. Przykład:

emulator @Pixel8_API_34 -no-window

Określa rozmiar partycji danych systemowych w MB. 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. Przykład:

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

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

emulator -qemu -h

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

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 będzie to 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-help-report-console w sekcji Pomoc dotycząca konkretnych opcji.

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

• Tworzy ona 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).

Przykład:

emulator @Pixel8_API_34 -shell

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

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 snapshot nie istnieje, emulator wykonuje pełną sekwencję uruchamiania i operację zapisywania.

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

emulator @Pixel8_API_34 -snapshot snapshot2

Pamiętaj, że podczas wczytywania migawki wszystkie treści w systemie, dane użytkownika i obrazy z karty 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ą polecenia avd 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 podasz też -snapstorage file, to polecenie wydrukuje tabelę zrzutów przechowywanych w pliku.

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 użyć jako argumentów opcji -snapshot.

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

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 zostanie użyty katalog danych snapshots.img. Jeśli określony plik nie istnieje, emulator uruchomi się, ale bez możliwości zapisywania ani wczytywania migawek stanu.

Określa katalog systemowy za pomocą ścieżki bezwzględnej. Więcej informacji znajdziesz w artykule Katalog systemowy AVD. 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.

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 będzie to plik system.img w katalogu systemowym. Więcej informacji znajdziesz w artykule Katalog systemowy AVD.

Użyj tej opcji, aby mieć zapisywalny obraz systemu podczas sesji emulacji. Aby to zrobić:

1. Uruchom urządzenie wirtualne 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 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.