建立及管理虛擬裝置

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」，然後按一下「+」，再按一下「Create Virtual Device」。

建立裝置後，您可以在裝置管理員面板上查看所有裝置的清單。

如果想透過可擴充及自行管理的方式，運用虛擬裝置執行自動化檢測設備測試，可考慮使用 Gradle 管理的裝置。

關於 AVD

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

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

硬體設定檔

裝置從工廠出貨時的配置，可以在硬體設定檔找到。裝置管理工具已預先載入了特定硬體設定檔 (例如 Pixel 裝置)，您可以視需求定義或自訂這類設定檔。

如果裝置定義在「Play Store」一欄列出 Google Play 標誌，就表示包含 Google Play 商店應用程式和 Google Play 服務存取權，而且「Extended controls」對話方塊中也會顯示「Google Play」分頁，當中提供的便利按鈕可用於更新裝置上的 Google Play 服務。

裝置如有此標誌「且」類型為「手機」，也就符合 CTS 規範，因此可能會使用內含 Play 商店應用程式的系統映像檔。

系統映像檔

標有 Google API 的系統映像檔包含 Google Play 服務存取權。

「Recommended」分頁會列出建議的系統映像檔，其他分頁則含有更完整的清單。右側窗格中會顯示所選系統映像檔的說明。

如果系統映像檔旁邊出現下載圖示，代表您的開發機器目前未安裝該映像檔。如要下載系統映像檔，請按一下這個圖示。您必須連上網際網路，才能下載系統映像檔。

目標裝置的 API 級別相當重要。在應用程式資訊清單檔案內，有個 minSdk 屬性會指定應用程式所需的級別，若系統映像檔的 API 級別低於此，應用程式就無法執行。如要進一步瞭解系統 API 級別與 minSdk 的關係，請參閱「管理應用程式版本」。

如果應用程式在資訊清單檔案中宣告 <uses-library> 元素，就需要內含外部程式庫的系統映像檔。如要在模擬器中執行應用程式，請建立一個含有必要程式庫的 AVD。為此，您可能需要使用 AVD 平台的外掛程式元件，例如包含 Google 地圖程式庫的 Google API 外掛程式。

為了確保應用程式安全性並提供與實體裝置一致的體驗，內含 Google Play 商店的系統映像檔會使用發布金鑰進行簽署，這表示您無法透過這些映像檔取得進階 (根層級) 權限。

如果您需要進階 (根層級) 權限來協助排解應用程式問題，可以使用不含 Google 應用程式或服務的 Android 開放原始碼計畫 (AOSP) 系統映像檔。這樣一來，就能使用 adb root 和 adb unroot 指令切換一般權限與進階權限：

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

儲存空間區域

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

外觀

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

AVD 和應用程式功能

請確認您的 AVD 定義包含應用程式所需的裝置功能。如需可在 AVD 中定義的功能清單，請參閱「硬體設定檔屬性」和「AVD 屬性」一節。

建立 AVD

如何建立新的 AVD：

1. 開啟裝置管理工具。
2. 按一下「Create Device」。

   畫面上會顯示「Select Hardware」視窗。

   

   請注意，只有部分硬體設定檔包含 Play 商店。這些設定檔已完全符合 CTS 規範，可能會使用內含 Play 商店應用程式的系統映像檔。

3. 選取硬體設定檔，然後按一下「Next」。

   如果找不到所需的硬體設定檔，可以按照本頁其他章節的說明建立或匯入硬體設定檔。

   畫面上會顯示「System Image」視窗。

   
4. 選取特定 API 級別的系統映像檔，然後點選「Next」。

畫面上會顯示「Verify Configuration」視窗。


5. 視需要變更 AVD 屬性，然後按一下「Finish」。

   按一下「Show Advanced Settings」，查看外觀等其他設定。

新的 AVD 會顯示在裝置管理工具的「Virtual」分頁，也會列於目標裝置選單中。

如何從副本建立 AVD：

1. 在裝置管理工具的「Virtual」分頁中點選「Menu」圖示 ，然後選取「Duplicate」。

   畫面上會顯示「Verify Configuration」視窗。

2. 如需在「System Image」或「Select Hardware」視窗中進行變更，請按一下「Previous」。
3. 進行所需變更，然後按一下「Finish」。

   AVD 會顯示在裝置管理工具的「Virtual」分頁。

建立硬體設定檔

裝置管理工具為常見裝置提供了預先定義的硬體設定檔，方便您將這些設定檔新增至 AVD 定義。如需定義其他裝置，可以建立新的硬體設定檔。

您可以從頭開始定義新的硬體設定檔，也可以從複製硬體設定檔著手。不過，您無法編輯預先載入的硬體設定檔。

如何從頭開始建立新的硬體設定檔：

1. 在「Select Hardware」視窗中，按一下「New Hardware Profile」。

2. 在「Configure Hardware Profile」視窗中，視需要變更硬體設定檔屬性。

   
3. 按一下「Finish」。

   新的硬體設定檔會顯示在「Select Hardware」視窗中。您可以點選「Next」建立使用這個硬體設定檔的 AVD，也可以按一下「Cancel」返回「Virtual」分頁或目標裝置選單。

如何從副本著手建立硬體設定檔：

1. 在「Select Hardware」視窗中選取硬體設定檔，然後按一下「Clone Device」。您也可以在硬體設定檔上按一下滑鼠右鍵，接著選取「Clone」。

2. 在「Configure Hardware Profile」視窗中，視需要變更硬體設定檔屬性。
3. 按一下「Finish」。

新的硬體設定檔會顯示在「Select Hardware」視窗中。您可以點選「Next」建立使用這個硬體設定檔的 AVD，也可以按一下「Cancel」返回「Virtual」分頁或目標裝置選單。

編輯現有的 AVD

在裝置管理工具的「Virtual」分頁中，您可以對 AVD 執行下列作業：

• 如要編輯 AVD，請按一下「Edit this AVD」圖示 ，然後進行變更。
• 如要刪除 AVD，請按一下「Menu」圖示 ，然後選取「Delete」。
• 如要顯示磁碟中相關聯的 AVD INI 和 IMG 檔案，請按一下「Menu」圖示 ，然後選取「Show on Disk」。
• 如要查看 AVD 設定詳細資料 (可附加至提供給 Android Studio 團隊的錯誤報告)，請按一下「Menu」圖示 ，然後選取「View Details」。

編輯現有的硬體設定檔

您無法編輯或刪除預先載入的硬體設定檔，但可以在「Select Hardware」視窗中對其他硬體設定檔執行下列作業：

• 如要編輯硬體設定檔，請選取所需設定檔，然後按一下「Edit Device」。您也可以在硬體設定檔上按一下滑鼠右鍵，選取「Edit」，接著就能進行變更。
• 如要刪除硬體設定檔，請在該設定檔上按一下滑鼠右鍵，然後選取「Delete」。

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

透過「Virtual」分頁，您可以在模擬器中執行下列作業：

• 如要執行使用 AVD 的模擬器，請按一下「Launch」圖示 。
• 如要停止執行中的模擬器，請按一下「Menu」圖示 ，然後選取「Stop」。
• 如要清除模擬器資料，請按一下「Menu」圖示 ，然後選取「Wipe Data」。

匯入及匯出硬體設定檔

您可以在「Select Hardware」視窗中匯入及匯出硬體設定檔，方法如下：

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

AVD 屬性

AVD 設定會指定開發電腦與模擬器的互動方式，以及您想在硬體設定檔中覆寫的屬性。您可以在「Verify Configuration」視窗中指定 AVD 設定的下列屬性。下表中有些屬性標有「(進階)」字樣，您必須點選「Show Advanced Settings」才會看到這些屬性。

AVD 設定屬性會覆寫硬體設定檔屬性，而您在模擬器執行期間設定的模擬器屬性，則會覆寫 AVD 設定與硬體設定檔的屬性。

表 1：AVD 設定屬性

硬體設定檔屬性

您可以在「Configure Hardware Profile」視窗中指定硬體設定檔的下列屬性。AVD 設定屬性會覆寫硬體設定檔屬性，而您在模擬器執行期間設定的模擬器屬性，則會覆寫 AVD 設定與硬體設定檔的屬性。

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

針對某些裝置類型，系統會停用部分屬性。舉例來說，「Round」屬性僅適用於 Wear OS 裝置。

表 2：硬體設定檔的設定屬性

建立模擬器外觀

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. 在裝置設定的 INI 檔案中，指定額外的硬體專屬裝置設定，例如 hw.keyboard 和 hw.lcd.density。
5. 封存外觀資料夾中的檔案，然後選取封存檔案做為自訂外觀。

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