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