Android SDK 提供 Android 裝置模擬器,也就是虛擬裝置 是在電腦上運作的Android Emulator 可讓您 不必使用實體裝置的 Android 應用程式。
本頁將說明您可以與以下項目搭配使用的指令列功能: Android Emulator。 如要進一步瞭解如何使用 Android Emulator UI,請參閱 在 Android Emulator 上執行應用程式。
啟動模擬器
使用 emulator
指令啟動模擬器,做為替代方案
執行您的專案或
可透過 AVD Manager 啟動。
以下是從終端機提示中,啟動虛擬裝置的基本指令列語法:
emulator -avd avd_name [ {-option [value]} … ]
或
emulator @avd_name [ {-option [value]} … ]
例如,如果您是透過在 Mac 上執行的 Android Studio 啟動模擬器,預設指令列會如下所示:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
請注意, -qt-hide-window -grpc-use-token -idle-grpc-timeout
引數只會用於在 Android Studio 中執行模擬器視窗。如果您想在專屬視窗執行模擬器,請勿使用這些額外參數。
您可以在啟動模擬器時指定啟動選項,但無法在啟動模擬器後指定啟動選項。
如要查看 AVD 名稱清單,請輸入下列指令:
emulator -list-avds
這個選項會顯示 Android 主目錄中的 AVD 名稱清單。設定 ANDROID_SDK_HOME
即可覆寫預設的主目錄
這個環境變數會指定
儲存所有設定和 AVD 內容的使用者專屬目錄。
您可以在啟動
或透過作業系統中的使用者設定
有些人會將 Cloud Storage 視為檔案系統
但實際上不是例如,在 Linux 上的 .bashrc
檔案中。
如要停止執行 Android Emulator,只要關閉模擬器視窗即可。
安裝應用程式
不僅可透過 Android Studio 或模擬器安裝應用程式
UI,您可以使用 adb
公用程式,在虛擬裝置上安裝應用程式。
如要使用 adb
安裝、執行及測試應用程式,
請按照下列一般步驟操作:
- 按照「建立並執行 app。
- 按照上文所述,透過指令列啟動模擬器 部分中使用任何必要的啟動選項。
- 使用
adb
安裝應用程式。 - 在模擬器上執行及測試應用程式。
儘管模擬器處於 執行時,您可以使用 Emulator 控制台,視需要下達指令。
解除安裝應用程式的做法與在 Android 裝置上相同。
虛擬裝置會在重新啟動後保留應用程式及其狀態資料
寫入使用者資料磁碟分區 (userdata-qemu.img
) 內。如要清除這項資訊
資料,使用 -wipe-data
選項啟動模擬器,或抹除
也就是 AVD Manager 中的資料進一步瞭解使用者資料
磁碟分割,請參閱下一節。
注意:adb
公用程式會將虛擬裝置顯示為
實作實體裝置因此,您可能必須使用
-d
旗標,搭配一些常見的 adb
指令,例如
install
。-d
旗標可用來指定
作為指令目標的已連結裝置。如果沒有指定
-d
,模擬器會指定清單中的第一部裝置。
瞭解預設目錄和檔案
模擬器會使用相關聯的檔案,其中含有 AVD 系統和資料目錄 是最重要的瞭解模擬器目錄結構會很有幫助 和檔案。不過,通常 則需要修改預設目錄或檔案
Android Emulator 採用 (QEMU) 管理程序。
AVD 系統目錄
系統目錄包含模擬器使用的 Android 系統映像檔 來模擬作業系統這個目錄有平台專屬的唯讀檔案 由所有相同類型 AVD 共用,包括 API 級別、CPU 架構 Android 變化版本。預設位置如下:
- macOS 和 Linux -
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/
- Windows -
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
其中:
apiLevel
是數字 API 級別,或是 預先發布版。例如,android-V
表示 Android VanillaIceCream 預覽畫面。在發布時,會變成 API 級別 35 (由android-35
。variant
這個名稱的例子包括google_apis
或android-wear
,會對應由系統映像檔執行的特定功能。arch
是目標 CPU 架構。例如x86
。
請使用 -sysdir
選項指定用於 AVD 的不同系統目錄。
模擬器會從系統目錄中讀取下列檔案:
檔案 | 說明 | 指定不同檔案的選項 |
---|---|---|
kernel-qemu 或 kernel-ranchu
|
AVD 的二進位核心映像檔。kernel-ranchu 採用根據
QEMU 模擬器。
|
-kernel
|
ramdisk.img
|
啟動分區映像檔。這是 system.img 的子集
核心先載入,然後才掛接系統映像檔。通常只會包含一些二進位檔與初始化指令碼。
|
-ramdisk
|
system.img
|
系統映像檔的唯讀初始版本。具體而言, 包含系統程式庫和對應 API 級別資料的分區 和子類 | -system
|
userdata.img
|
資料分區的初始版本,如下所示:
模擬系統中的 data/ ,其中包含該實體的
AVD:在建立新的 AVD 或使用
‑wipe-data 選項。詳情請參閱
以下部分中的 userdata-qemu.img 檔案說明。
|
-initdata
-init-data
|
AVD 資料目錄
AVD 資料目錄 (又稱為內容目錄) 是單一 AVD 執行個體專有的資訊,其中包含 AVD 的所有可修改資料。
預設位置如下,其中 name
是 AVD 名稱:
- macOS 和 Linux -
~/.android/avd/name.avd/
- Windows 10 以上版本 -
C:\Users\user\.android\name.avd\
請使用 -datadir
選項指定不同的 AVD 資料目錄。
下表列出此目錄包含的最重要檔案:
檔案 | 說明 | 指定不同檔案的選項 |
---|---|---|
userdata-qemu.img
|
資料分區的內容,在以下項目中會顯示為
每個虛擬裝置執行個體都會使用可寫入的使用者資料映像檔來儲存使用者和
特定工作階段資料例如,它會使用圖片來儲存不重複使用者
已安裝的應用程式資料、設定、資料庫和檔案。每位使用者都有
不同的 |
-data
|
cache.img
|
快取分區映像檔,在cache/
模擬系統在您首次建立 AVD 或使用
-wipe-data 選項。這個檔案會儲存暫存的下載檔案,
填入下載管理員,有時則是系統。舉例來說,
在模擬器執行期間,瀏覽器會將其用於快取下載的網頁和圖片
備用資源虛擬裝置關機後,系統會刪除該檔案。你可以
使用 -cache 選項保留檔案。
|
-cache
|
sdcard.img
|
(選用) SD 卡分區映像檔,可讓您模擬 SD 卡
安裝在虛擬裝置上您可以在 AVD 建立 SD 卡映像檔
管理員或使用
在 AVD Manager 中定義 AVD 時,您可以選擇
使用系統自動管理的 SD 卡檔案
你可以瀏覽、傳送、複製及移除模擬 SD 標準畫質的檔案
透過模擬器 UI 或
如要在載入 SD 卡前將檔案複製到 SD 卡檔案中,請掛接映像檔
將檔案視為迴圈裝置,再複製這些檔案或者,您也可以使用公用程式,例如
模擬器會將檔案視為位元組集區,因此 SD 卡格式沒有任何影響。
|
-sdcard
|
列出模擬器使用的目錄和檔案
您可以透過下列兩種方式找出檔案所在位置:
- 使用
-verbose
或-debug init
選項;當您透過 指令列接著查看輸出內容。 - 使用
emulator
-help-option
指令: 列出預設目錄例如: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.
指令列啟動選項
本節列出啟動 模擬器。
注意:Android Emulator 仍持續不斷的開發, 也更加可靠針對各種指令列選項回報的問題狀態說明 如要回報錯誤,請參閱 Android Issue Tracker。
常用選項
下表列出經常使用的指令列啟動選項:
指令列選項 | 說明 |
---|---|
Quick Boot | |
-no-snapshot-load
|
執行冷啟動,並在結束時儲存模擬器狀態。 |
-no-snapshot-save
|
盡可能執行 Quick Boot,但不會在結束時儲存模擬器狀態。 |
-no-snapshot
|
完全停用 Quick Boot 功能,且不會載入或儲存模擬器狀態。 |
裝置硬體 | |
-camera-back mode -camera-front mode
|
設定後置或前置相機鏡頭的模擬模式。這會覆寫 AVD 中的任何相機設定。
例如: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
列出開發電腦中可供模擬的網路攝影機。適用對象
範例: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' 在此範例中,第一個 截至 SDK Tools 25.2.4 為止,您必須提供 AVD 名稱。 |
磁碟映像檔和記憶體 | |
-memory size
|
指定 1536 至 8192 MB 的實體 RAM 大小。例如: emulator @Pixel8_API_34 -memory 2048 此數值會覆寫 AVD 設定。 |
-sdcard filepath
|
指定 SD 卡分區映像檔的檔案名稱和路徑。適用對象
範例:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img 如果找不到這個檔案,模擬器仍會啟動,但不會顯示 SD 卡,指令會傳回「No SD Card Image」警告。
如果您未指定此選項,則預設值為資料目錄中的 |
-wipe-data
|
在初始資料檔案中刪除使用者資料及複製資料。這個選項
清除虛擬裝置的資料,並將資料復原為
因此才真正定義目標系統會移除所有已安裝的應用程式和設定。例如:
emulator @Pixel8_API_34 -wipe-data
根據預設,使用者資料檔案為 |
偵錯 | |
-debug tags
|
顯示或不顯示一或多個標記的偵錯訊息。請用空格、半形逗號或欄分隔多個標記。例如:
$ emulator @Pixel8_API_34 -debug init,metrics 如要停用標記,請在標記前面加上破折號 (-);舉例來說,以下選項會顯示所有偵錯訊息,但有關網路通訊端和指標的訊息除外:
如需標記與說明的清單,請使用
emulator -help-debug-tags
您可以在
ANDROID_VERBOSE=socket,gles 等同於使用:
或
|
-debug-tag -debug-no-tag
|
啟用特定偵錯訊息類型。使用 no 表單:
停用偵錯訊息類型例如:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics
如要查看標記清單,請使用 |
-logcat logtags
|
顯示一或多個標記及寫入的 Logcat 訊息
連線至終端機視窗舉例來說,下列指令會啟用錯誤
來自所有元件的訊息:
emulator @Pixel8_API_34 -logcat *:e
下列範例顯示資訊記錄等級的 GSM 元件訊息:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
如果您在指令列中沒有提供 如要
如要進一步瞭解 Logcat 和 |
-show-kernel
|
在終端機視窗中顯示核心偵錯訊息。例如:
emulator @Pixel8_API_34 -show-kernel 這個選項的其中一個用途是檢查啟動程序是否正確運作。 |
-verbose
|
將模擬器初始化訊息列印至終端機視窗。適用對象
範例:
emulator @Pixel8_API_34 -verbose
這項功能會顯示啟動時,實際選取的檔案和設定
AVD 中定義的虛擬裝置。這個選項與指定
|
網路 | |
-dns-server servers
|
使用指定的 DNS 伺服器。servers 是
以半形逗號分隔的清單,最多包含四個 DNS 伺服器名稱或 IP 位址。適用對象
範例:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
根據預設,模擬器會嘗試偵測您使用的 DNS 伺服器,並為其設定
建立模擬防火牆網路中的特殊別名,以便 Android 系統
可直接連線至伺服器使用 |
-http-proxy proxy
|
透過指定的 HTTP/HTTPS Proxy 建立所有 TCP 連線。如果您的
模擬器必須透過 Proxy 伺服器存取網際網路,您可以使用這個
選項,或是使用 http_proxy 環境變數來設定
以及適當的重新導向例如:
emulator @Pixel8_API_34 -http-proxy myserver:1981
如未提供此選項,模擬器會查詢 |
-netdelay delay
|
將網路延遲模擬設為下列其中一個值
例如: emulator @Pixel8_API_34 -netdelay gsm
模擬器支援網路節流以及較長的連線延遲時間。
您可以透過外觀設定 或
「 |
-netfast
|
停用網路節流功能。例如:
emulator @Pixel8_API_34 -netfast
此選項與指定 |
-netspeed speed
|
設定網路速度模擬。指定最大網路上傳量和
下載速度為下列其中一個
例如: emulator @Pixel8_API_34 -netspeed edge
模擬器支援網路節流以及較長的連線延遲時間。
您可以透過外觀設定 或
「 |
-port port
|
設定主控台和 adb 所用的 TCP 通訊埠編號。例如:
emulator @Pixel8_API_34 -port 5556
如果是在 VM 上執行的第一個虛擬裝置執行個體,預設值為 5554
虛擬機器虛擬裝置通常會佔用一對相鄰的通訊埠:
以及
通訊埠指派作業通常與指定
請注意,如果 |
-ports
|
設定主控台和 adb 所用的 TCP 通訊埠。例如:
emulator @Pixel8_API_34 -ports 5556,5559
有效的通訊埠範圍為 5554 至 5682,允許 64 個虛擬主機並行
裝置。
建議您盡可能改用
如要進一步瞭解如何設定主控台和 |
-tcpdump filepath
|
擷取網路封包並儲存至檔案中。例如:
emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap 使用這個選項即可開始擷取透過 模擬器的虛擬乙太網路 LAN之後,您可以使用 Wireshark 等工具 以便分析流量 請注意,此選項會擷取所有乙太網路封包,並不限於 TCP 連線。 |
系統 | |
-accel mode
|
設定模擬器 VM 加速功能。例如:
emulator @Pixel8_API_34 -accel auto 加速模擬僅適用於 x86 和 x86_64 系統映像檔。在 Linux 上 都仰賴 KVM 執行在 Windows 和 Mac 上,則仰賴 Intel CPU 和 Intel HAXM 驅動程式。如果您不模擬 x86 或 x86_64 裝置,可忽略此選項。
|
-accel-check
|
檢查模擬器 VM 加速功能的必要管理程序是否為
安裝 (HAXM 或 KVM)。例如:
emulator -accel-check 詳情請參閱「檢查是否已安裝管理程序」一文。 |
-engine engine
|
指定模擬器引擎:
例如:
emulator @Pixel8_API_34 -engine auto
自動偵測應選擇在何時採用最佳成效
模擬特定 AVD。針對以下項目使用 |
-gpu mode
|
選取 GPU 模擬模式。例如:
emulator @Pixel8_API_34 -gpu swiftshader_indirect 詳情請參閱「設定圖形加速功能」一文。 |
-no-accel
|
使用 x86 或 x86_64 系統時,停用模擬器 VM 加速功能
圖片。這項功能僅適用於偵錯,且效果與指定 -accel
off 相同。例如:
emulator @Pixel8_API_34 -no-accel |
-nojni
-no-jni
|
停用 Android Dalvik 中的擴充 Java Native Interface (JNI) 檢查
或 ART 執行階段例如:
emulator @Pixel8_API_34 -nojni 啟動虛擬裝置時,系統會預設啟用擴充 JNI 檢查。適用對象 詳情請參閱 JNI 提示。 |
-selinux {disabled|permissive}
|
設定安全增強式 Linux (SELinux)
Linux 作業系統中的安全性模組至 disabled 或 permissive 模式
有些人會將 Cloud Storage 視為檔案系統
但實際上不是例如:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
根據預設,SELinux 進入 |
-timezone timezone
|
將虛擬裝置的時區設為
emulator @Pixel8_API_34 -timezone Europe/Paris
在預設情況下,模擬器會採用開發電腦的時區。使用
此選項可以指定不同的時區,或是否沒有自動偵測系統
正常運作。
指定的時區必須存在於 Zoneinfo 資料庫中。 |
-version
|
顯示模擬器版本號碼。例如:
emulator @Pixel8_API_34 -version 或
emulator -version |
UI | |
-no-boot-anim
|
在模擬器啟動期間停用啟動動畫,藉此加快啟動速度。
例如:
emulator @Pixel8_API_34 -no-boot-anim 在速度較慢的電腦上,此選項可大幅加快啟動序列的速度。 |
-screen mode
|
設定模擬觸控螢幕模式。例如:
emulator @Pixel8_API_34 -screen no-touch
|
進階選項
系統提供下表所列的指令列啟動選項,但不常使用 對一般應用程式開發人員來說
在說明中,工作目錄是指 執行輸入指令的終端機如需 AVD 相關資訊 系統目錄和資料目錄 請參閱「預設目錄和檔案」一節。
其中部分選項適合外部應用程式開發人員使用 這些 API 主要供平台開發人員使用應用程式開發人員建立 Android 應用程式,並在特定的 AVD 上執行。平台開發人員 並在沒有預先建立的 AVD 的模擬器中執行。
進階選項 | 簡短說明 |
---|---|
-bootchart timeout
|
啟用 bootcharting,並以秒為單位設定逾時。部分 Android 系統 映像檔使用經過修改的 init 系統,其中整合了 bootcharting 功能。您可以將 使用此選項向系統啟動 bootcharting 逾時期間。如果您的 init 系統 未啟用 bootcharting,則這個選項不會有任何作用。這個選項 主要適用於平台開發人員,而非外部應用程式開發人員。 例如: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
指定快取分區映像檔。提供檔案名稱和絕對路徑 設定永久快取時,資料目錄的相對路徑或路徑 檔案。如果檔案不存在,模擬器會建立一個空白檔案。 例如: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img 如果您不使用這個選項,則預設會使用一個名為
|
-cache-size size
|
設定快取分區的大小 (以 MB 為單位)。 例如: emulator @Pixel8_API_34 -cache-size 1000 如果您不 指定此選項,預設值為 66 MB。大多數應用程式開發人員通常不需要使用這個選項。 除非使用者需要下載大於預設值的 大型檔案 快取。如要進一步瞭解快取 檔案,請參閱「AVD 資料目錄」。 |
-data filepath
|
設定使用者資料分區映像檔。提供檔案名稱和
絕對路徑或相對於工作目錄的路徑
永久性使用者資料檔案如果檔案不存在,模擬器會建立一個
預設 例如: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img 如果您不使用這個選項,系統預設會使用名為 |
-datadir dir
|
使用絕對路徑指定資料目錄。如需更多資訊 請參閱「AVD 資料目錄」。 例如: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit
|
在 64 位元平台上使用 32 位元模擬器。有時這個選項 以用於測試或偵錯舉例來說, 模擬器有時無法在 64 位元 Windows 上執行,但 32 位元可以執行。這個 選項有助於進行比較以偵錯。以下是 範例: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
取得磁碟映像檔相關說明。這個選項會提供 和應用程式平台開發人員例如: emulator -help-disk-images |
-help-char-devices
|
取得字元 emulator -help-char-devices |
-help-sdk-images
|
取得與應用程式開發人員相關的磁碟映像檔說明。這個選項可讓您 使用 和 SDK 工具搭配使用例如: emulator -help-sdk-images |
-help-build-images
|
取得與平台開發人員相關的磁碟映像檔說明。例如: emulator -help-build-images |
-initdata filepath -init-data
filepath
|
指定資料分區的初始版本。清除後
使用者資料時,模擬器會將指定檔案的內容複製到使用者
資料 (預設為 例如: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img 如果您未指定路徑,系統會將該檔案置於系統目錄中。如要 請參閱「AVD 系統目錄」。 |
-kernel filepath
|
使用特定模擬核心。如果未指定路徑 並查看系統目錄中 使用‑show‑kernel 選項可查看核心偵錯訊息。
例如: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel 如果未指定此選項,則預設值為 |
-noaudio
-no-audio
|
停用此虛擬裝置的音訊支援功能。部分 Linux 和 Windows
電腦內含錯誤的音訊驅動程式,而造成各種不同症狀
防止模擬器啟動在這種情況下,您可以使用這個選項
克服這個問題或者,您也可以使用 例如: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
在沒有快取分區的情況下啟動模擬器。如果不使用
選項,預設是名為 例如: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
禁止自動載入和儲存作業,導致模擬器
執行完整的啟動序列,並在關閉時遺失其狀態。會覆寫
例如: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
防止模擬器從快照儲存空間載入 AVD 狀態。 這會執行完整啟動程序。 例如: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
防止模擬器將 AVD 狀態儲存至快照儲存空間 退出,表示所有變更都會遺失。 例如: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
請勿嘗試在還原快照時立即修正 AVD 時鐘時間。 這個選項在測試時非常實用,因為可避免時間突然跳轉。 系統大約每 15 秒仍會將時間更新傳送給 AVD。 例如: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage
|
在不掛接檔案的情況下啟動模擬器,以便儲存或載入狀態
藉此強制執行完整啟動程序及停用狀態快照功能。這個
選項會覆寫 例如: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
停用模擬器的圖形視窗顯示功能。這個選項非常實用
在沒有螢幕的伺服器上執行模擬器時建議採用這個做法。如要存取模擬器,請執行下列操作:
emulator @Pixel8_API_34 -no-window |
-partition-size size
|
指定系統資料分區的大小 (以 MB 為單位)。例如: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
設定模擬器啟動時的 Android 系統屬性。
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
將引數傳遞至 QEMU 模擬器軟體。使用這個選項時,請確認這是最後一個欄位 選項,因為之後的所有選項都會視為 QEMU 專用 只要設定成「自動重新啟動」 和「在主機維護期間」選項即可這個選項進階程度極高,僅供符合下列條件的開發人員使用 非常熟悉 QEMU「和」Android 模擬功能。 |
-qemu -h
|
顯示 emulator -qemu -h |
-ramdisk filepath
|
指定 ramdisk 開機映像檔。指定檔案名稱和絕對路徑 或是相對於工作目錄的路徑 例如: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img 如果您不使用這個選項,
預設為系統目錄中的 |
-report-console socket
|
在開始前,向遠端第三方回報主控台通訊埠
模擬。這對於自動化測試指令碼來說非常實用。
如需詳細資訊,請使用 |
-shell
|
在目前的終端機上建立根層級的殼層主控台。不過這個選項與
例如: emulator @Pixel8_API_34 -shell |
-snapshot name
|
指定用於自動處理的快照儲存檔案中的快照名稱 開始和儲存作業 與其執行完整的啟動序列, 模擬器可以從更早的狀態快照恢復執行 通常速度會明顯快許多提供此選項時,模擬器 從快照映像檔載入該名稱的快照並加以儲存 離開同一個名稱 如果您不使用這個選項,系統會採用預設值 完整的啟動序列如果指定的快照不存在, 模擬器會改為執行完整的啟動序列,並 儲存作業。 如要瞭解詳請,請參閱 emulator @Pixel8_API_34 -snapshot snapshot2 請記住,在快照載入過程中 遭覆寫系統、使用者資料和 SD 卡映像檔的所有內容 當中包含快照建立時保留的內容除非你儲存 複製到另一個快照中,之後的所有變更都會遺失。 您也可以使用模擬器主控台建立快照,
|
-snapshot-list
|
顯示可用快照的清單。這個指令會列印快照資料表
儲存在模擬器啟動的快照儲存空間檔案中
,然後結束如果指定 例如: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img 您可以在輸出內容中使用 ID 和 TAG 欄的值
做為 |
-snapstorage filepath
|
指定包含所有狀態快照的存放區檔案。所有語言 執行期間建立的快照會儲存在這個檔案中。僅限 系統會在模擬器執行期間還原這個檔案中的快照。 例如: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img 如果未指定這個選項,則預設為資料中的 |
-sysdir dir
|
使用絕對路徑指定系統目錄。如需更多資訊 請參閱「AVD 系統目錄」。 例如: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath
|
指定初始系統檔案。請提供檔案名稱和絕對路徑 或是相對於工作目錄的路徑 例如: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img 如果您不使用這個選項,
預設為系統目錄中的 |
-use-system-libs
|
在 Linux 上請使用系統 例如: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-system
|
選取這個選項後,即可在模擬工作階段中建立可寫入的系統映像檔。方法如下:
使用此旗標會建立系統映像檔的暫存副本 可能相當大,上限為數百 MB,但在模擬器後會刪除 退出。 |
已淘汰的選項
下列指令列選項皆已淘汰:
-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
取得指令列選項相關說明
本節說明如何取得指令列選項的相關說明。這項服務 我們會詳細說明 啟動模擬器時可用的模擬器指令列選項。
列出所有模擬器選項
如要列印所有模擬器選項的清單 (包括簡短說明),請輸入 以下指令:
emulator -help
取得特定選項的詳細說明
如要列印特定啟動選項的說明,請輸入下列指令:
emulator -help-option
例如:
emulator -help-netspeed
這項說明比 -help
選項提供的說明更加詳盡。
取得所有選項的詳細說明
如要取得所有模擬器選項的詳細說明,請輸入下列指令:
emulator -help-all
列出模擬器環境變數
如要取得模擬器環境變數的清單,請輸入下列指令:
emulator -help-environment
您可以在啟動虛擬裝置之前,在終端機視窗中設定環境變數,或是透過作業系統中的使用者設定來設定環境變數;例如在 Linux 上的 .bashrc
檔案中進行設定。
列出偵錯標記
如要列印 -debug
選項的標記清單,請輸入下列指令:
emulator -help-debug-tags
-debug
選項可讓您依標記指定項目,啟用或停用來自特定模擬器元件的偵錯訊息。