透過指令列啟動模擬器

資料分區的內容在模擬系統中會顯示為 data/。建立新的 AVD，或使用 -wipe-data 選項將 AVD 重設為原廠預設值時，模擬器會複製系統目錄中的 userdata.img 檔案來建立這個檔案。

每個虛擬裝置執行個體都會使用可寫入的使用者資料映像檔，儲存使用者和工作階段專屬資料。例如，它會使用映像檔來儲存每位使用者安裝的應用程式資料、設定、資料庫和檔案。每位使用者都有不同的 ANDROID_SDK_HOME 目錄，用於儲存該使用者建立的 AV 資料目錄。每個 AVD 都有一個 userdata-qemu.img 檔案。

(選用) SD 卡分區映像檔，可讓您在虛擬裝置上模擬 SD 卡。您可以在 AVD Manager 或使用 mksdcard 工具建立 SD 卡映像檔。檔案會儲存在您開發的電腦上，且必須在啟動時載入。

在 AVD Manager 中定義 AVD 時，您可以選擇使用系統自動管理的 SD 卡檔案，或是使用 mksdcard 工具建立的檔案。您可以在 AVD Manager 中檢視與 AVD 關聯的 sdcard.img 檔案。-sdcard 選項會覆寫 AVD 中指定的 SD 卡檔案。請注意，這個 SD 卡選項不適用於搭載 Apple 晶片的 Mac。

在虛擬裝置執行期間，您可以使用模擬器 UI 或 adb 公用程式，瀏覽、傳送、複製以及移除模擬 SD 卡中的檔案。您無法從執行中的虛擬裝置移除模擬的 SD 卡。

如要在載入 SD 卡前將檔案複製到 SD 卡檔案中，請先將映像檔掛接為迴圈裝置，然後再複製檔案。或者，使用 mtools 套件等公用程式，將檔案直接複製到映像檔中。

模擬器會將檔案視為位元組集區，因此 SD 卡格式沒有任何影響。

-wipe-data 選項不會影響這個檔案。如要清除這個檔案，請刪除檔案，然後使用 AVD Manager 或 mksdcard 工具重新建立檔案。變更檔案大小也會一併刪除該檔案並建立新檔案。

設定後置或前置相機鏡頭的模擬模式。這會覆寫 AVD 中的任何相機設定。

mode 可以是下列任一值：

• emulated：模擬器透過軟體模擬相機。
• environment - 模擬器會使用 AVD 環境設定檔中定義的虛擬場景。
• webcamn：模擬器使用連接至開發電腦的網路攝影機 (依照指定編號)。如需列出網路攝影機清單，請使用 -webcam-list 選項，例如：webcam0。
• imagefile:filename：模擬器使用圖片檔案做為相機輸出內容。
• videofile:filename：模擬器使用影片做為攝影機輸出內容。
• image360:filename：模擬器使用等距柱狀投影全景圖片做為相機輸出內容。適用於 36.6.4 以上版本。
• none：停用虛擬裝置中的相機。

例如：

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'

在此範例中，第一個 webcam0 是您在指令列上使用的名稱。第二個 webcam0 是開發電腦上作業系統使用的名稱。第二個名稱會因作業系統而有所不同。

截至 SDK Tools 25.2.4 為止，您必須提供 AVD 名稱。

指定 1536 至 8192 MB 的實體 RAM 大小。例如：

emulator @Pixel8_API_34 -memory 2048

此值會覆寫 AVD 設定。

指定 SD 卡分區映像檔的檔案名稱和路徑。例如：

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

如果找不到這個檔案，模擬器仍會啟動，但不會顯示 SD 卡。 指令會傳回「No SD Card Image」警告。

如果您未指定此選項，則預設值為資料目錄中的 sdcard.img (除非 AVD 指定了其他不同的值)。如需模擬 SD 卡的詳細資訊，請參閱「AVD 資料目錄」。

在初始資料檔案中刪除使用者資料及複製資料。這個選項會清除虛擬裝置的資料，並將資料復原為首次定義時的狀態。系統會移除所有已安裝的應用程式和設定。例如：

emulator @Pixel8_API_34 -wipe-data

根據預設，使用者資料檔案為 userdata-qemu.img，初始資料檔案為 userdata.img。這兩個檔案都位於資料目錄中。-wipe-data 選項不會影響 sdcard.img 檔。如要進一步瞭解使用者資料，請參閱「瞭解預設目錄和檔案」一節。

顯示或不顯示一或多個標記的偵錯訊息。請用空格、半形逗號或欄分隔多個標記。例如：

$ emulator @Pixel8_API_34 -debug init,metrics

如要停用標記，請在標記前面加上破折號 (-)。舉例來說，下列選項會顯示所有偵錯訊息，但有關網路通訊端和指標的訊息除外：

-debug all,-socket,-metrics

如需標記與說明的清單資訊，請使用 -help-debug-tags 選項。例如：

emulator -help-debug-tags

您可以在 ANDROID_VERBOSE 環境變數中定義預設的偵錯標記。將您要使用的標記定義在以逗號分隔的清單中。以下範例說明如何指定 socket 和 gles 標記：

ANDROID_VERBOSE=socket,gles

等同於使用：

-debug-socket -debug-gles

或

-debug socket,gles

啟用特定偵錯訊息類型。使用 no 表單來停用偵錯訊息類型。例如：

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

如需標記清單資訊，請使用 emulator -help-debug-tags 指令。

顯示一或多個標記的 Logcat 訊息，並將這些訊息寫入終端機視窗。例如，下列指令會啟用來自所有元件的錯誤訊息：

emulator @Pixel8_API_34 -logcat *:e

logtags 採用與 adb logcat logtags 指令相同的格式。如需詳細資訊，請輸入 adb logcat -help。 此為格式 componentName:logLevel 以空格或以半形逗號分隔的記錄檔篩選器清單。componentName 是萬用字元星號 (*) 或元件名稱，例如 ActivityManager、SystemServer、InputManager 或 WindowManager。

logLevel 是下列其中一個值：

• v - verbose
• d - debug
• i - 實用資訊
• w - 警告記錄層級
• e - 錯誤
• s - 無紀錄

下列範例顯示資訊記錄等級的 GSM 元件訊息：

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

如果您未在指令列中提供 -logcat 選項，模擬器會尋求 ANDROID_LOG_TAGS 環境變數。如果 ANDROID_LOG_TAGS 定義了有效的 logtags 值且非空白，則在預設情況下，模擬器會使用其值將 Logcat 的內容輸出至終端機。您也可以透過 adb 將相同或其他記錄訊息重新導向至終端機。

如要進一步瞭解 Logcat 和 adb，請參閱「Logcat 指令列工具」、「使用 Logcat 檢視及寫入記錄」、「Log 類別」以及「發出 ADB 指令」。

在終端機視窗中顯示核心偵錯訊息。例如：

emulator @Pixel8_API_34 -show-kernel

其中一個使用選項是檢查啟動程序是否正常運作。

將模擬器初始化訊息列印至終端機視窗。例如：

emulator @Pixel8_API_34 -verbose

這項功能會顯示 AVD 中定義的虛擬裝置啟動時，實際選取的檔案和設定類型。這個選項與指定 -debug-init 相同。

使用指定的 DNS 伺服器。servers 是以逗號分隔的清單，最多包含四個 DNS 伺服器名稱或 IP 位址。例如：

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

根據預設，模擬器會嘗試偵測您使用的 DNS 伺服器，並在模擬的防火牆網路中設定特殊別名，以便 Android 系統直接連線至這些伺服器。使用 -dns-server 選項來指定不同的 DNS 伺服器清單。

透過指定的 HTTP/HTTPS Proxy 建立所有 TCP 連線。如果模擬器必須透過 Proxy 伺服器存取網際網路，您可以使用這個選項或 http_proxy 環境變數來設定適當的重新導向。例如：

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy 可以是下列任一值：

http://server:port
http://username:password@server:port

http:// 前置字元可以省略。

如未提供此選項，模擬器會查詢 http_proxy 環境變數，並自動採用任何符合 proxy 格式的值。詳情請參閱「將模擬器與 Proxy 搭配使用」。

注意：執行多個模擬器時，應在首次啟動時設定這個標記。

將網路延遲模擬設為下列其中一個 delay 值 (以毫秒為單位)：

• gsm - GSM/CSD (最小值 150，最大值 550)。
• hscsd - HSCSD (最小值 80，最大值 400)。
• gprs - GPRS (最小值 35，最大值 200)。
• edge - EDGE/EGPRS (最小值 80，最大值 400)。
• umts - UMTS/3G (最小值 35，最大值 200)。
• hsdpa - HSDPA (最小值 0，最大值 0)。
• lte - LTE (最小值 0，最大值 0)。
• evdo - EVDO (最小值 0，最大值 0)。
• none - 無延遲，預設值 (最小值 0，最大值 0)。
• num - 指定確切的延遲時間。
• min:max - 個別指定最小和最大延遲時間。

例如：

emulator @Pixel8_API_34 -netdelay gsm

模擬器支援網路節流以及較長的連線延遲時間。您可以透過外觀設定或 ‑netspeed 和 -netdelay 選項加以定義。

注意：這項設定適用於乙太網路和行動網路。

停用網路節流功能。例如：

emulator @Pixel8_API_34 -netfast

此選項與指定 -netspeed full -netdelay none 相同。以上皆是這些選項的預設值。

注意：這項設定適用於乙太網路和行動網路。

設定網路速度模擬。使用下列其中一個 speed 值 (以 kbp 為單位) 指定最大網路上傳和下載速度：

• gsm - GSM/CSD (上傳：14.4，下載：14.4)。
• hscsd - HSCSD (上傳：14.4，下載：57.6)。
• gprs - GPRS (上傳：28.8，下載：57.6)。
• edge - EDGE/EGPRS (上傳：473.6，下載：473.6)。
• umts - UMTS/3G (上傳：384.0，下載：384.0)。
• hsdpa - HSDPA (上傳：5760.0，下載：13,980.0)。
• lte - LTE (上傳：58,000，下載：173,000)。
• evdo - EVDO (上傳：75,000；下載：280,000)。
• full - 無限制，預設值 (上傳：0.0，下載：0.0)。
• num - 同時指定上傳和下載速度。
• up:down - 個別指定上傳和下載速度。

例如：

emulator @Pixel8_API_34 -netspeed edge

模擬器支援網路節流以及較長的連線延遲時間。您可以透過外觀設定或 ‑netspeed 和 -netdelay 選項加以定義。

注意：這項設定適用於乙太網路和行動網路。

將額外引數傳遞至網路模擬器 (netsim)。 arguments 是以空格分隔的旗標清單。

舉例來說，如要啟用封包擷取功能，並將記錄重新導向至 stderr，請執行下列指令：

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

詳情請參閱「進階模擬器網路功能」。

設定主控台和 adb 所用的 TCP 通訊埠編號。例如：

emulator @Pixel8_API_34 -port 5556

您電腦上執行的第一個虛擬裝置執行個體預設值為 5554。虛擬裝置通常會占用一對相鄰的通訊埠：主控台通訊埠和 adb 通訊埠。在一部特定電腦上執行的第一個虛擬裝置主控台，會使用主控台通訊埠 5554 和 adb 通訊埠 5555。後續的執行個體則會使用通訊埠編號加 2，例如 5556/5557、5558/5559 等。範圍則為 5554 至 5682，允許 64 部虛擬裝置並行。

通訊埠指派作業通常與指定 -ports port,{port + 1} 相同。{port + 1} 不得被占用，並保留供 adb 使用。如果任何主控台或 adb 通訊埠已被占用，模擬器就不會啟動。

‑port 選項會回報虛擬裝置正在使用的通訊埠和序號，並在您提供的值發生問題時發出警告。在模擬器 UI 中，您可以在視窗標題中看到主控台的通訊埠編號，然後依序選取「Help」 >「About」來查看 adb 通訊埠編號。

請注意，如果 port 值非偶數且位於 5554 到 5584 的範圍內，而您在模擬器啟動後使用 adb devices 指令啟動 adb server，則虛擬裝置會啟動，但是無法顯示。因此，我們建議您使用偶數的主控台通訊埠埠號。

設定主控台和 adb 所用的 TCP 通訊埠。例如：

emulator @Pixel8_API_34 -ports 5556,5559

有效通訊埠範圍為 5554 至 5682，允許 64 個虛擬裝置並行。-ports 選項會回報模擬器執行個體正在使用的通訊埠和序號，並在您提供的值發生問題時發出警告。

建議您盡可能改用 -port 選項。-ports 選項適用於需要特殊設定的網路設定。

如要進一步瞭解如何設定主控台和 adb 通訊埠，請參閱 -port 選項。

擷取網路封包並儲存至檔案中。例如：

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

使用這個選項即可開始擷取經模擬器虛擬乙太網路 LAN 傳送的所有網路封包。之後，您可使用 Wireshark 等工具分析流量。

請注意，此選項會擷取所有乙太網路封包，並不限於 TCP 連線。

設定模擬器 VM 加速功能。例如：

emulator @Pixel8_API_34 -accel auto

加速模擬僅適用於 x86 和 x86_64 系統映像檔。在 Linux 上，需仰賴 KVM 才能發揮作用。在 Windows 和 Mac 上，則仰賴 Intel CPU 和 Intel HAXM 驅動程式。如果您不模擬 x86 或 x86_64 裝置，可忽略此選項。

mode 的有效值如下：

• auto - 自動判斷系統是否支援加速功能，並在可能的情況下使用 (預設值)。
• off - 完全停用，主要在偵錯時使用。
• on - 強制使用加速功能。如果未安裝或使用 KVM 或 HAXM，模擬器將不會啟動並列印錯誤訊息。

詳情請參閱「設定 Android Emulator 的硬體加速功能」。

檢查是否已安裝用於模擬器 VM 加速功能的必要管理程序 (HAXM 或 KVM)。例如：

emulator -accel-check

詳情請參閱「檢查是否已安裝管理程序」一文。

指定模擬器引擎：

• auto - 自動選取引擎 (預設值)。
• classic：使用舊版的 QEMU 1 引擎 (已淘汰)。
• qemu2：使用新版的 QEMU 2 引擎。

例如：

emulator @Pixel8_API_34 -engine auto

自動偵測應選擇在模擬特定 AVD 時提供最佳效能的值。建議您僅將 -engine 選項用於偵錯和比較用途。

選取 GPU 模擬模式。例如：

emulator @Pixel8_API_34 -gpu swiftshader_indirect

詳情請參閱「設定圖形加速功能」。

使用 x86 或 x86_64 系統映像檔時，請停用模擬器 VM 加速功能。這只適用於偵錯，且與指定 -accel off 相同。例如：

emulator @Pixel8_API_34 -no-accel

詳情請參閱「設定 Android Emulator 的硬體加速功能」。

停用 Android Dalvik 或 ART 執行階段中的擴充 Java Native Interface (JNI) 檢查。例如：

emulator @Pixel8_API_34 -nojni

啟動虛擬裝置時，系統會預設啟用擴充 JNI 檢查。詳情請參閱「JNI 提示」。

在 Linux 作業系統中，將安全增強式 Linux (SELinux) 安全性模組設為 disabled 或 permissive 模式。例如：

me-linux$ emulator @Pixel8_API_34 -selinux permissive

根據預設，SELinux 會進入 enforcing 模式，代表系統會強制執行安全性政策。permissive 模式會載入 SELinux 政策，但不會強制執行。這個選項只會記錄違反政策的情形。disabled 模式會停用 SELinux 的核心支援。

將虛擬裝置的時區設為 timezone，而不是主機時區。例如：

emulator @Pixel8_API_34 -timezone Europe/Paris

在預設情況下，模擬器會採用開發電腦的時區。這個選項可用來指定不同時區，或是在自動偵測功能未正確運作時使用。timezone 值必須採用 zoneinfo 格式，也就是 area/location 或 area/subarea/location。例如：

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

指定的時區必須存在於 Zoneinfo 資料庫中。

顯示模擬器版本號碼。例如：

emulator @Pixel8_API_34 -version

或

emulator -version

在模擬器啟動期間停用啟動動畫，藉此加快啟動速度。例如：

emulator @Pixel8_API_34 -no-boot-anim

在速度較慢的電腦上，此選項可大幅加快啟動序列的速度。

設定模擬觸控螢幕模式。例如：

emulator @Pixel8_API_34 -screen no-touch

mode 可以是下列任一值：

• touch - 模擬觸控螢幕 (預設)。
• multi-touch - 模擬多點觸控螢幕。
• no-touch - 停用觸控螢幕和多點觸控螢幕的模擬功能。

啟用 bootcharting，並以秒為單位設定逾時。部分 Android 系統映像檔中含有經過修改的 init 系統，其中整合了 bootcharting 功能。您可以使用此選項將 bootcharting 逾時期間傳送到系統。如果您的 init 系統未啟用 bootcharting，則這個選項不會有任何作用。此選項主要適用於平台開發人員，而非外部應用程式開發人員。

例如：

emulator @Pixel8_API_34 -bootchart 120

指定快取分區映像檔。請提供檔案名稱，以及絕對路徑或相對於資料目錄的路徑，以便設定永久的快取檔案。如果檔案不存在，模擬器會建立一個空白檔案。

例如：

emulator @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

如果您不使用這個選項，系統預設會使用名為 cache.img 的暫存檔案。詳情請參閱「AVD 資料目錄」。

設定快取分區的大小 (以 MB 為單位)。

例如：

emulator @Pixel8_API_34 -cache-size 1000

如果未指定這個選項，則預設值為 66 MB。除非應用程式開發人員需要下載大於預設快取的大型檔案，否則一般不需要使用這個選項。如要進一步瞭解快取檔案，請參閱「AVD 資料目錄」。

設定使用者資料分區映像檔。請提供檔案名稱，以及絕對路徑或相對於目前使用的目錄的路徑，以便設定永久的使用者資料檔案。如果檔案不存在，模擬器就會從預設的 userdata.img 檔案建立映像檔、將其儲存為您指定的檔案名稱，並於關機時在當中留存使用者資料。

例如：

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

如果您不使用這個選項，系統預設會使用名為 userdata-qemu.img 的檔案。如要進一步瞭解使用者資料檔案，請參閱 AVD 資料目錄。

使用絕對路徑指定資料目錄。詳情請參閱「AVD 資料目錄」。

例如：

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

在 64 位元平台上使用 32 位元模擬器。有時候，這個選項可用來進行測試或偵錯。例如，有一個問題是模擬器無法在 64 位元的 Windows 上執行、卻能在 32 位元上執行；對此問題進行偵錯時，就能使用這個選項執行比較。範例如下：

emulator @Pixel8_API_34 -force-32bit

取得磁碟映像檔相關說明。這個選項可提供與應用程式和平台開發人員相關的資訊。例如：

emulator -help-disk-images

取得字元 device 規格相關說明。部分模擬器選項需要 device 參數。例如：

emulator -help-char-devices

取得與應用程式開發人員相關的磁碟映像檔說明。這個選項會取得使用 SDK 工具所建 AVD 的映像檔位置相關資訊。例如：

emulator -help-sdk-images

取得與平台開發人員相關的磁碟映像檔說明。例如：

emulator -help-build-images

指定資料分區的初始版本。清除使用者資料後，模擬器會將指定檔案的內容複製到使用者資料 (根據預設為 userdata-qemu.img 檔案)，而不是使用預設的 userdata.img 檔案做為初始版本。請提供檔案名稱，以及絕對路徑或相對於目前使用的目錄的路徑。

例如：

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

如果您未指定路徑，系統會將該檔案置於系統目錄中。詳情請參閱「AVD 系統目錄」。

使用特定模擬核心。如未指定路徑，模擬器會查看系統目錄。使用 ‑show‑kernel 選項檢視核心偵錯訊息。

例如：

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

如果未指定此選項，則預設為 kernel-ranchu。詳情請參閱「AVD 系統目錄」。

停用此虛擬裝置的音訊支援功能。部分 Linux 和 Windows 電腦內含錯誤的音訊驅動程式，而造成各種不同症狀，例如阻礙模擬器啟動。在此情況下，可以利用這個選項解決問題。或者，您也可以使用 QEMU_AUDIO_DRV 環境變數來變更音訊後端。

例如：

emulator @Pixel8_API_34 -noaudio

在沒有快取分區的情況下啟動模擬器。如果您不使用這個選項，則預設會使用一個名為 cache.img 的暫存檔案。這個選項僅適用於平台開發人員。詳情請參閱「AVD 資料目錄」。

例如：

emulator @Pixel8_API_34 -nocache

禁止自動載入和儲存作業，會導致模擬器執行完整的啟動序列，並在關閉時遺失其狀態。此選項會覆寫 -snapshot 選項。

例如：

emulator @Pixel8_API_34 -no-snapshot

防止模擬器從快照儲存空間載入 AVD 狀態。這會執行完整啟動程序。

例如：

emulator @Pixel8_API_34 -no-snapshot-load

防止模擬器在結束時將 AVD 狀態儲存至快照儲存空間，這代表所有變更都會遺失。

例如：

emulator @Pixel8_API_34 -no-snapshot-save

請勿嘗試在還原快照時立即修正 AVD 時鐘時間。這個選項在測試時非常實用，因為可避免時間突然跳轉。系統大約每 15 秒仍會將時間更新傳送給 AVD。

例如：

emulator @Pixel8_API_34 -no-snapshot-update-time

在沒有掛接檔案來儲存或載入狀態快照的情況下啟動模擬器，強制執行完整的啟動程序，並停用狀態快照功能。此選項會覆寫 -snapstorage 和 -snapshot 選項。

例如：

emulator @Pixel8_API_34 -no-snapstorage

停用模擬器的圖形視窗顯示功能。在沒有螢幕的伺服器上執行模擬器時，這個選項非常實用。您可以透過 adb 或主控台存取模擬器。例如：

emulator @Pixel8_API_34 -no-window

指定系統資料分區的大小 (以 MB 為單位)。例如：

emulator @Pixel8_API_34 -partition-size 1024

設定模擬器啟動時的 Android 系統屬性。name 必須是標示為 qemu_prop 的屬性名稱 (最多 32 個字元且不含任何空格)，而 value 必須是最多 92 個字元的字串。如需範例，請參閱 property_contexts 檔案。您可以在單一指令列中指定多個 ‑prop 選項。此選項很適合用於偵錯。例如：

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

顯示 -qemu 說明。例如：

emulator -qemu -h

指定 ramdisk 開機映像檔。請提供檔案名稱，以及絕對路徑或相對於目前使用的目錄的路徑。

例如：

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

如果您不使用這個選項，系統預設會使用系統目錄中的 ramdisk.img 檔案。詳情請參閱「AVD 系統目錄」。

在開始模擬前，向遠端第三方回報主控台通訊埠。這對於自動化測試指令碼來說非常實用。socket 必須採用下列其中一種格式：

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

如需詳細資訊，請按照特定選項的說明相關章節所述使用 -help-report-console 選項。

在目前的終端機上建立根層級的殼層主控台。與 adb shell 指令的差別在於，這個選項具有以下特性：

• 會建立根層級殼層，可讓您修改系統的多個部分。
• 即使模擬系統中的 adb daemon 發生中斷情形，還是可以正常運作。
• 按下 Control + C 鍵 (或在 macOS 為 Command + C) 即可停止模擬器，而非殼層。

例如：

emulator @Pixel8_API_34 -shell

在用於自動開始和儲存作業的快照儲存檔案中指定快照名稱。

與其執行完整的啟動序列，模擬器可以從更早的狀態快照恢復執行，且速度通常會快上許多。提供此選項時，模擬器會從快照映像檔載入該名稱的快照，並在結束時將其儲存回相同的名稱。

如果您不使用這個選項，系統會預設為完整的啟動序列。如果指定的快照不存在，模擬器會改為執行完整的啟動序列，並執行儲存作業。

如需指定快照儲存檔案和預設檔案的資訊，請參閱 -snapstorage 選項。

emulator @Pixel8_API_34 -snapshot snapshot2

請注意，在快照載入程序中，所有系統、使用者資料和 SD 卡映像檔的內容，都會遭到製作快照時保留的內容覆寫。除非您將這項資訊儲存在不同的快照中，否則之後的所有變更都會遺失。

您也可以使用 avd snapshot save name 指令從模擬器主控台建立快照。詳情請參閱「傳送模擬器主控台指令」一文。

顯示可用快照的清單。這個指令會列印快照資料表 (儲存在模擬器啟動時使用的快照儲存檔案中)，然後結束。如果您也指定了 -snapstorage file，這個指令會顯示出儲存在檔案中的快照資料表。

例如：

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

您可以在輸出內容中使用 ID 和 TAG 欄做為 -snapshot 選項的引數。

指定包含所有狀態快照的存放區檔案。執行期間製作的所有快照都會儲存在這個檔案中。只有這個檔案中的快照，才能在模擬器執行期間還原。

例如：

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

如果未指定這個選項，系統會預設為資料目錄中的 snapshots.img。如果指定的檔案不存在，模擬器會啟動，但不支援儲存或載入狀態快照的功能。

使用絕對路徑指定系統目錄。詳情請參閱「AVD 系統目錄」。例如：

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

指定初始系統檔案。請提供檔案名稱，以及絕對路徑或相對於目前使用的目錄的路徑。

例如：

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

如果您不使用這個選項，系統預設會使用系統目錄中的 system.img 檔案。詳情請參閱「AVD 系統目錄」。

選取這個選項後，即可在模擬工作階段中建立可寫入的系統映像檔。方法如下：

1. 透過 -writable-system 選項啟動虛擬裝置。
2. 從指令終端機輸入 adb remount 指令，即可告知模擬器將 system/ 重新掛接為讀取/寫入性質。根據預設，系統會將此目錄掛接為唯讀性質。

使用此旗標會建立一個系統映像檔暫存副本 (可達數百 MB 的超大型檔案)，但在模擬器結束時就會刪除。