Pakiet Android SDK zawiera emulator urządzeń z Androidem – urządzenie wirtualne działające na komputerze. Emulator Androida pozwala tworzyć i testować aplikacje na Androida bez fizycznego urządzenia.
Na tej stronie opisujemy funkcje wiersza poleceń, których możesz używać z emulatorem Androida. Informacje o korzystaniu z interfejsu emulatora Androida znajdziesz w artykule Uruchamianie aplikacji za pomocą emulatora Androida.
Uruchom emulator
Uruchom emulator za pomocą polecenia emulator
jako alternatywy dla uruchomienia projektu lub uruchamiania go za pomocą usługi AVD Manager.
Podstawowa składnia wiersza poleceń służąca do uruchamiania urządzenia wirtualnego z poziomu wiersza poleceń terminala:
emulator -avd avd_name [ {-option [value]} … ]
lub
emulator @avd_name [ {-option [value]} … ]
Jeśli na przykład uruchomisz emulator z poziomu Androida Studio uruchomionego na Macu, domyślny wiersz poleceń będzie podobny do tego:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
Pamiętaj, że argumenty -qt-hide-window -grpc-use-token -idle-grpc-timeout
służą tylko do uruchamiania okna emulatora w Android Studio. Jeśli chcesz uruchomić emulator w osobnym oknie, nie używaj tych dodatkowych parametrów.
Możesz określić opcje uruchamiania podczas uruchamiania emulatora, ale nie po jego uruchomieniu.
Aby wyświetlić listę nazw AVD, wpisz to polecenie:
emulator -list-avds
Użyj tej opcji, aby wyświetlić listę nazw AVD z katalogu głównego Androida.
Domyślny katalog główny możesz zastąpić, ustawiając zmienną środowiskową ANDROID_SDK_HOME
, która określa katalog główny katalogu, w którym są przechowywane wszystkie konfiguracje i treści AVD.
Zmienną środowiskową możesz ustawić w oknie terminala przed uruchomieniem urządzenia wirtualnego lub w ustawieniach użytkownika w systemie operacyjnym. na przykład w pliku .bashrc
na Linuksie.
Aby zatrzymać emulator Androida, zamknij jego okno.
Instalowanie aplikacji
Oprócz instalacji aplikacji przy użyciu Android Studio lub interfejsu emulatora możesz ją zainstalować na urządzeniu wirtualnym za pomocą narzędzia adb
.
Aby zainstalować, uruchomić i przetestować aplikację za pomocą adb
, wykonaj te ogólne czynności:
- Utwórz i spakuj aplikację w plik APK w sposób opisany w artykule Tworzenie i uruchamianie aplikacji.
- Uruchom emulator z poziomu wiersza poleceń zgodnie z opisem w poprzedniej sekcji, używając wszelkich niezbędnych opcji uruchamiania.
- Zainstaluj aplikację za pomocą narzędzia
adb
. - Uruchom i przetestuj aplikację w emulatorze.
Gdy emulator jest uruchomiony, w razie potrzeby możesz używać konsoli emulatora do wydawania poleceń.
Aby odinstalować aplikację, wykonaj te same czynności co na urządzeniu z Androidem.
Urządzenie wirtualne zachowuje aplikację i jej dane o stanie po ponownym uruchomieniu na partycji dysku danych użytkownika (userdata-qemu.img
). Aby usunąć te dane, uruchom emulator przy użyciu opcji -wipe-data
lub wyczyść dane w AVD Manager. Więcej informacji o partycji danych użytkownika i innym miejscu na dane znajdziesz w kolejnej sekcji.
Uwaga: narzędzie adb
traktuje urządzenie wirtualne jako rzeczywiste urządzenie fizyczne. Dlatego konieczne może być użycie flagi -d
z popularnymi poleceniami adb
, takimi jak install
. Flaga -d
pozwala określić, którego z połączonych urządzeń chcesz używać jako miejsca docelowego polecenia. Jeśli nie określisz wartości -d
, emulator będzie kierowany na pierwsze urządzenie na liście.
Informacje o domyślnych katalogach i plikach
Emulator wykorzystuje powiązane pliki, z których najważniejsze są system AVD i katalogi danych. Podczas określania opcji wiersza poleceń dobrze jest poznać strukturę katalogów emulatora i pliki, ale zwykle nie musisz modyfikować domyślnych katalogów ani plików.
Emulator Androida używa hipernadzorcy (QEMU).
Katalog systemu AVD
Katalog systemu zawiera obrazy systemu Android, których emulator używa do symulacji systemu operacyjnego. Ten katalog zawiera związane z platformą pliki tylko do odczytu udostępniane przez wszystkie narzędzia AVD tego samego typu, w tym na poziomie interfejsu API, architekturze procesora i wersji Androida. Domyślne lokalizacje to:
- macOS i Linux –
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/
- Windows –
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
Gdzie:
apiLevel
to liczbowy poziom interfejsu API lub litera oznaczająca wersje podglądu. Na przykładandroid-V
wskazuje podgląd VanillaIceCream na Androida. W chwili premiery zmieniono poziom interfejsu API na 35, który został oznaczony przezandroid-35
.variant
to nazwa odpowiadająca konkretnym funkcjom zaimplementowanym przez obraz systemu. Na przykładgoogle_apis
lubandroid-wear
.arch
to docelowa architektura procesora. Przykład:x86
.
Użyj opcji -sysdir
, aby określić inny katalog systemowy na potrzeby AVD.
Emulator odczytuje te pliki z katalogu systemowego:
Plik | Opis | Opcja wskazania innego pliku |
---|---|---|
kernel-qemu lub kernel-ranchu
|
Plik binarny jądra systemu AVD. kernel-ranchu opiera się na emulatorze QEMU.
|
-kernel
|
ramdisk.img
|
Obraz partycji rozruchowej. Jest to podzbiór zbioru danych system.img wczytywany przez jądro początkowo przed podłączeniem obrazu systemu. Zwykle zawiera on tylko kilka plików binarnych i skryptów inicjujących.
|
-ramdisk
|
system.img
|
Wstępna wersja obrazu systemu, dostępna tylko do odczytu. Konkretnie jest to partycja zawierająca biblioteki systemowe i dane odpowiadające poziomowi i wariantowi interfejsu API. | -system
|
userdata.img
|
Początkowa wersja partycji danych, która wyświetla się w emulowanym systemie jako data/ i zawiera wszystkie dostępne do zapisu dane AVD. Emulator używa tego pliku, gdy tworzysz nowy program AVD lub używasz opcji ‑wipe-data . Więcej informacji znajdziesz w opisie pliku userdata-qemu.img w następnej sekcji.
|
-initdata
-init-data
|
Katalog danych AVD
Katalog danych AVD, nazywany też katalogiem treści, jest powiązany z pojedynczą instancją AVD i zawiera wszystkie dane, które można modyfikować.
Lokalizacja domyślna to ta, gdzie name
to nazwa AVD:
- macOS i Linux –
~/.android/avd/name.avd/
- Windows 10 lub nowszy –
C:\Users\user\.android\name.avd\
Użyj opcji -datadir
, aby określić inny katalog danych AVD.
Poniższa tabela zawiera najważniejsze pliki w tym katalogu:
Plik | Opis | Opcja wskazania innego pliku |
---|---|---|
userdata-qemu.img
|
Zawartość partycji danych, która wyświetla się w emulowanym systemie jako
Każda instancja urządzenia wirtualnego używa obrazu danych użytkownika z możliwością zapisu do przechowywania danych użytkownika i sesji. Obrazy są na przykład wykorzystywane do przechowywania danych, ustawień, baz danych i plików aplikacji zainstalowanych przez unikalnego użytkownika. Każdy użytkownik ma inny katalog |
-data
|
cache.img
|
Obraz partycji pamięci podręcznej, który w emulowanym systemie wyświetla się jako cache/ . Pole jest puste, gdy po raz pierwszy tworzysz średni czas oglądania lub używasz opcji -wipe-data . Zawiera on tymczasowe pliki pobierania i zapełnia je
menedżer pobierania, a czasem system. Na przykład podczas działania emulatora przeglądarka używa go do zapisywania w pamięci podręcznej pobranych stron internetowych i obrazów. Gdy wyłączysz urządzenie wirtualne, plik zostanie usunięty. Aby zachować plik, możesz użyć opcji -cache .
|
-cache
|
sdcard.img
|
(Opcjonalnie) Obraz partycji karty SD, który pozwala symulować kartę SD na urządzeniu wirtualnym. Możesz utworzyć plik obrazu karty SD w AVD Manager lub narzędziu
Podczas definiowania AVD w Menedżerze AVD możesz użyć automatycznie zarządzanego pliku karty SD lub pliku utworzonego przy użyciu narzędzia
Gdy urządzenie wirtualne jest uruchomione, możesz przeglądać pliki, wysyłać na nie pliki, kopiować i usuwać je z symulowanej karty SD, korzystając z interfejsu emulatora lub narzędzia
Aby skopiować pliki na kartę SD przed jego wczytaniem, podłącz plik obrazu jako urządzenie do pętli, a następnie skopiuj pliki. Możesz też użyć narzędzia, takiego jak pakiet Emulator traktuje plik jako pulę bajtów, więc format karty SD nie ma znaczenia.
Opcja |
-sdcard
|
Wyświetl listę katalogów i plików używanych przez emulator
Możesz sprawdzić lokalizację plików na 2 sposoby:
- Jeśli uruchamiasz emulator z wiersza poleceń, użyj opcji
-verbose
lub-debug init
. Spójrz na dane wyjściowe. - Aby wyświetlić katalog domyślny, użyj polecenia
emulator
-help-option
. Przykład:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
Opcje uruchamiania wiersza poleceń
W tej sekcji znajdziesz opcje, które możesz udostępnić w wierszu poleceń po uruchomieniu emulatora.
Uwaga: emulator Androida jest stale rozwijany, aby zwiększyć jego niezawodność. Informacje o stanie problemów zgłaszanych w związku z różnymi opcjami wiersza poleceń oraz o zgłaszaniu błędów znajdziesz w narzędziu do śledzenia problemów z Androidem.
Często używane opcje
W poniższej tabeli znajdziesz opcje uruchamiania wiersza poleceń, których możesz używać częściej:
Opcja wiersza poleceń | Opis |
---|---|
Szybkie uruchamianie | |
-no-snapshot-load
|
Przeprowadza „na zimno” i zapisuje stan emulatora przy zamykaniu. |
-no-snapshot-save
|
Wykonuje szybki rozruch, jeśli to możliwe, ale nie zapisuje stanu emulatora przy zamykaniu. |
-no-snapshot
|
Całkowicie wyłącza funkcję szybkiego uruchamiania i nie wczytuje ani nie zapisuje stanu emulatora. |
Sprzęt | |
-camera-back mode -camera-front mode
|
Ustawia tryb emulacji dla aparatu skierowanego do przodu lub do tyłu. Zastępuje to wszystkie ustawienia kamery w AVD.
Przykład: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Zawiera listę kamer internetowych na Twoim komputerze programistycznym, które są dostępne do emulacji. Na przykład: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 element Od wersji SDK Tools 25.2.4 wymagana jest nazwa AVD. |
Obrazy na dysku i pamięć | |
-memory size
|
Określa rozmiar fizycznej pamięci RAM, od 1536 do 8192 MB. Na przykład: emulator @Pixel8_API_34 -memory 2048 Ta wartość zastępuje ustawienie AVD. |
-sdcard filepath
|
Określa nazwę pliku i ścieżkę do pliku graficznego partycji karty SD. Na przykład:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img Jeśli plik nie zostanie znaleziony, emulator będzie się uruchamiał, 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 |
-wipe-data
|
Usuwa dane użytkownika i kopiuje je z początkowego pliku danych. Ta opcja powoduje wyczyszczenie danych urządzenia wirtualnego i przywrócenie ich do stanu sprzed pierwszego zdefiniowania. Zostaną usunięte wszystkie zainstalowane aplikacje i ustawienia. Na przykład:
emulator @Pixel8_API_34 -wipe-data
Domyślnie plik danych użytkownika ma postać |
Debuguj | |
-debug tags
|
Włącza lub wyłącza wyświetlanie komunikatów debugowania dotyczących jednego lub większej liczby tagów.
Kolejne tagi rozdziel spacją, przecinkiem lub kolumną. Na przykład:
$ emulator @Pixel8_API_34 -debug init,metrics Aby wyłączyć tag, umieść przed nim łącznik (-). Na przykład ta opcja wyświetla wszystkie komunikaty debugowania z wyjątkiem tych związanych z gniazdami sieciowymi i wskaźnikami:
Aby wyświetlić listę tagów i opisów, użyj opcji
emulator -help-debug-tags
Domyślne tagi debugowania możesz zdefiniować w zmiennej środowiskowej
ANDROID_VERBOSE=socket,gles Jest to odpowiednik użycia:
lub
|
-debug-tag -debug-no-tag
|
Włącza określony typ komunikatu debugowania. Aby wyłączyć typ wiadomości debugowania, użyj formularza no . Na przykład:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics
Aby wyświetlić listę tagów, użyj polecenia |
-logcat logtags
|
Włącza wyświetlanie komunikatów Logcat w przypadku co najmniej 1 tagu i zapisuje je w oknie terminala. Na przykład to polecenie włącza komunikaty o błędach ze wszystkich komponentów:
emulator @Pixel8_API_34 -logcat *:e
Pole
W tym przykładzie wyświetlane są komunikaty komponentu GSM na poziomie logu informacyjnego:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Jeśli nie podasz opcji Więcej informacji o logcat i |
-show-kernel
|
Wyświetla komunikaty debugowania jądra w oknie terminala. Na przykład:
emulator @Pixel8_API_34 -show-kernel Jednym z przykładów zastosowania tej opcji jest sprawdzenie, czy proces uruchamiania działa prawidłowo. |
-verbose
|
Drukuje komunikaty o inicjowaniu emulatora w oknie terminala. Na przykład:
emulator @Pixel8_API_34 -verbose
Wskazuje, które pliki i ustawienia są rzeczywiście wybierane podczas uruchamiania urządzenia wirtualnego zdefiniowanego w AVD. Ta opcja jest identyczna z określeniem |
Sieć | |
-dns-server servers
|
Używa określonych serwerów DNS. servers to rozdzielana przecinkami lista maksymalnie 4 nazw serwerów DNS lub adresów IP. Na przykład: emulator @Pixel8_API_34 -dns-server 192.0.2.0,
Domyślnie emulator próbuje wykryć używane serwery DNS i konfiguruje specjalne aliasy w emulowanej sieci zapory sieciowej, aby system Android mógł łączyć się bezpośrednio z serwerami. Użyj opcji |
-http-proxy proxy
|
Łączy wszystkie połączenia TCP przez określony serwer proxy HTTP/HTTPS. Jeśli emulator musi łączyć się z internetem przez serwer proxy, możesz ustawić odpowiednie przekierowanie za pomocą tej opcji lub zmiennej środowiskowej http_proxy . Na przykład:
emulator @Pixel8_API_34 -http-proxy myserver:1981
Prefiks
Jeśli ta opcja nie zostanie podana, emulator wyszuka zmienną środowiskową |
-netdelay delay
|
Ustawia emulację opóźnienia sieci na jedną z tych wartości
Przykład: emulator @Pixel8_API_34 -netdelay gsm
Emulator obsługuje ograniczanie przepustowości sieci oraz większe opóźnienia połączeń.
Możesz go zdefiniować w konfiguracji karnacji lub za pomocą opcji |
-netfast
|
Wyłącza ograniczanie wykorzystania sieci. Na przykład:
emulator @Pixel8_API_34 -netfast
Ta opcja jest identyczna z określaniem wartości |
-netspeed speed
|
Ustawia emulację szybkości sieci. Określa maksymalne szybkości przesyłania i pobierania w sieci przy użyciu jednej z tych wartości
Przykład: emulator @Pixel8_API_34 -netspeed edge
Emulator obsługuje ograniczanie przepustowości sieci oraz większe opóźnienia połączeń.
Możesz go zdefiniować w konfiguracji karnacji lub za pomocą opcji |
-port port
|
Ustawia numer portu TCP używany przez konsolę i adb . Na przykład:
emulator @Pixel8_API_34 -port 5556
Wartość domyślna to 5554 w przypadku pierwszej instancji urządzenia wirtualnego uruchomionego w Twojej maszynie. Urządzenie wirtualne zwykle zajmuje 2 sąsiadujące porty: port konsoli i port
Przypisanie portów jest często takie samo jak określenie Opcja
Pamiętaj, że jeśli wartość |
-ports
|
Ustawia porty TCP używane przez konsolę i adb . Na przykład:
emulator @Pixel8_API_34 -ports 5556,5559
Prawidłowy zakres portów wynosi od 5554 do 5682, co pozwala na obsługę 64 równoczesnych urządzeń wirtualnych. Opcja
Zalecamy, aby w miarę możliwości używać opcji
Więcej informacji o konfigurowaniu konsoli i portów |
-tcpdump filepath
|
Przechwytuje pakiety sieciowe i zapisuje je w pliku. Na 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ć LAN Ethernet w emulatorze. Później możesz użyć narzędzia w rodzaju Wireshark, aby przeanalizować ruch. Pamiętaj, że ta opcja przechwytuje wszystkie pakiety Ethernet, a nie tylko połączenia TCP. |
System | |
-accel mode
|
Konfiguruje przyspieszenie maszyny wirtualnej emulatora. Na przykład:
emulator @Pixel8_API_34 -accel auto Emulacja przyspieszona działa tylko w przypadku obrazów systemowych w formatach x86 i x86_64. W systemie Linux korzysta z KVM. W systemach Windows i Mac OS korzysta z procesora firmy Intel i sterownika Intel HAXM. Ta opcja jest ignorowana, jeśli nie emulujesz urządzenia x86 ani x86_64.
Prawidłowe wartości dla
Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji sprzętowej emulatora Androida. |
-accel-check
|
Sprawdza, czy zainstalowany jest wymagany hipernadzorca do przyspieszenia maszyny wirtualnej emulatora (HAXM lub KVM). Na przykład:
emulator -accel-check Więcej informacji znajdziesz w artykule Sprawdzanie, czy zainstalowany jest hipernadzorca. |
-engine engine
|
Określa silnik emulatora:
Na przykład:
emulator @Pixel8_API_34 -engine auto
Funkcja automatycznego wykrywania powinna wybrać wartość, która zapewni najwyższą wydajność podczas emulacji konkretnego AVD. Opcji |
-gpu mode
|
Wybiera tryb emulacji GPU. Na przykład:
emulator @Pixel8_API_34 -gpu swiftshader_indirect Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji grafiki. |
-no-accel
|
Wyłącza przyspieszenie maszyny wirtualnej emulatora w przypadku używania obrazu systemu x86 lub x86_64. Jest przydatny tylko do debugowania i jest taki sam jak określenie właściwości -accel
off . Na przykład:
emulator @Pixel8_API_34 -no-accel Więcej informacji znajdziesz w artykule Konfigurowanie akceleracji sprzętowej emulatora Androida. |
-nojni
-no-jni
|
Wyłącza rozszerzone testy JNI (Java Native Interface) w środowisku wykonawczym Androida Dalvik lub ART. Na przykład:
emulator @Pixel8_API_34 -nojni Gdy uruchamiasz urządzenie wirtualne, rozszerzone sprawdzanie JNI jest domyślnie włączone. Więcej informacji znajdziesz we wskazówkach JNI. |
-selinux {disabled|permissive}
|
Ustawia moduł zabezpieczeń Security-Extended Linux (SELinux) w trybie disabled lub permissive w systemie operacyjnym Linux. Na przykład:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
Domyślnie SELinux działa w trybie |
-timezone timezone
|
Ustawia strefę czasową urządzenia wirtualnego na emulator @Pixel8_API_34 -timezone Europe/Paris
Domyślnie emulator używa strefy czasowej komputera, z którego korzystasz. Za pomocą tej opcji możesz określić inną strefę czasową lub jeśli automatyczne wykrywanie nie działa prawidłowo. Wartość
Podana strefa czasowa musi znajdować się w bazie danych stref informacji. |
-version
|
Wyświetla numer wersji emulatora. Na przykład:
emulator @Pixel8_API_34 -version lub
emulator -version |
Interfejs użytkownika | |
-no-boot-anim
|
Wyłącza animację rozruchu podczas uruchamiania emulatora, aby przyspieszyć rozruch.
Na przykład:
emulator @Pixel8_API_34 -no-boot-anim Na wolniejszych komputerach ta opcja może znacznie przyspieszyć sekwencję uruchamiania. |
-screen mode
|
Ustawia tryb emulowanego ekranu dotykowego. Na przykład:
emulator @Pixel8_API_34 -screen no-touch
|
Opcje zaawansowane
Opcje uruchamiania wiersza poleceń wymienione w poniższej tabeli są dostępne, ale przeciętny deweloper aplikacji rzadko z nich korzysta.
W opisach katalog roboczy to bieżący katalog w terminalu, w którym wpisujesz polecenia. Informacje o katalogu systemu AVD i katalogu danych oraz plikach przechowywanych w nich znajdziesz w sekcji o katalogach i plikach domyślnych.
Niektóre z nich są odpowiednie dla zewnętrznych deweloperów aplikacji, a inne są używane głównie przez deweloperów platform. Programiści aplikacji tworzą aplikacje na Androida i uruchamiają je na określonych urządzeniach AVD. Programiści platform pracują w systemie Android i uruchamiają go w emulatorze bez gotowego narzędzia AVD.
Opcja zaawansowana | Krótki opis |
---|---|
-bootchart timeout
|
Włącza rozruchowy schemat z limitem czasu w sekundach. Niektóre obrazy systemu Androida mają zmodyfikowany system inicjowania, który integruje funkcję uruchamiania kodu rozruchowego. Za pomocą tej opcji możesz przekazać do systemu czas oczekiwania na kod rozruchowy. Jeśli w systemie inicjującym nie jest włączone debugowanie rozruchowe, ta opcja nie ma żadnego efektu. Ta opcja jest przydatna głównie dla deweloperów platformy, a nie dla zewnętrznych deweloperów aplikacji. Na przykład: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
Wskazuje plik obrazu partycji pamięci podręcznej. Podaje nazwę pliku i ścieżkę bezwzględną lub ścieżkę względną do katalogu danych, aby skonfigurować plik trwałej 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ślną wartością będzie plik tymczasowy o nazwie |
-cache-size size
|
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, wartość domyślna to 66 MB. Zwykle większość deweloperów aplikacji nie potrzebuje tej opcji, chyba że muszą 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 katalogu danych AVD. |
-data filepath
|
Konfiguruje plik obrazu partycji danych użytkownika. Podaje nazwę pliku i ś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 utworzy obraz na podstawie domyślnego pliku 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 będzie używany plik o nazwie |
-datadir dir
|
Wskazuje katalog danych przy użyciu ścieżki bezwzględnej. Więcej informacji znajdziesz w katalogu danych AVD. Na przykład: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit
|
Używa emulatora 32-bitowego na platformach 64-bitowych. Czasami ta opcja jest przydatna przy testowaniu lub debugowaniu. Chodziło np. o to, że w 64-bitowym systemie Windows emulator czasem nie działał, a w wersji 32-bitowej – działał. Ta opcja była przydatna podczas porównań w celu debugowania problemu. Oto przykład: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Uzyskuje pomoc dotyczącą obrazów dysków. Ta opcja dostarcza informacji przydatnych zarówno dla deweloperów aplikacji, jak i platformy. Na przykład: emulator -help-disk-images |
-help-char-devices
|
Uzyskiwanie pomocy dotyczącej specyfikacji znaków emulator -help-char-devices |
-help-sdk-images
|
Uzyskuje pomoc dotyczącą obrazów dysków istotnych dla deweloperów aplikacji. Ta opcja umożliwia uzyskanie informacji o tym, gdzie znajdują się pliki graficzne na potrzeby AVD utworzonego przy użyciu narzędzi pakietu SDK. Na przykład: emulator -help-sdk-images |
-help-build-images
|
Uzyskuje pomoc dotyczącą obrazów dysków przydatnych dla deweloperów platformy. Na przykład: emulator -help-build-images |
-initdata filepath -init-data
filepath
|
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 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 katalogu systemowym AVD. |
-kernel filepath
|
Korzysta z konkretnego emulowanego jądra. Jeśli nie podasz ścieżki, emulator poszuka w katalogu systemowym. Użyj opcji‑show‑kernel , aby wyświetlić komunikaty debugowania jądra.
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 określisz tej opcji, domyślna wartość to |
-noaudio
-no-audio
|
Wyłącza obsługę dźwięku na tym urządzeniu wirtualnym. Niektóre komputery z systemem Linux i Windows mają uszkodzone sterowniki dźwięku, które powodują różne objawy, np. uniemożliwiają uruchomienie emulatora. W takim przypadku użyj tej opcji, aby rozwiązać problem. Do zmiany backendu audio możesz też użyć zmiennej środowiskowej Na przykład: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Uruchamia emulator bez partycji pamięci podręcznej. Jeśli nie użyjesz tej opcji, domyślną opcją będzie plik tymczasowy o nazwie Na przykład: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Blokuje zarówno operacje automatycznego wczytywania, jak i zapisywania, przez co emulator wykonuje pełną sekwencję rozruchu i traci swój stan po zamknięciu. Zastępuje opcję Na przykład: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
Uniemożliwia emulatorowi wczytywanie stanu AVD z pamięci zrzutów. Wykonuje pełny rozruch. Na przykład: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
Uniemożliwia emulatorowi zapisanie stanu AVD w pamięci zrzutów po zamknięciu, co oznacza, że wszystkie zmiany zostaną utracone. Na przykład: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
Nie podejmuje próby skorygowania czasu AVD natychmiast po przywróceniu zrzutu. Ta opcja może być przydatna podczas testowania, ponieważ pozwala uniknąć nagłych skoków 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 |
-no-snapstorage
|
Uruchamia emulator bez podłączania pliku do przechowywania lub wczytywania zrzutów stanu. Wymusza to pełny rozruch i wyłącza funkcję zrzutów stanu. Ta opcja zastępuje opcje Na przykład: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
Wyłącza graficzne wyświetlanie okien w emulatorze. Ta opcja jest przydatna przy uruchamianiu emulatora na serwerach, które nie mają wyświetlacza. Dostęp do emulatora możesz uzyskać w emulator @Pixel8_API_34 -no-window |
-partition-size size
|
Określa rozmiar partycji danych systemowych w MB. Na przykład: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
Konfiguruje w emulatorze właściwość systemu Android po jego uruchomieniu.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
Przekazuje argumenty do oprogramowania emulatora QEMU. Jeśli używasz tej opcji, sprawdź, czy jest to ostatnia określona opcja, ponieważ wszystkie kolejne opcje są interpretowane jako opcje związane z QEMU. Ta opcja jest dość zaawansowana, więc powinni z niej korzystać tylko deweloperzy, którzy bardzo znają QEMU oraz emulację Androida. |
-qemu -h
|
Wyświetla pomoc dotyczącą funkcji emulator -qemu -h |
-ramdisk filepath
|
Określa obraz rozruchowy dysku ramdisk. Określa nazwę pliku i ścieżkę bezwzględną lub względną ścieżkę 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ślną wartością będzie plik |
-report-console socket
|
Przed rozpoczęciem emulacji zgłasza port konsoli zdalnej firmie zewnętrznej. Może być przydatna w przypadku skryptu automatycznego testowania.
Aby uzyskać więcej informacji, użyj opcji |
-shell
|
Tworzy główną konsolę powłoki w bieżącym terminalu. Ta opcja różni się od polecenia
Na przykład: emulator @Pixel8_API_34 -shell |
-snapshot name
|
Określa nazwę zrzutu w pliku magazynu zrzutów na potrzeby operacji automatycznego uruchamiania i zapisywania. Zamiast wykonywać pełną sekwencję rozruchu, emulator może wznowić wykonywanie od wcześniejszego zrzutu stanu, co zwykle jest znacznie szybsze. Gdy podasz tę opcję, emulator wczyta zrzut tej nazwy z obrazu zrzutu i zapisze go z powrotem pod tą samą nazwą przy wyjściu. Jeśli nie użyjesz tej opcji, domyślną opcją jest pełna sekwencja rozruchu. Jeśli określony zrzut nie istnieje, emulator wykonuje pełną sekwencję rozruchu i wykonuje operację zapisu. Informacje na temat określania pliku pamięci masowej zrzutu oraz pliku domyślnego znajdziesz w sekcji emulator @Pixel8_API_34 -snapshot snapshot2 Pamiętaj, że podczas wczytywania zrzutu cała zawartość systemu, dane użytkownika i obrazy karty SD są zastępowane zawartością zapisaną podczas tworzenia zrzutu. Jeśli nie zapiszesz tych informacji w innym zrzucie dysku, wszystkie wprowadzone od tego czasu zmiany zostaną utracone. Zrzut możesz też utworzyć w konsoli emulatora za pomocą polecenia |
-snapshot-list
|
Wyświetla listę dostępnych zrzutów. To polecenie powoduje wyświetlenie tabeli zrzutów zapisanych w pliku pamięci zrzutów, od którego został uruchomiony emulator, a następnie zostaje zamknięty. Jeśli podasz także Na przykład: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Wartości z kolumn ID i TAG w danych wyjściowych możesz użyć jako argumentów opcji |
-snapstorage filepath
|
Określa plik repozytorium zawierający wszystkie zrzuty stanu. W tym pliku są zapisywane wszystkie zrzuty wykonane podczas wykonywania. 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 przyjęta zostanie wartość |
-sysdir dir
|
Wskazuje katalog systemowy przy użyciu ścieżki bezwzględnej. Więcej informacji znajdziesz w katalogu systemowym AVD. Na przykład: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath
|
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ślną wartością będzie plik |
-use-system-libs
|
W systemie Linux używana jest systemowa Na przykład: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-system
|
Użyj tej opcji, by podczas sesji emulacji mieć możliwość zapisu obrazu systemu. Aby to zrobić:
Użycie tej flagi spowoduje utworzenie tymczasowej kopii obrazu systemu, który może być bardzo duży (do kilkuset MB), ale zostanie zniszczony po zamknięciu emulatora. |
Wycofane opcje
Te opcje wiersza poleceń zostały wycofane:
-audio-in
-audio-out
-charmap
-code-profile
-cpu-delay
-dpi-device
-dynamic_skin
-enable-kvm
-gps
-image
-keyset
-help-keys
-help-keyset-file
-nand-limits
-noskin
-no-skin
-onion
-onion-alpha
-onion-rotation
-radio
-ranchu
-raw-keys
-scale
-shared-net-id
-shell-serial
-skin
-skindir
-trace
-useaudio
Pomoc dotycząca opcji wiersza poleceń
W tej sekcji opisaliśmy, jak uzyskać pomoc dotyczącą opcji wiersza poleceń. Zawiera ona bardziej szczegółowe informacje o najczęściej używanych opcjach wiersza poleceń emulatora, które są dostępne po uruchomieniu emulatora.
Wyświetl wszystkie opcje emulatora
Aby wydrukować listę wszystkich opcji emulatora, w tym krótki opis, wpisz to polecenie:
emulator -help
Uzyskiwanie szczegółowej pomocy dotyczącej konkretnej opcji
Aby wydrukować pomoc dotyczącą określonej opcji uruchamiania, wpisz to polecenie:
emulator -help-option
Na przykład:
emulator -help-netspeed
Ta pomoc jest bardziej szczegółowy niż opis dostępny w opcji -help
.
Szczegółowa pomoc dotycząca wszystkich opcji
Aby uzyskać szczegółową pomoc dotyczącą wszystkich opcji emulatora, wpisz następujące polecenie:
emulator -help-all
Wyświetlenie listy zmiennych środowiskowych emulatora
Aby wyświetlić listę zmiennych środowiskowych emulatora, wpisz następujące polecenie:
emulator -help-environment
Zmienne środowiskowe możesz ustawić w oknie terminala przed uruchomieniem urządzenia wirtualnego. Możesz też skonfigurować je w ustawieniach użytkownika w systemie operacyjnym. Możesz ją na przykład ustawić w pliku .bashrc
na Linuksie.
Wyświetl listę tagów debugowania
Aby wydrukować listę tagów dla opcji -debug
, wpisz to polecenie:
emulator -help-debug-tags
Opcje -debug
umożliwiają włączanie i wyłączanie komunikatów debugowania pochodzących z określonych komponentów emulatora określonych w tagach.