建立及管理虛擬裝置

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Android 虛擬裝置 (AVD) 是一種設定,可讓您定義要在 Android Emulator 模擬的 Android 手機、平板電腦、Wear OS、Android TV 或 Automotive OS 裝置的特徵。裝置管理工具是一種可從 Android Studio 啟動的介面,可協助您建立及管理 AVD。

如要開啟全新的裝置管理工具,請使用下列其中一種方法:

  • 在 Android Studio 歡迎畫面中,依序選取「More Actions」(更多動作) >「Virtual Device Manager」(虛擬裝置管理工具)

在歡迎畫面中開啟裝置管理工具

  • 開啟專案後,在主選單列中依序選取「View」(檢視) >「Tool Windows」(工具視窗) >「Device Manager」(裝置管理工具)

全新的「Device Manager」(裝置管理工具) 視窗,當中的「pair device」(配對裝置) 選單選項處於選取狀態

關於 AVD

AVD 包含硬體設定檔、系統映像檔、儲存空間區域、外觀和其他屬性。

建議您根據資訊清單中的 <uses-sdk> 設定,為您的應用程式可能會支援的每個系統映像檔建立 AVD。

硬體設定檔

硬體設定檔會定義從工廠出貨的裝置特性。裝置管理工具預先載入了特定的硬體設定檔 (例如 Pixel 裝置),您可以視需求定義或自訂硬體設定檔。

請注意,只有部分硬體設定檔已指明為包含「Play 商店」。這表示這些設定檔已完全符合 CTS 規範,因此可能會使用包含 Play 商店應用程式的系統映像檔。

系統映像檔

標有 Google API 的系統映像檔包含了 Google Play 服務的存取權。在「Play 商店」欄中標有 Google Play 標誌的系統映像檔,即為 Google Play 商店應用程式 Google Play 服務的存取權,包括「延伸控制項」對話方塊中的「Google Play」分頁,其提供的便利按鈕可供您用來更新裝置上的 Google Play 服務。

為了確保應用程式的安全性及與實體裝置一致的使用體驗,Google Play 商店內含的系統映像檔會使用發佈金鑰進行簽署,這表示您將無法使用這些映像檔取得進階權限 (根層級)。假使您需要提升權限 (根層級) 以協助解決應用程式問題,您可以使用不含 Google 應用程式或服務的 Android 開放原始碼計畫 (AOSP) 系統映像檔。

儲存空間區域

AVD 在您的開發機器上設有專屬儲存空間區域。儲存裝置的使用者資料,例如已安裝的應用程式和設定,以及模擬的 SD 卡。如有需要,您可以使用裝置管理工具抹除使用者資料,因此裝置的資料會與新裝置相同。

外觀

模擬器外觀可指定裝置的外觀。裝置管理工具會提供部分預先定義的外觀。您也可以定義自己的,或是使用第三方提供的外觀。

AVD 和應用程式功能

確認 AVD 定義包含應用程式所需的裝置功能。 如要瞭解可在 AVD 中定義的功能清單,請參閱硬體設定檔屬性AVD 屬性

建立 AVD

提示:如要將應用程式推出至模擬器,請透過 Android Studio 執行應用程式,隨即將顯示「Select Deployment Target」(選取部署目標) 對話方塊,請按一下「Create New Virtual Device」(建立新的虛擬裝置)

建立新的 AVD:

  1. 開啟裝置管理工具
  2. 按一下「Create Device」(建立裝置)

    系統會隨即顯示「Select Hardware」(選擇軟體) 視窗。

    請注意,只有部分硬體設定檔已指明為包含「Play 商店」。這表示這些設定檔已完全符合 CTS 規範,因此可能會使用包含 Play 商店應用程式的系統映像檔。

  3. 選取硬體設定檔,然後按一下「Next」(下一步)
  4. 如果找不到想要的硬體設定檔,您可以建立匯入硬體設定檔。

    「System Image」(系統映像檔) 頁面隨即顯示。

  5. 選取特定 API 級別的系統映像檔,然後點選「Next」(下一步)
  6. 「Recommended」(建議做法) 分頁會列出建議的系統映像檔。其他分頁則包括更完整的清單。右側窗格說明所選的系統映像檔。在 X86 圖像的模擬器中執行速度最快。

    如果您看到系統映像檔旁邊的「Download」(下載),請按一下以下載系統映像檔。您必須連上網際網路才能下載。

    目標裝置的 API 等級非常重要,因為在應用程式資訊清單檔案的屬性中,您的應用程式無法在 API 等級低於應用程式所需的系統映像檔上執行 minSdkVersion。如要進一步瞭解系統 API 級別與 minSdkVersion 之間的關係,請參閱應用程式的版本管理

    假使您的應用程式在資訊清單檔案中宣告 <uses-library> 元素,應用程式就必須提供包含外部程式庫的系統映像檔。假使想在模擬器上執行應用程式,請建立一個含有必要程式庫的 AVD。如要這麼做,您可能需要使用 AVD 平台的外掛程式元件;舉例來說,Google API 外掛程式會包含 Google 地圖程式庫。

    隨即顯示「Verify Configuration」(驗證設定) 頁面。

  7. 視需要變更 AVD 屬性,然後按一下「Finish」(完成)

    按一下「Show Advanced Settings」(顯示進階設定) 即可查看更多設定,例如外觀。

  8. 新的 AVD 會顯示在裝置管理工具的「Virtual」(虛擬) 分頁和目標下拉式選單中。

如何從副本建立 AVD:

  1. 在裝置管理工具的「Virtual」(虛擬) 分頁中按一下「Menu」(選單),然後選取「Duplicate」(複製)
  2. 隨即顯示「Verify Configuration」(驗證設定)

  3. 如需在「System Image」(系統映像檔)「Select Hardware」(選取硬體) 頁面上進行變更,請按一下「Change」(變更) 或「Previous」(上一步)
  4. 進行變更,然後按一下「Finish」(完成)
  5. AVD 會顯示在裝置管理工具的「Virtual」(虛擬) 分頁中。

建立硬體設定檔

裝置管理工具為常見裝置提供預先定義的硬體設定檔,因此您可以輕鬆新增至 AVD 定義。如果您需要定義其他裝置,可以建立新的硬體設定檔。您可以從頭開始定義新的硬體設定檔,或是複製硬體設定檔作為起點。無法編輯預先載入的硬體設定檔。

從頭開始建立新的硬體設定檔:

  1. 「Select Hardware」(選取硬體) 頁面中,按一下「New Hardware Profile」(新增硬體設定檔)
  2. 在「Configure Hardware Profile」(設定硬體設定檔) 頁面中,視需要變更硬體設定檔屬性
  3. 按一下「Finish」(完成)
  4. 新的硬體設定檔會顯示在「Select Hardware」(選取硬體) 頁面中。您可以選擇按一下「Next」(下一步)建立使用硬體設定檔的 AVD。或是按一下「Cancel」(取消),返回「Virtual」(虛擬) 分頁或目標裝置下拉式選單。

如何從副本開始建立硬體設定檔:

  1. 「Select Hardware」(選取硬體) 頁面中選取硬體設定檔,然後按一下「Clone Device」(複製裝置)
  2. 您也可以在硬體設定檔上按一下滑鼠右鍵,然後選取「Clone」(複製)

  3. 在「Configure Hardware Profile」(設定硬體設定檔) 頁面中,視需要變更硬體設定檔屬性
  4. 按一下「Finish」(完成)
  5. 新的硬體設定檔會顯示在「Select Hardware」(選取硬體) 頁面中。您可以選擇按一下「Next」(下一步)建立使用硬體設定檔的 AVD。或是按一下「Cancel」(取消),返回「Virtual」(虛擬) 分頁或目標裝置下拉式選單。

編輯現有的 AVD

您可以在裝置管理工具的「虛擬分頁中對現有的 AVD 執行下列操作:

  • 如要編輯 AVD,請按一下「Edit this AVD」(編輯此 AVD),然後進行變更
  • 如要刪除 AVD,請按一下「Menu」(選單) ,然後選取「Delete」(刪除)
  • 如要在磁碟中顯示相關聯的 AVD .ini.img 檔案,請按一下「Menu」(選單) ,然後選取「Show on Disk」(在磁碟上顯示)
  • 如要查看您可以加入任何 Android 團隊錯誤報告的 AVD 設定詳細資料,請按一下「選單」,然後選取「檢視詳細資料」

編輯現有的硬體設定檔

您可以在「Select Hardware」(選取硬體) 頁面中,對現有的硬體設定檔執行下列操作:

  • 如要編輯硬體設定檔,請選取設定檔,然後按一下「Edit Device」(編輯裝置)。您也可以在硬體設定檔上按一下滑鼠右鍵,然後選取「Edit」(編輯)。接下來,請進行變更
  • 如要刪除硬體設定檔,請在設定檔上按一下滑鼠右鍵,然後選取「Delete」(刪除)

您無法編輯或刪除預先定義的硬體設定檔。

執行及停止模擬器,並清除資料

您可以透過「Virtual」(虛擬) 分頁,在模擬器上執行下列操作:

  • 如要執行使用 AVD 的模擬器,請按一下「Launch」(啟動)
  • 如要停止執行中的模擬器,請按一下「Menu」(選單) ,然後選取「Stop」(停止)
  • 如要清除模擬器的資料,請選取「Wipe Data」(抹除資料)。您也可以按一下「Menu」(選單) ,然後選取「Wipe Data」(抹除資料)

匯入及匯出硬體設定檔

您可以在「Select Hardware」(選取硬體) 頁面中匯入及匯出硬體設定檔:

  • 如要匯入硬體設定檔,請按一下「Import Hardware Profiles」(匯入硬體設定檔),然後選取包含該電腦定義的 XML 檔案。
  • 如要匯出硬體設定檔,請在設定檔上按一下滑鼠右鍵,然後選取「Export」(匯出)。指定包含定義的 XML 檔案的儲存位置。

硬體設定檔屬性

您可以在「Configure Hardware Profile」(設定硬體設定檔) 頁面中指定硬體設定檔的下列屬性。AVD 設定屬性會覆寫硬體設定檔屬性,以及您在執行模擬器覆寫時設定的模擬器屬性。

您無法編輯裝置管理工具隨附的預先定義硬體設定檔。然而,您可以複製及編輯副本。

硬體設定檔屬性 說明
裝置名稱 硬體設定檔的名稱。 名稱可以包含大寫或小寫的英文字母、0 到 9 的數字、句號 (.)、底線 (_)、括號 ( () ) 和空格。 儲存硬體設定檔的檔案名稱衍生自硬體設定檔名稱。
裝置類型 選擇下列其中一種做法:
  • 手機/平板電腦
  • Wear OS
  • Android TV
  • Chrome 作業系統裝置
  • Android Automotive
畫面尺寸 畫面的實際尺寸 (以英寸為單位)。假使尺寸大於電腦畫面,系統會在應用程式啟動時縮減尺寸。
畫面解析度 輸入寬度和高度 (以像素為單位),指定模擬畫面上顯示的像素總數。
圓形 如果裝置有圓形畫面 (例如部分 Wear OS 裝置),請選取此選項。
記憶體:RAM 輸入裝置的 RAM 尺寸,並選取下列單位之一:B (位元組)、KB、MB、GB 或 TB。
輸入:含有硬體按鈕 (返回/主畫面/選單) 如果您的裝置有硬體導覽按鈕,請選取此選項。如果這些按鈕只會在軟體中實作,請取消選取。如果您選取此選項,畫面上就不會顯示按鈕。無論是哪一種情況,您都可以使用模擬器側邊面板來「按下」按鈕。
輸入:有硬體鍵盤 如果您的裝置有硬體鍵盤,請選取此選項。如未提供,請取消選取。如果您選取此選項,畫面上就不會顯示鍵盤。無論是哪種情況,您都可以使用電腦鍵盤將按鍵動作傳送至模擬器。
導航樣式

選擇下列其中一種做法:

  • 無 - 沒有硬體控制項。您可以透過軟體使用導航功能。
  • D-pad - 方向鍵支援。
  • 軌跡球
  • 車輪

這些選項是用於裝置上的實際硬體控制項。 然而,由外部控制器傳送到裝置的事件相同。

支援裝置狀態

選取其中一個選項,或兩者同時選取:

  • 直向 - 以高大於寬為方向。
  • 橫向 - 以寬大於高為方向。

假使您同時選取這兩個選項,就能在模擬器中切換螢幕方向。 您必須選取至少一個選項才能繼續操作。

相機

如要啟用相機,請選取下列一或兩個選項:

  • 後置鏡頭:背向使用者的鏡頭。
  • 前置鏡頭 - 面向使用者的鏡頭。

之後,您可以使用網路攝影機或模擬器提供的相片,來利用相機拍照。

感應器:加速計 選擇裝置是否有可讓裝置判斷方向的硬體。
感應器:陀螺儀 選擇裝置是否具備偵測旋轉或扭轉的硬體。 再加上加速計,可以提供更順暢的螢幕方向偵測功能,並支援六軸螢幕方向系統。
感應器:GPS 選擇裝置是否具備支援全球定位系統 (GPS) 衛星導航系統的硬體。
感應器:鄰近感應器 選擇裝置是否有硬體可在通話期間偵測裝置靠近您的臉部,以停用畫面的輸入功能。
預設外觀 選取外觀,以控制裝置在模擬器中顯示的外觀。請注意,假使指定畫面尺寸的解析度過大,可能無法正常顯示畫面,導致您無法看到整個畫面。詳情請參閱建立模擬器外觀一文。

AVD 屬性

您可以在「驗證設定頁面中指定 AVD 設定的下列屬性。AVD 設定會指定開發電腦和模擬器之間的互動,以及您要在硬體設定檔中覆寫的屬性。

AVD 設定屬性會覆寫硬體設定檔屬性。 模擬器執行時所設定的模擬器屬性會覆寫這兩項屬性。

AVD 屬性 說明
AVD 名稱 AVD 的名稱。名稱可以包含大寫或小寫的英文字母、0 到 9 的數字、句號 (.)、底線 (_)、括號 ( () )、連字號 (-) 和空格。 儲存 AVD 設定的檔案名稱是由 AVD 名稱衍生而來。
AVD ID (進階) AVD 檔案名稱是由 ID 衍生而來,方便您從指令列使用 ID 參照 AVD。
硬體設定檔 按一下「Change」(變更),然後在「Select Hardware」(選取硬體) 頁面中選取其他硬體設定檔。
系統映像檔 按一下「Change」(變更),在「System Image」(系統映像檔) 頁面中選取其他系統映像檔。必須連上網際網路,才能下載新圖片。
啟動螢幕方向

選取初始模擬器螢幕方向的其中一個選項:

  • 直向 - 以高大於寬為方向。
  • 橫向 - 以寬大於高為方向。

您必須在硬體設定檔中選取此選項,才能啟用選項。在模擬器中執行 AVD 時,如果硬體設定檔支援直向和橫向功能,即可變更方向。

相機 (進階)

如要啟用相機,請選取下列一或兩個選項:

  • 前置鏡頭 - 背向使用者的鏡頭。
  • 後置鏡頭:面向使用者的鏡頭。

「模擬」設定會產生軟體生成的圖片,「網路攝影機」設定則使用您的開發電腦網路相機拍照。

您必須在硬體設定檔中選取,才能使用此選項;不適用於 Wear OS 和 Android TV

網路:速度 (進階)

選取網路通訊協定以決定資料移轉速度:

  • GSM:全球行動通訊系統
  • HSCSD - 高速電路交換數據
  • GPRS - 通用封包無線電服務
  • EDGE - GSM 增強數據率演進
  • UMTS - 通用行動通訊系統
  • HSDPA - 高速下行封包接入
  • LTE - 長期演進技術
  • 完整 (預設) - 在電腦允許時盡快傳輸資料。
網路:延遲時間 (進階) 選取網路通訊協定,以設定通訊協定從一個點轉移數據至另一個點所需的時間。
模擬效能:圖形

選取圖形在模擬器中的算繪方式:

  • 硬體:使用電腦顯示卡加快算繪速度。
  • 軟體:在軟體中模擬圖像。假使算繪顯示卡時發生問題,此方法非常實用。
  • 自動 - 讓模擬器根據您的顯示卡決定最適合的選項。
模擬效能:啟動選項 (進階)
  • 冷啟動 - 在每次裝置關機狀態下開機。
  • Quick Boot - 從已儲存的快照載入裝置狀態,藉此啟動裝置。詳情請參閱使用 Quick Boot 執行模擬器
模擬效能:多核心 CPU (進階) 選取要在電腦上使用模擬器的處理器核心數量。使用更多處理器核心可以加快模擬器的執行速度。
記憶體與儲存空間:RAM 裝置上的 RAM 容量。此值是由硬體製造商設定,但您也可以視需要覆寫,例如執行更快速的模擬器操作。增加大小會在您的電腦上使用更多資源。輸入 RAM 尺寸並選取單位,包括 B (位元組)、KB、MB、GB 或 TB。
記憶體與儲存空間:VM 堆積 VM 堆積尺寸。此值是由硬體製造商設定,但您可以視需要覆寫。輸入堆積尺寸,然後選取單位 B (位元組)、KB、MB、GB 或 TB。如要進一步瞭解 Android VM,請參閱不同虛擬機器的記憶體管理一文。
記憶體與儲存空間:內部儲存空間 裝置上可用的不可移除記憶體空間。此值是由硬體製造商設定,但您可以視需要覆寫。輸入尺寸並選取單位,包括 B (位元組)、KB、MB、GB 或 TB。
記憶體與儲存空間:SD 卡 可供裝置儲存資料的可移除記憶體空間大小。如要使用由 Android Studio 代管的虛擬 SD 卡,請選取「Studio-managed」(Studio 管理),輸入尺寸,然後選取單位:包括 B (位元組)、KB、MB、GB 或 TB。建議至少使用 100 MB 的相機。如要管理檔案中的空間,請選取「External file」(外部檔案),然後按一下「…」以指定檔案和位置。詳情請參閱 mksdcardAVD 資料目錄
裝置邊框:啟用裝置邊框 選擇啟用能模擬實際裝置外觀的模擬器視窗周圍的邊框。
自訂外觀定義 (進階) 選取外觀,以控制裝置在模擬器中顯示的外觀。請注意,假使指定畫面尺寸的外觀過大,可能無法正常顯示畫面,導致您無法看到整個畫面。詳情請參閱建立模擬器外觀一文。
鍵盤:啟用鍵盤輸入 (進階) 假使您要使用硬體鍵盤與模擬器互動,請選取此選項。已停用 Wear OS 和 Android TV。

建立模擬器外觀

Android 模擬器外觀是一組檔案,用於定義模擬器顯示畫面的視覺元素和控制元素。假使 AVD 設定中提供的外觀定義不符合您的需求,您可以自行建立自訂外觀定義,然後套用到 AVD。

所有模擬器的外觀都包含:

  • 一個 hardware.ini 檔案
  • 支援方向 (橫向、直向) 和實體設定的版面配置檔案
  • 顯示元素 (例如背景、鍵和按鈕) 的圖片檔

如何建立及使用自訂外觀:

  1. 建立用來儲存外觀設定檔的新目錄。
  2. 在名為 layout 的文字檔中定義外觀的視覺外觀。此檔案定義了外觀的許多特徵,例如特定按鈕的尺寸和圖片素材資源。例如:

    parts {
        device {
            display {
                width   320
                height  480
                x       0
                y       0
            }
        }
    
        portrait {
            background {
                image background_port.png
            }
    
            buttons {
                power {
                    image  button_vertical.png
                    x 1229
                    y 616
                }
            }
        }
        ...
    }
    

  3. 在相同目錄中新增裝置映像檔的點陣圖檔案。
  4. hardware.ini 檔案的裝置設定中,指定其他硬體專屬裝置設定,例如 hw.keyboardhw.lcd.density
  5. 封存屬於外觀資料夾的檔案,然後選取封存檔案並設為自訂顏色。

如要進一步瞭解如何建立模擬器外觀,請參閱工具原始碼中的 Android Emulator 外觀檔案規格