在 Android Emulator 上執行應用程式

Android Emulator 可在電腦上模擬 Android 裝置,方便您在各種裝置和 Android API 級別中測試應用程式,且無需擁有每部實體裝置。

這款模擬器提供實體 Android 裝置幾乎所有的功能。您不但能模擬來電和簡訊、指定裝置的位置,還可以模擬不同網路速度、裝置旋轉和其他硬體感應器,以及存取 Google Play 商店等其他功能。

在模擬器上測試應用程式比在實體裝置上進行測試更為快速簡單。舉例來說,將資料傳送至模擬器的速度勝過於透過 USB 連線傳送至裝置的速度。

模擬器針對各種 Android 手機、平板電腦、Wear OS 和 Android TV 裝置提供對應的預先定義設定。

如需部分模擬器功能總覽,請觀看以下影片。

如要使用模擬器,您可以透過圖形使用者介面以手動方式操作,或是透過指令列和模擬器主控台以程式輔助方式操作。如需各個介面可用的功能差異,請參閱「Android Emulator 的工具比較」。

需求條件和建議

如要使用 Android Emulator,除了基本的 Android Studio 系統需求外,還必須滿足以下需求條件:

  • SDK 工具 26.1.1 以上版本
  • 64 位元處理器
  • Windows:支援 UG (無限制訪客) 的 CPU
  • HAXM 6.2.1 以上版本 (建議使用 HAXM 7.2.0 以上版本)

如要在 Windows 和 Linux 上使用硬體加速功能,還有以下需求條件:

  • Windows 或 Linux 上的 Intel 處理器:支援 Intel VT-x、Intel EM64T (Intel 64) 和 Execute Disable (XD) Bit 功能的 Intel 處理器
  • Linux 上的 AMD 處理器:支援 AMD Virtualization (AMD-V) 和 Supplemental Streaming SIMD Extensions 3 (SSSE3) 的 AMD 處理器
  • Windows 上的 AMD 處理器:Android Studio 3.2 以上版本,以及 2018 年 4 月 10 日後推出的 Windows 10,以便使用 Windows Hypervisor Platform (WHPX) 功能

如要使用 Android 8.1 (API 級別 27) 以上版本的系統映像檔,連接的網路攝影機必須具備 720p 影格擷取功能。

淘汰對 32 位元 Windows 系統的支援

Android Emulator 已於 2019 年 6 月淘汰對 32 位元 Windows 系統的支援。32 位元 Windows 模擬器的支援服務 (包括重大錯誤修正) 會持續至 2020 年 6 月,但不會新增任何功能。如果您是在 32 位元的 Windows 系統上使用模擬器,則應計劃遷移至 64 位元的 Windows 系統。

如果您是在 32 位元的 Windows 系統上使用模擬器,可透過 SDK Manager 安裝 32 位元 Windows 適用的模擬器最新版本。

安裝模擬器

如要安裝 Android Emulator,請在「SDK Manager」的「SDK Tools」(SDK 工具) 分頁標籤中選取「Android Emulator」元件。如需操作說明,請參閱「使用 SDK Manager 更新工具」。

Android 虛擬裝置

Android Emulator 的每個執行個體都會使用 Android 虛擬裝置 (AVD) 來指定模擬裝置的 Android 版本和硬體特性。為了有效測試應用程式,建議您針對要執行應用程式的目標裝置,個別建立模擬這些裝置的 AVD。如要建立及管理 AVD,請使用裝置管理員

每個 AVD 都會以獨立裝置的方式運作,具備使用者資料、SD 卡等專屬儲存空間。根據預設,模擬器會將使用者資料、SD 卡資料和快取儲存在該 AVD 的專屬目錄中。當您啟動模擬器後,系統就會從 AVD 目錄載入使用者資料和 SD 卡資料。

在 Android Emulator 上執行應用程式

您可以透過 Android Studio 專案執行應用程式,或是執行已安裝在 Android Emulator 上的應用程式,操作方法與在裝置上執行任何應用程式相同。

如何啟動 Android Emulator 並在專案中執行應用程式:

  1. 在 Android Studio 中,建立可讓模擬器用來安裝及執行應用程式的 Android 虛擬裝置 (AVD)
  2. 從工具列上的目標裝置下拉式選單中,選取要執行應用程式的 AVD。

    目標裝置下拉式選單。

  3. 按一下「執行」圖示

    如果對話方塊頂端顯示錯誤或警告訊息,請按一下連結來修正問題或取得詳細資訊。

    如果系統發生特定 Hardware Accelerated Execution Manager (Intel HAXM) 等錯誤,您必須先進行修正才能繼續執行,

    在 macOS 系統中,如果模擬器啟動時顯示 Warning: No DNS servers found 錯誤,請檢查您是否有 /etc/resolv.conf 檔案。如果您沒有這個檔案,請在終端機視窗中輸入下列指令:

    ln -s /private/var/run/resolv.conf /etc/resolv.conf
    

Wear OS 配對助理

Wear OS 配對助理會逐步引導您直接在 Android Studio 中將 Wear OS 模擬器與實體或虛擬手機配對。助理可協助您在手機上安裝正確的 Wear OS 隨附應用程式,並設定這兩個裝置之間的連線。如要開始使用,請依序前往裝置下拉式選單 >「Wear OS Emulator Pairing Assistant」(Wear OS 模擬器配對小幫手)

Wear OS 配對助理操作示範

無需先執行應用程式即可啟動 Android Emulator

如何啟動模擬器:

  1. 開啟裝置管理工具

  2. 在 AVD 上按兩下,或點選「執行」圖示

    執行圖示

    系統會隨即載入 Android Emulator。

在模擬器執行期間,您可以執行 Android Studio 專案,並選擇模擬器做為目標裝置。您也可以將一或多個 APK 拖曳到模擬器中,以便安裝與執行。

直接在 Android Studio 中執行 Android Emulator

根據預設,系統會直接在 Android Studio 中執行 Android Emulator。這可讓您節省螢幕空間、使用快速鍵在模擬器和編輯器視窗之間快速瀏覽,以及將 IDE 和模擬器工作流程彙整到單一應用程式視窗。

模擬器在 Android Studio 的工具視窗中啟動。

當模擬器執行時,您可以存取常用的模擬器動作 (例如旋轉) 和更進一步的控制選項 (例如瀏覽播放)。如要在另一個視窗中執行模擬器,請依序前往「File」(檔案) >「Settings」(設定) >「Tools」(工具) >「Emulator」(模擬器)。如果使用 macOS,則依序前往「Android Studio」>「Preferences」(偏好設定) >「Tools」(工具) >「Emulator」(模擬器)。接著取消選取「Launch in a tool window」(在工具視窗中啟動)

限制

您目前無法在工具視窗中使用模擬器的擴充控制項。如果您的開發工作流程大幅仰賴擴充控制項,請繼續以獨立應用程式的形式使用 Android Emulator。此外,特定虛擬裝置 (例如 Android TV 和折疊式裝置) 有特殊 UI 需求,或是在擴充控制項中有重要功能,因此無法在 Android Studio 中執行。

安裝及新增檔案

如要在模擬裝置上安裝 APK 檔案,請將 APK 檔案拖曳至模擬器螢幕中。系統隨即會顯示 APK 安裝程式對話方塊。安裝完成後,您就能在應用程式清單中查看該應用程式。

如要將檔案新增至模擬裝置,請將檔案拖曳至模擬器螢幕中。系統會將該檔案存放在 /sdcard/Download/ 目錄中。您可以在 Android Studio 中使用 Device File Explorer 查看檔案,或在裝置上使用「下載」或「檔案」應用程式 (視裝置版本而定) 找到該檔案。

快照

「快照」是 AVD (Android 虛擬裝置) 的已儲存映像檔,保留裝置在儲存時的完整狀態,包括 OS 設定、應用程式狀態和使用者資料。您可以透過隨時載入快照來返回已儲存的系統狀態,無需花時間等待虛擬裝置上的作業系統和應用程式重新啟動,還能節省您讓應用程式重新回到您要恢復測試的狀態。藉由載入快照來啟動虛擬裝置,就如同喚醒休眠狀態的實體裝置,而不是從關機狀態啟動裝置。

您可以為每個 AVD 設定一個「Quick Boot」快照以及不限數量的一般快照。

如要充分運用快照,最簡單的方法是使用 Quick Boot 快照功能。系統會預設將每個 AVD 設為在結束時自動儲存 Quick Boot 快照,並在啟動時載入 Quick Boot 快照。

AVD 首次啟動時,必須執行「冷啟動」(就像為裝置接電一樣)。如果您啟用了 Quick Boot,後續的所有快照都會從指定快照開始載入,而系統也會還原成該快照中所儲存的狀態。

快照功能適用於快照儲存時一併納入的系統映像檔、AVD 設定和模擬器功能。當您對上述任一適用範圍進行變更時,受影響 AVD 的所有快照都會失效。只要對 Android Emulator、系統映像檔或 AVD 設定進行更新,都會一併重設 AVD 的儲存狀態,因此當您下次啟動 AVD 時,必須執行冷啟動。

如要存取用來儲存、載入及管理快照的多數控制項,請前往模擬器的「Extended controls」(擴充控制項) 視窗,並瀏覽「Snapshots」(快照) 窗格中的「Snapshots」(快照) 和「Settings」(設定) 分頁標籤。

當您從指令列啟動模擬器時,也能控管 Quick Boot 設定選項。

儲存 Quick Boot 快照

關閉 AVD 時,您可以指定是否要讓模擬器在關閉時自動儲存快照。如要控制這項行為,請按照下列步驟操作:

  1. 開啟模擬器的「Extended controls」(擴充控制項) 視窗。
  2. 前往控制項「Snapshots」(快照) 類別中的「Settings」(設定) 分頁標籤。
  3. 使用「Auto-save current state to Quickboot」(將目前狀態自動儲存至 Quickboot) 下拉式選單選取下列任一選項:

    • :一律在關閉模擬器時儲存 AVD 快照。此為預設值。

    • :在關閉模擬器時不要儲存 AVD 快照。

您選取的設定僅適用於目前開啟的 AVD。在 ADB 離線的情況下 (例如 AVD 仍在啟動中),您無法儲存快照。

儲存一般快照

雖然您只能為每個 AVD 設定一個 Quick Boot 快照,但可以為每個 AVD 設定多個一般快照。

如要儲存一般快照,請開啟模擬器的「Extended controls」(擴充控制項) 視窗,選取「Snapshots」(快照) 類別,然後按一下視窗右下角的「Take snapshot」(拍攝快照) 按鈕。

如要編輯所選快照的名稱和說明,請按一下視窗底部的「編輯」按鈕

刪除快照

如要手動刪除快照,請開啟模擬器的「Extended controls」(擴充控制項) 視窗,選取「Snapshots」(快照) 類別,然後選取快照並按一下視窗底部的「刪除」按鈕

您也可以指定是否在快照失效時 (例如 AVD 設定或模擬器版本變更時),要求模擬器自動刪除快照。根據預設,模擬器會詢問您是否要刪除無效的快照。如要變更這項設定,請在「Snapshots」(快照) 窗格的「Settings」(設定) 分頁標籤中使用「Delete invalid snapshots」(刪除無效快照) 選單。

載入快照

每當您要載入快照時,請開啟模擬器的「Extended controls」(擴充控制項) 視窗,選取「Snapshots」(快照) 類別,然後選擇快照並按一下視窗底部的「載入」按鈕

在 Android Studio 3.2 以上版本中,每個裝置設定都含有「Boot option」(啟動選項) 控制項。這個控制項位於「Virtual Device Configuration」(虛擬裝置設定) 對話方塊的進階設定中,可用來指定啟動 AVD 時要載入哪一個快照。

停用 Quick Boot

如要停用 Quick Boot,讓 AVD 一律執行冷啟動,請按照下列步驟操作:

  1. 依序選取「Tools」(工具) >「Device Manager」(裝置管理員),然後按一下「編輯這個 AVD」圖示
  2. 按一下「Show Advanced Settings」(顯示進階設定),然後向下捲動至「Emulated Performance」(模擬效能)
  3. 選取「Cold boot」(冷啟動)

單次冷啟動

除了完全停用 Quick Boot 外,您還可以選擇只執行一次冷啟動,只要前往「Device Manager」(裝置管理員) 並在 AVD 的下拉式選單中按一下「Cold Boot Now」(立即冷啟動) 即可。

快照的系統需求與疑難排解

  • 快照功能不適用於 Android 4.0.4 (API 級別 15) 以下的版本。
  • 快照功能不適用於 Android 8.0 (API 級別 26) 的 ARM 系統映像檔。
  • 如果模擬器無法透過快照啟動,請在裝置管理工具中為 AVD 選取「Cold Boot Now」(立即冷啟動),然後提交錯誤報告
  • 啟用軟體轉譯功能時,可能會無法使用快照功能。如果快照功能無法使用,請在「Device Manager」(裝置管理員) 中按一下「編輯這個 AVD」圖示 ,然後將「Graphics」(圖像) 變更為「Hardware」(硬體) 或「Automatic」(自動)
  • 載入或儲存快照容易佔用大量記憶體。載入或儲存作業啟動後,如果可用 RAM 不足,作業系統可能會將 RAM 內容遷移至硬碟,可能會大幅降低作業效率。如果您發現快照載入或儲存速度非常緩慢,可以釋出 RAM 來加快作業效率。關閉不必要的應用程式是釋出 RAM 的絕佳方法。

您可以使用電腦的滑鼠游標來模仿手指在觸控螢幕上的操作,藉此選取選單項目和輸入欄位,以及點選按鈕和控制項。如要輸入字元和模擬器的快速鍵,則使用電腦鍵盤。

表 1. 操作模擬器的手勢

功能 說明
滑動畫面 將游標移至畫面上,按住滑鼠主要按鈕並在畫面上滑動,然後放開。
拖曳項目 將游標移至畫面上的項目,按住滑鼠主要按鈕並移動項目,然後放開。
輕觸
(觸控)
將游標移至畫面上,按下滑鼠主要按鈕,然後放開。舉例來說,您可以點選文字欄位來輸入欄位內容、選取應用程式或按下按鈕。
輕觸兩下 將游標移至畫面上,連按兩下滑鼠主要按鈕,然後放開。
按住 將游標移至畫面上的項目,按下滑鼠主要按鈕不放,然後再放開。舉例來說,您可以開啟某個項目的選項。
輸入 您可以使用電腦鍵盤或模擬器畫面上顯示的彈出式鍵盤,在模擬器中輸入內容。舉例來說,您可以在選取文字欄位後在欄位內輸入內容。
雙指向內與外撥動
按下 Control 鍵 (在 Mac 上為 Command 鍵) 時會啟動雙指手勢的多點觸控介面。滑鼠游標為第一指,而錨點的另一側為第二指。只要拖曳游標即可移動第一個點。
按下滑鼠左鍵代表手指輕觸這兩個點,放開滑鼠左鍵則代表手指離開這兩個點。
垂直滑動 開啟畫面上的垂直選單,然後使用滑鼠滾輪捲動選單項目,直到畫面顯示所需項目為止。按一下選單項目即可進行選取。

在模擬器中執行常用操作

如要透過模擬器執行常見操作,請使用右側的面板 (相關說明請參考表 2)。

您可以在模擬器中使用鍵盤快速鍵來執行多種常用操作。如需完整的模擬器快速鍵清單,請在「Extended controls」(擴充控制項) 視窗中,按下 F1 (在 Mac 上為 Command +/ 鍵) 開啟說明窗格。

表 2. 模擬器中的常見操作

功能 說明
關閉
關閉圖示
關閉模擬器。
最小化
最小化圖示
將模擬器視窗縮到最小。
調整大小 調整模擬器大小,如同調整其他作業系統視窗大小一樣。模擬器會保持裝置適用的顯示比例。
電源
電源圖示
按一下圖示即可開啟或關閉螢幕。
點選並按住圖示即可開啟或關閉裝置。
調高音量
調高音量圖示
按一下圖示即可查看滑桿控制項及調高音量。再按一下即可進一步調高音量,或使用滑桿控制項變更音量。
調低音量
調低音量圖示
按一下圖示即可查看滑桿控制項及調低音量。再按一下則可進一步調低音量,或使用滑桿控制項變更音量。
向左旋轉
向左旋轉圖示
將裝置逆時針旋轉 90 度。
向右旋轉
向右旋轉圖示
將裝置順時針旋轉 90 度。
擷取螢幕畫面
擷取螢幕截圖圖示
按一下圖示即可擷取裝置的螢幕截圖。詳情請參閱「螢幕截圖」。
進入縮放模式
進入縮放模式圖示

按一下圖示即可讓游標變更為縮放圖示。如要結束縮放模式,請再按一下按鈕。

如何使用縮放模式縮放畫面:

  • 在畫面上按一下滑鼠左鍵即可放大畫面 25%,上限為虛擬裝置螢幕解析度的兩倍。
  • 按一下滑鼠右鍵即可縮小畫面。
  • 按住滑鼠左鍵並拖曳游標,即可選取要放大顯示的方塊區域。
  • 按住滑鼠右鍵並拖曳選取方框,即可重設為預設縮放等級。

如要在縮放模式中平移顯示畫面,請按住 鍵盤上的 Control 鍵 (在 Mac 上為 Command 鍵),並同時按下方向鍵。

如要在縮放模式中輕觸裝置畫面,請按住 Control 鍵 (在 Mac 上為 Command 鍵) 並使用滑鼠點選。

返回
返回圖示
返回上一個畫面,或是關閉對話方塊、選項選單、通知面板或螢幕小鍵盤。
首頁
首頁圖示
回到主畫面
總覽
總覽圖示
(最近使用的應用程式)
輕觸圖示即可開啟最近使用的應用程式縮圖清單。如要開啟某個應用程式,請輕觸該縮圖。如要從清單中移除某個縮圖,請將該縮圖往左或往右滑動。Wear OS 不支援這個按鈕。
折疊
折疊圖示
針對折疊式裝置,折疊裝置即可顯示較小的螢幕設定。
展開
展開圖示
針對折疊式裝置,展開裝置即可顯示較大的螢幕設定。
選單 按下 Control+M 鍵 (在 Mac 上為 Command+M 鍵) 即可模擬選單按鈕。
更多
更多圖示
按一下圖示即可存取其他功能和設定 (相關說明請參考下一個表格)。

錄製螢幕畫面

您可以透過 Android Emulator 錄製視訊和音訊,並將錄製內容儲存至 WebM 或 GIF 動畫檔案。

螢幕錄製控制項位於「Extended Controls」(擴充控制項) 視窗的「Screen record」(螢幕錄影) 分頁標籤中。

提示:您也可以按下 Control + Shift + R 鍵 (在 Mac 上為 Command + Shift + R 鍵) 來開啟螢幕錄製控制項。

如要開始錄製螢幕畫面,請在「Screen record」(螢幕錄影) 分頁中按一下「Start recording」(開始錄影) 按鈕。如要停止錄影,請按一下「Stop recording」(停止錄影)。

播放及儲存錄製影片的控制項位於「Screen record」(螢幕錄影) 分頁底部。如要儲存影片,請從該分頁底部的選單中選擇「WebM」或「GIF」,然後按一下「Save」(儲存)。

您也可以在指令列中使用以下指令,以錄製並儲存模擬器的螢幕畫面:

adb emu screenrecord start --time-limit 10 [path to save video]/sample_video.webm

螢幕截圖

如要擷取虛擬裝置的螢幕截圖,請按一下「Take screenshot」(擷取螢幕截圖) 按鈕 擷取螢幕截圖圖示

模擬器會使用擷取時間的年、月、日、時、分和秒,建立名為 Screenshot_yyyymmdd-hhmmss.png 的 PNG 檔案 (例如 Screenshot_20160219-145848.png)。

系統會預設將螢幕截圖儲存在電腦桌面上。如要變更螢幕截圖的儲存位置,請在模擬器「Extended controls」(擴充控制項) 視窗的「Settings」(設定) 類別中,使用「Screenshot save location」(螢幕截圖儲存位置) 控制項。

您也可以在指令列中使用下列任一指令來擷取螢幕截圖:

  • screenrecord screenshot [destination-directory]
  • adb emu screenrecord screenshot [destination-directory]

相機支援

針對舊版 Android 的虛擬裝置,模擬器可支援基本相機功能。至於 Android 11 以上版本,Android Emulator 則額外支援下列相機功能:

  • RAW 擷取
  • YUV 重新處理
  • 等級 3 裝置
  • 邏輯相機支援
  • 使用感應器管理工具的資料來模擬感應器方向
  • 降低手震頻率來套用影片防震功能
  • 移除通常在 YUV 管道中進行的升頻作業來套用邊緣強化功能
  • 同步相機

虛擬場景相機和 ARCore

您可以在虛擬環境中使用虛擬場景相機,對使用 ARCore 建構的擴增實境 (AR) 應用程式進行實驗。

如要進一步瞭解如何在模擬器中使用虛擬場景相機,請參閱「在 Android Emulator 中執行 AR 應用程式」。

透過模擬器操作相機應用程式時,您可以匯入 PNG 或 JPEG 格式的圖片在虛擬場景中使用。如要選擇在虛擬場景中使用的圖片,請依序前往「Extended controls」(擴充控制項) 視窗中的「Camera」(相機) >「Virtual scene images」(虛擬場景圖像) 分頁標籤,然後按一下「Add image」(新增圖像)。這項功能可讓您匯入自訂圖片 (例如 QR 圖碼),與任何相機應用程式搭配使用。詳情請參閱「將擴增圖片加到場景中」。

使用巨集測試常見的 AR 操作

只要使用模擬器中的預設巨集,即可大幅減少測試常見 AR 操作所需的時間。舉例來說,您可以使用巨集將所有裝置的感應器重設為預設狀態。

使用巨集前,請先按照在 Android Emulator 中執行 AR 應用程式中的步驟操作,為應用程式設定虛擬場景相機、在模擬器上執行應用程式,並更新 ARCore。接著,再按照下列步驟使用模擬器巨集:

  1. 執行模擬器並將應用程式連線至 ARCore,然後按一下模擬器面板中的「更多」圖示
  2. 依序選取「Record and Playback」(錄製及播放) >「Macro Playback」(巨集播放)
  3. 選擇要使用的巨集,然後按一下「Play」(播放)。

    在播放過程中,按一下「Stop」(停止) 即可中斷巨集

擴充控制項、設定和說明

您可以使用擴充控制項來傳送資料、變更裝置屬性、控管應用程式等。如要開啟「Extended controls」(擴充控制項) 視窗,請按一下模擬器面板中的「更多」圖示 模擬器延伸控制項圖示

許多這類工作都能透過鍵盤快速鍵執行。如需模擬器的快速鍵完整清單,請按下 F1 鍵 (在 Mac 上為 Command+/ 鍵) 開啟說明窗格。

表 3. 擴充控制項詳細資料

功能 說明
Location (位置)

模擬器可讓您模擬「我的位置」資訊,也就是模擬裝置目前的所在位置。舉例來說,如果您在 Google 地圖中按一下「我的位置」圖示 我的位置圖示 並傳送位置資訊,地圖就會顯示該位置。

裝置的位置資訊控制項位於「Single points」(單一點) 和「Routes」(路徑) 這兩個分頁標籤中。

Single points

您可以在「Single points」(單一點) 分頁標籤中使用 Google 地圖 WebView 尋找搜尋點,就像透過手機或瀏覽器使用 Google 地圖一樣。在地圖中搜尋 (或點選) 某個地點後,您可以選取地圖底部的「Save point」(儲存點) 來儲存該地點。所有已儲存的地點都會列在「Extended Controls」(擴充控制項) 視窗的右側。

如要將模擬器的位置設為您在地圖上選取的位置,請按一下「Extended Controls」(擴充控制項) 視窗右下角的「Set location」(設定位置) 按鈕。

Routes

與「Single points」(單一點) 分頁標籤類似,「Routes」(路徑) 分頁標籤會提供 Google 地圖 WebView,可用來在兩個以上的地點之間建立路線。如要建立並儲存路線,請按照下列步驟操作:

  1. 在地圖檢視中,使用文字欄位搜尋路線中的第一個目的地。
  2. 在搜尋結果中選取該地點。
  3. 選取「導航」按鈕
  4. 在地圖上選取路線的起點。
  5. (選用) 按一下「Add destination」(新增目的地),在路線中加入額外停留點。
  6. 在地圖檢視中按一下「Save route」(儲存路線) 來儲存路線。
  7. 指定路線名稱,然後按一下「Save」(儲存)

如要讓模擬器模擬您儲存的路線,請從「Saved routes」(已儲存的路線) 清單中選取這個路線,然後按一下「Extended controls」(擴充控制項)視窗右下角的「Play route」(播放路線)。如要停止模擬,請按一下「Stop route」(停止播放路徑)。

如要讓模擬器持續模擬指定路線,請將「Repeat playback」(重複播放) 旁邊的切換按鈕設為開啟。如要變更模擬器模擬指定路線的速度,請從「Playback speed」(播放速度) 下拉式選單中選取所需選項。

匯入 GPX 和 KML 資料

如何使用 GPS 交換格式 (GPX) 或 Keyhole 標記語言 (KML) 檔案的地理資料:

  1. 按一下「Load GPX/KML」(載入 GPX/KML)。
  2. 在檔案對話方塊中,選取電腦上的檔案並點選「Open」(開啟)。
  3. 視需要選取「Speed」(速度)。
  4. 速度的預設值為「Delay」(延遲) (Speed 1X)。您可以將速度提升為兩倍 (Speed 2X)、三倍 (Speed 3X) 等,依此類推。

  5. 按一下「Run」(執行) 執行圖示
螢幕

模擬器可讓您將應用程式部署到多個螢幕。這項功能支援可自訂螢幕尺寸,並協助您測試支援多視窗多螢幕模式的應用程式。在虛擬裝置運作時,您可以新增最多兩個額外的螢幕,步驟如下:

  1. 按一下「Add secondary display」(新增次要螢幕) 即可新增其他螢幕。
  2. 在「Secondary displays」(次要螢幕) 下方的下拉式選單中,執行下列其中一項操作:
    1. 選取預設顯示比例。
    2. 選取「custom」(自訂),然後設定自訂螢幕的「高度」、「寬度」和「dpi」
  3. (選用) 按一下「Add secondary display」(新增次要螢幕) 新增第三個螢幕。
  4. 按一下「Apply changes」(套用變更),將指定螢幕新增至運作中的虛擬裝置。
Cellular (行動網路)

模擬器可讓您模擬各種網路連線狀況。您可以根據不同網路通訊協定設定概略的網路速度,或指定「Full」(全速) 以電腦允許的最高速度傳輸資料。指定網路通訊協定的速度一律會低於「Full」(全速) 的速度。您也可以指定語音通話和數據網路狀態 (例如漫遊)。預設值可在 AVD 中進行設定。

選取「Network type」(網路類型):

  • GSM:全球行動通訊系統
  • HSCSD:高速電路交換資料
  • GPRS:通用封包無線服務
  • EDGE:GSM 增強型數據速率演進技術
  • UMTS:通用行動通訊系統
  • HSPDA:高速下行封包存取
  • LTE:長期演進技術
  • Full (預設):使用電腦提供的網路

選取「Signal strength」(訊號強度):

  • None:無
  • Poor:欠佳
  • Moderate (預設):中等
  • Good:良好
  • Great:非常好

選取「Voice status」(語音通話狀態) 和/或「Data status」(資料狀態):

  • Home (預設):主畫面
  • Roaming:漫遊中
  • Searching:搜尋中
  • Denied (emergency calls only):已拒絕 (僅限緊急電話)
  • Unregistered (off):未註冊 (關閉)
Battery (電池)

您可以模擬裝置的電池屬性,瞭解應用程式在不同條件下的執行效能。如要選取「Charge level」(電池充電量),請使用滑桿控制項。

選取「Charger connection」(充電器連接) 的值:

  • None:無
  • AC charger:AC 充電器

選取「Battery health」(電池壽命) 的值:

  • Good (預設):電池良好
  • Failed:電池失效
  • Dead:電池耗盡
  • Overvoltage:電壓過高
  • Overheated:電池過熱
  • Unknown:不明

選取「Battery status」的值:

  • Unknown:不明
  • Charging (預設):充電中
  • Discharging:放電中
  • Not charging:非充電中
  • Full:電量已滿
Phone (電話)

模擬器可讓您模擬來電和簡訊。

如何撥號給模擬器:

  1. 在「From」欄位中選取或輸入電話號碼。
  2. 按一下「Call Device」
  3. 視需要按一下「Hold Call」,即可保留通話。
  4. 如要結束通話,請按一下「End Call」

如何傳送簡訊給模擬器:

  1. 在「From」欄位中選取或輸入電話號碼。
  2. 在「SMS message」欄位中輸入訊息內容。
  3. 按一下「Send Message」
Directional Pad (方向鍵)

如果您已在硬體設定檔中為 AVD 啟用方向鍵,就能在模擬器中使用方向鍵控制項。然而,並非所有裝置都支援方向鍵 (例如 Android 手錶)。這些按鈕會模擬下列操作:

方向鍵控制項
Fingerprint (指紋)

這個控制項可模擬 10 種不同的指紋掃描。您可以使用這項工具測試應用程式中的指紋整合功能。Android 5.1 (API 級別 22) 以下版本以及 Wear OS 已停用這項功能。

如何在虛擬裝置上模擬指紋掃描:

  1. 準備可接收指紋資訊的應用程式。
  2. 選取「Fingerprint」(指紋) 的值。
  3. 按一下「Touch Sensor」(觸控感應器)。
「Virtual sensors」(虛擬感應器) >「Accelerometer」 (加速計)

這個控制項可讓您根據裝置放置方式、方向或兩者的變化測試應用程式的反應。舉例來說,您可以模擬傾斜和旋轉等手勢。加速計不會追蹤裝置的絕對位置,只會偵測發生變更的情況。這個控制項可模擬加速計和磁力儀感應器在您移動或旋轉實際裝置時會產生的回應。

您必須在 AVD 中啟用加速計感應器,才能使用這個控制項。

這個控制項會以 X 軸、Y 軸和 Z 軸的值回報 TYPE_ACCELEROMETER 事件。這些值包含重力值。舉例來說,如果裝置懸浮在外太空,則加速度為零 (x 軸、y 軸 和 z 軸的值均為 0)。如果將裝置放在地球上的某張桌子上且螢幕朝上,由於重力影響,加速度分別為 0、0 和 9.8。

這個控制項也會回報 TYPE_MAGNETIC_FIELD 事件;這個事件會以微特斯拉 (μT) 為單位測量 x 軸、y 軸和 z 軸的環境磁場。

如要根據 x 軸、y 軸和 z 軸旋轉裝置,請選取「Rotate」(旋轉),並執行下列任一操作:

  • 調整「Yaw」(偏擺)、「Pitch」(俯仰) 和「Roll」(翻滾) 滑桿,並在頂端窗格中觀察裝置位置。
  • 移動上方窗格中顯示的裝置,並觀察「Yaw」(偏擺)、「Pitch」(俯仰) 和「Roll」(翻滾) 的值,以及產生的加速度值變化情形。

如要進一步瞭解 Yaw、Pitch 和 Roll 值的計算方式,請參閱「計算裝置的螢幕方向」。

如要水平 (x) 或垂直 (y) 移動裝置,請選取「Move」,並執行下列任一操作:

  • 調整「X」和「Y」滑桿,並在頂端窗格中觀察裝置位置。
  • 移動上方窗格中顯示的裝置,並觀察「X」和「Y」滑桿值,以及產生的加速度值變化情形。

將裝置定位在 0 度、90 度、180 度或 270 度的位置:

  • 在「Device rotation」(裝置旋轉) 區域中,選取用來變更旋轉方式的按鈕。

當您調整裝置時,「Resulting values」(結果值) 欄位也會隨著變更,而相關數值可供應用程式存取。

如要進一步瞭解上述感應器,請參閱「感應器總覽」、「動作感應器」以及「位置感應器」。

「Virtual sensors」(虛擬感應器) >「Additional sensors」(其他感應器)

模擬器可模擬各種位置感應器和環境感應器。您可以調整下列感應器,以便使用應用程式進行測試:

  • Ambient temperature:這個環境感應器可測量環境空氣溫度。
  • Magnetic field:這個位置感應器可分別測量 X 軸、Y 軸和 Z 軸的環境磁場,測得的值以微特斯拉 (μT) 為單位。
  • Proximity:這個位置感應器可測量與物體之間的距離,例如通知手機在臉部接近時撥打電話。您必須在 AVD 中啟用鄰近感應器,才能使用這個控制項。
  • Light:這個環境感應器可測量照明度,測得的值以勒克斯為單位。
  • Pressure:這個環境感應器可測量環境氣壓,測得的值以毫巴 (hPa) 為單位。
  • Relative Humidity:這個環境感應器可測量環境相對濕度。

如要進一步瞭解上述感應器,請參閱「感應器總覽」、「位置感應器」以及「環境感應器」。

Snapshots (快照) 請參閱「快照」。
Screen record (螢幕錄影) 請參閱「錄製螢幕畫面」。
「Settings」(設定) >「General」(一般)
  • Emulator window theme:為模擬器視窗主題選取「Light」(淺色) 或「Dark」(深色)。
  • Send keyboard shortcuts to:根據預設,部分鍵盤組合會觸發模擬器控制項快速鍵。如果您正在開發含有鍵盤快速鍵的應用程式 (例如針對使用藍牙鍵盤的裝置開發的應用程式),只要變更這項設定,即可將「所有」鍵盤輸入內容傳送至虛擬裝置,包括在模擬器屬於快速鍵的輸入內容。
  • Screenshot save location:按一下資料夾圖示即可指定要儲存模擬器螢幕截圖的位置。
  • Use detected ADB location:如果您是從 Android Studio 執行模擬器,請選取這項設定 (預設)。如要從 Android Studio 以外的位置執行模擬器,且希望使用特定的 ADB 執行檔,則請取消選取這個選項,並指定 SDK 工具位置。如果這項設定有誤,擷取螢幕截圖以及以拖曳方式安裝應用程式等功能將無法運作。
  • When to send crash reports:針對當機報告傳送時間,選取「Always」(一律傳送)、「Never」(永不傳送) 或「Ask」(詢問)。
  • Show window frame around device:根據預設,含有裝置外觀檔案的模擬器不會顯示視窗四周邊框。
Settings (設定) > Proxy

根據預設,模擬器會使用 Android Studio HTTP Proxy 設定,但您可以透過這個畫面為模擬器手動定義 HTTP Proxy 設定。詳情請參閱「將模擬器與 Proxy 搭配使用」。

Settings (設定) > Advanced (進階)
  • OpenGL ES renderer:選取圖形加速類型 (等同於 -gpu 指令列選項)。
    • Autodetect based on host:允許模擬器依據您的電腦設定選擇硬體或軟體圖形加速功能。這個選項會檢查 GPU 驅動程式是否與已知有誤的 GPU 驅動程式清單相符;如果相符,模擬器就會停用圖形硬體模擬功能,並改用 CPU。
    • ANGLE:(僅限 Windows) 使用 ANGLE Direct3D 在軟體中算繪圖形。
    • SwiftShader:使用 SwiftShader 在軟體中算繪圖形。
    • Desktop native OpenGL:使用主機電腦的 GPU。這個選項的運作效能通常最快。不過,部分驅動程式在算繪 OpenGL 圖形時會發生問題,因此這個選項並不可靠。
  • OpenGL ES API level:選取要在模擬器中使用的 OpenGL ES 最高版本。
    • Autoselect:允許模擬器根據主機和訪客支援,選擇 OpenGL ES 版本。
    • Renderer maximum (up to OpenGL ES 3.1):嘗試使用 OpenGL ES 的最新版本。
    • Compatibility (OpenGL ES 1.1/2.0):使用與多數環境相容的 OpenGL ES 版本。
Help (說明) > Keyboard Shortcuts (鍵盤快速鍵)

這個窗格提供模擬器的鍵盤快速鍵完整清單。如要在模擬器中開啟這個窗格,請按下 F1 鍵 (在 Mac 上為 Command+/ 鍵)。

您必須將「General」(一般) 設定窗格中的「Send keyboard shortcuts」(傳送鍵盤快速鍵) 選項設為「Emulator controls (default)」(模擬器控制項 (預設)),才能讓快速鍵正常運作。

「Help」(說明) >「Emulator Help」(模擬器說明)

如要存取模擬器的線上說明文件,請按一下「Documentation」(文件)。

如要回報模擬器相關錯誤,請按一下「Send feedback」(提供意見回饋)。詳情請參閱「如何回報模擬器錯誤」。

「Help」(說明) >「About」(簡介)

查看模擬器使用的 ADB 通訊埠,以及 Android 和模擬器的版本號碼。您可以將最新可用的模擬器版本與您的版本進行比對,確認您是否已安裝最新軟體。

模擬器序號格式為 emulator-adb_port,可指定為 ADB 指令列選項 (舉例來說)。

Wi-Fi

使用 API 級別 25 以上的 AVD 時,模擬器會提供模擬 Wi-Fi 存取點 (「AndroidWifi」),而 Android 也會自動連線至該網路。

如要在模擬器中停用 Wi-Fi,請透過指令列參數 -feature -Wifi 執行模擬器。

限制

Android Emulator 不含下列虛擬硬體:

  • 藍牙
  • NFC
  • SD 卡插入/退出
  • 連接裝置的耳機
  • USB

Wear OS 的手錶模擬器不提供「Overview (Recent Apps)」(總覽 (最近使用的應用程式)) 按鈕、D-Pad 和指紋感應器。