仮想デバイスを作成して管理する

Android Virtual Device（AVD）では、Android スマートフォンやタブレット、Wear OS、Android TV、Automotive OS デバイスなど、Android Emulator でシミュレートするデバイスの特性を定義できます。デバイス マネージャーは Android Studio から起動できるツールであり、AVD の作成と管理に役立ちます。

新しいデバイス マネージャを開くには、次のいずれかの手順を行います。

• Android Studio のウェルカム画面で、[More Actions] > [Virtual Device Manager] を選択します。

• プロジェクトを開いたら、メインメニュー バーで [View] > [Tool Windows] > [Device Manager] を選択し、+ をクリックして [Create Virtual Device] をクリックします。

デバイスを作成すると、デバイス マネージャー パネルにすべてのデバイスのリストが表示されます。

仮想デバイスを使用して、自動のインストルメンテーション テストをスケーラブルなセルフマネージド方式で実行する場合は、Gradle で管理されているデバイスの使用を検討してください。

AVD について

AVD には、ハードウェア プロファイル、システム イメージ、ストレージ領域、スキンなどのプロパティが含まれています。

マニフェストの <uses-sdk> 設定に基づいて、アプリがサポートする可能性がある各システム イメージごとに AVD を作成することをおすすめします。

ハードウェア プロファイル

ハードウェア プロファイルは工場出荷時のデバイスの特性を定義します。デバイス マネージャーには Google Pixel デバイスなどの特定のハードウェア プロファイルがプリロードされていますが、必要に応じてハードウェア プロファイルの定義またはカスタマイズを行えます。

[Play Store] 列に Google Play ロゴのラベルが付いているデバイス定義には、Google Play ストア アプリと、Google Play 開発者サービスへのアクセスの両方が含まれており、[Extended controls] ダイアログの [Google Play] タブには、デバイスの Google Play 開発者サービスをアップデートできる便利なボタンもあります。

このロゴが付いたデバイスとデバイスの種類が「スマートフォン」のデバイスも、CTS を遵守しており、Google Play ストア アプリを含むシステム イメージを使用できる場合があります。

システム イメージ

[Google API] というラベルの付いたシステム イメージには、Google Play 開発者サービスへのアクセスが含まれています。

[Recommended] タブには推奨されるシステム イメージが一覧表示されます。他のタブには、より包括的なリストが表示されます。右ペインには、選択したシステム イメージが表示されます。

システム イメージの横にダウンロード アイコンが表示される場合、現在そのイメージは開発マシンにインストールされていません。このアイコンをクリックすると、システム イメージをダウンロードできます。システム イメージをダウンロードするには、インターネット接続が必要です。

対象デバイスの API レベルは重要です。アプリが必要とする API レベル（アプリ マニフェスト ファイルの minSdk 属性で指定されているレベル）より低い API レベルのシステム イメージでは、アプリが動作しないからです。システムの API レベルと minSdk の関係については、アプリのバージョニングをご覧ください。

アプリのマニフェスト ファイルで <uses-library> 要素を宣言している場合、その外部ライブラリを含むシステム イメージがアプリに必要です。エミュレータでアプリを実行するには、必要なライブラリを含む AVD を作成します。そのためには、Google マップのライブラリを含む Google API のアドオンなど、AVD プラットフォーム用のアドオン コンポーネントを使用しなければならないことがあります。

アプリのセキュリティを確保し、実際のデバイスと同じように動作できるようにするため、Google Play ストアを含むシステム イメージはリリースキーで署名されています。つまり、それらのイメージでは、昇格された権限（root）を取得できません。

アプリのトラブルシューティングに昇格された権限（root）が必要な場合は、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] をクリックします。

デバイス マネージャーの [Virtual] タブと対象デバイスのメニューに、新しい AVD が表示されます。

コピーから AVD を作成するには:

1. デバイス マネージャーの [Virtual] タブで、メニュー アイコン をクリックして [Duplicate] を選択します。

   [Verify Configuration] ウィンドウが表示されます。

2. [System Image] ウィンドウまたは [Select Hardware] ウィンドウで変更を行う必要がある場合は、[Previous] をクリックします。
3. 必要な変更を行った後、[Finish] をクリックします。

   デバイス マネージャーの [Virtual] タブに、AVD が表示されます。

ハードウェア プロファイルを作成する

デバイス マネージャーには一般的なデバイスのハードウェア プロファイルがあらかじめ定義されており、それらを簡単に自身の AVD 定義に追加できます。異なるデバイスを定義する必要がある場合は、新しいハードウェア プロファイルを作成できます。

新しいハードウェア プロファイルを一から作成することも、ハードウェア プロファイルをコピーしてそれを元に作成することもできます。なお、プリロード済みのハードウェア プロファイルは編集できません。

ハードウェア プロファイルを一から作成するには:

1. [Select Hardware] ウィンドウで、[New Hardware Profile] をクリックします。

2. [Configure Hardware Profile] ウィンドウで、必要に応じてハードウェア プロファイルのプロパティを変更します。

   
3. [Finish] をクリックします。

   [Select Hardware] ウィンドウに、新しいハードウェア プロファイルが表示されます。ハードウェア プロファイルを使用する AVD を作成するには、[Next] をクリックするか、[Cancel] をクリックして [Virtual] タブまたは対象デバイスのメニューに戻ります。

ハードウェア プロファイルをコピーから作成するには:

1. [Select Hardware] ウィンドウでハードウェア プロファイルを選択し、[Clone Device] をクリックするか、ハードウェア プロファイルを右クリックして [Clone] を選択します。

2. [Configure Hardware Profile] ウィンドウで、必要に応じてハードウェア プロファイルのプロパティを変更します。
3. [Finish] をクリックします。

[Select Hardware] ウィンドウに、新しいハードウェア プロファイルが表示されます。ハードウェア プロファイルを使用する AVD を作成するには、[Next] をクリックするか、[Cancel] をクリックして [Virtual] タブまたは対象デバイスのメニューに戻ります。

既存の AVD を編集する

デバイス マネージャーの [Virtual] タブで、AVD に対して以下の操作を行うことができます。

• AVD の編集。Edit this AVD アイコン をクリックして変更を加えます。
• AVD の削除。メニュー アイコン をクリックして [Delete] を選択します。
• ディスク上の関連する AVD の INI ファイルと IMG ファイルの表示。メニュー アイコン をクリックして [Show on Disk] を選択します。
• AVD 構成の詳細情報の表示。この情報を Android Studio チームへのバグレポートに記載できます。メニュー アイコン をクリックして [View Details] を選択します。

既存のハードウェア プロファイルを編集する

プリロードされているハードウェア プロファイルを編集または削除することはできませんが、それ以外のハードウェア プロファイルについては、[Select Hardware] ウィンドウで以下の操作を行うことができます。

• ハードウェア プロファイルの編集。ハードウェア プロファイルを選択して [Edit Device] をクリックします。または、ハードウェア プロファイルを右クリックして [Edit] を選択します。次に、変更を加えます。
• ハードウェア プロファイルの削除。ハードウェア プロファイルを右クリックして [Delete] を選択します。

エミュレータの実行と停止、データの消去を行う

[Virtual] タブで、エミュレータに対して以下の操作を行うことができます。

• AVD を使用するエミュレータの実行。Launch アイコン をクリックします。
• 実行中のエミュレータの停止。メニュー アイコン をクリックして [Stop] を選択します。
• エミュレータのデータの消去。メニュー アイコン をクリックして [Wipe Data] を選択します。

ハードウェア プロファイルをインポートおよびエクスポートする

[Select Hardware] ウィンドウで、次のようにしてハードウェア プロファイルのインポートとエクスポートを行うことができます。

• ハードウェア プロファイルをインポートするには、[Import Hardware Profiles] をクリックして、コンピュータ上の定義を含む XML ファイルを選択します。
• ハードウェア プロファイルをエクスポートするには、ハードウェア プロファイルを右クリックして [Export] を選択し、定義を含む XML ファイルを保存する場所を指定します。

AVD プロパティ

AVD 構成では、開発用コンピュータとエミュレータのインタラクションに加え、ハードウェア プロファイルでオーバーライドするプロパティを指定できます。[Verify Configuration] ウィンドウでは、AVD 構成の以下のプロパティを指定できます。(Advanced) というラベルが付いているプロパティは、[Show Advanced Settings] をクリックした場合にのみ表示されます。

AVD 構成のプロパティはハードウェア プロファイルのプロパティをオーバーライドします。エミュレータの実行中に設定したエミュレータ プロパティはこの両方のプロパティをオーバーライドします。

表 1. AVD 構成プロパティ

ハードウェア プロファイルのプロパティ

[Configure Hardware Profile] ウィンドウでは、ハードウェア プロファイルの以下のプロパティを指定できます。AVD 構成のプロパティはハードウェア プロファイルのプロパティをオーバーライドします。エミュレータの実行中に設定したエミュレータ プロパティはこの両方のプロパティをオーバーライドします。

デバイス マネージャーに含まれる事前定義されたハードウェア プロファイルは編集できません。ただし、プロファイルをコピーして編集することは可能です。

デバイスタイプによっては、一部のプロパティは無効になっています。たとえば、「Round」プロパティは Wear OS デバイスでのみ使用可能です。

表 2. ハードウェア プロファイル構成プロパティ

エミュレータ スキンを作成する

Android Emulator スキンは、エミュレータ ディスプレイの視覚要素とコントロール要素を定義するファイルの集合です。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 スキンファイル仕様をご覧ください。