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

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 device] をクリックします。

新しいデバイスマネージャーウィンドウ

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

AVD について

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

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

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

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

[Select Hardware] ダイアログ

一部のハードウェアプロファイルにのみ、Play ストアが含まれています。これらのプロファイルは CTS に完全に対応しており、Play ストアアプリを含むシステムイメージを使用できます。

[Play Store] 列に Google Play ロゴのラベルが付いているデバイス定義には、Google Play ストアアプリと、Google Play 開発者サービスへのアクセスの両方が含まれており、[Extended controls] ダイアログの [Google Play] タブで、デバイスの 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 を新規作成するには:

デバイスマネージャーを開きます。
[Create Device] をクリックします。
[Select Hardware] ウィンドウが表示されます。

一部のハードウェアプロファイルにのみ、Play ストアが含まれています。これらのプロファイルは CTS に完全に対応しており、Play ストアアプリを含むシステムイメージを使用できます。
ハードウェアプロファイルを選択して [Next] をクリックします。
使用したいハードウェアプロファイルがない場合は、ハードウェアプロファイルを作成またはインポートできます。手順については、このページの別のセクションをご覧ください。

[System Image] ウィンドウが表示されます。
特定の API レベル用のシステムイメージを選択して [Next] をクリックします。

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

必要に応じて AVD プロパティを変更し、[Finish] をクリックします。
スキンなどの詳細設定を確認するには、[Show Advanced Settings] をクリックします。

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

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

デバイスマネージャーの [Virtual] タブで、メニュー アイコンをクリックして [Duplicate] を選択します。
[Verify Configuration] ウィンドウが表示されます。
[System Image] ウィンドウまたは [Select Hardware] ウィンドウで変更を行う必要がある場合は、[Previous] をクリックします。
必要な変更を行った後、[Finish] をクリックします。
デバイスマネージャーの [Virtual] タブに、AVD が表示されます。

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

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

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

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

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

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

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

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

[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 構成プロパティ

AVD プロパティ	説明
AVD Name	AVD の名前を入力します。使用できるのは、英字の大文字と小文字、数字、ピリオド、アンダースコア、丸かっこ、ダッシュ、スペースです。この AVD 名が、AVD 構成を保存するファイルの名前になります。
AVD ID (Advanced)	AVD ID を示します。AVD 名が AVD ID になります。この ID を使用して、コマンドラインから AVD を参照できます。
Hardware Profile	[Change] をクリックすると、[Select Hardware] ウィンドウで異なるハードウェアプロファイルを選択できます。
System Image	[Change] をクリックすると、[System Image] ウィンドウで異なるシステムイメージを選択できます。新しいイメージをダウンロードする際はインターネット接続が必要です。
Startup orientation	次のいずれかを選択して、エミュレータ画面の初期の向きを決定します。 Portrait: 縦向き（縦長の画面） Landscape: 横向き（横長の画面）このオプションは、ハードウェアプロファイルでサポートされている場合にのみ、有効になります。ハードウェアプロファイルで縦向きと横向きの両方がサポートされている場合は、エミュレータで AVD を実行している最中に画面の向きを切り替えることができます。
Camera (Advanced)	有効なカメラのオプションを選択します。[Emulated] 設定と [VirtualScene] 設定では、ソフトウェアが生成する画像を作成します。[Webcam] 設定では、開発用コンピュータのウェブカメラを使用して写真を撮影します。カメラオプションは、ハードウェアプロファイルでカメラがサポートされている場合にのみ、使用できます。Wear OS、Android TV、Google TV では使用できません。
Network: Speed (Advanced)	データ転送速度を決定するネットワークプロトコルを選択します。 GSM: Global System for Mobile Communications HSCSD: High-Speed Circuit-Switched Data GPRS: Generic Packet Radio Service EDGE: Enhanced Data rates for GSM Evolution UMTS: Universal Mobile Telecommunications System HSDPA: High-Speed Downlink Packet Access LTE: Long-Term Evolution Full（デフォルト）: コンピュータで実現できる最高速度でデータを転送します。
Network: Latency (Advanced)	ネットワークプロトコルを選択して、そのプロトコルである地点から別の地点へデータパケットを転送するのにかかる時間を設定します。
Emulated Performance: Graphics	エミュレータでグラフィックをレンダリングする方法を選択します。 Hardware: コンピュータグラフィックカードを使用して高速レンダリングを行います。 Software: ソフトウェアでグラフィックをエミュレートします。グラフィックカードでのレンダリングに問題がある場合に役立ちます。 Automatic: グラフィックカードに応じて、エミュレータが最適なオプションを決定します。
Emulated Performance: Boot option (Advanced)	AVD の起動方法を選択します。 Cold boot: デバイスは、毎回電源オフの状態から電源オンの状態になります。 Quick boot: デバイスは、保存されたスナップショットからデバイスの状態を読み込みます。
Emulated Performance: Multi-Core CPU (Advanced)	エミュレータに使用する、コンピュータ上のプロセッサコア数を選択します。プロセッサコア数が多いほど、エミュレータは高速になります。
Memory and Storage: RAM (Advanced)	ハードウェアメーカーが設定したデバイスの RAM 容量をオーバーライドします。サイズを大きくすると、コンピュータのリソースがより多く消費されますが、エミュレータのオペレーションがより高速になります。RAM サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）のいずれかの単位を選択します。
Memory and Storage: VM Heap (Advanced)	ハードウェアメーカーが設定した VM ヒープサイズをオーバーライドします。ヒープサイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）のいずれかの単位を選択します。
Memory and Storage: Internal Storage (Advanced)	ハードウェアメーカーが設定した、デバイスで使用できる非リムーバブルメモリ領域の容量をオーバーライドします。サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）のいずれかの単位を選択します。
Memory and Storage: SD Card (Advanced)	デバイス上でデータの保存に使用できるリムーバブルメモリ領域の容量を指定します。 Android Studio によって管理される仮想 SD カードを使用するには、[Studio-managed] を選択し、サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）のいずれかの単位を選択します。カメラを使用する場合は、100 MB 以上に設定することをおすすめします。この領域をファイルで管理するには、[External file] を選択し、[...] をクリックして、ファイルと場所を指定します。詳細については、`mksdcard` と AVD データディレクトリをご覧ください。
Device Frame: Enable Device Frame	エミュレータウィンドウの周りに表示されるフレームを有効にすると、実際のデバイスの外観を再現できます。
Custom Skin Definition（Advanced）	エミュレータで表示されたときのデバイスの外観を決定するスキンを選択します。スキンに対して大きすぎる画面サイズを指定すると、画面の一部がカットされ、画面全体を表示できなくなります。詳細については、エミュレータスキンを作成するをご覧ください。
Keyboard: Enable Keyboard Input (Advanced)	ハードウェアキーボードを使用してエミュレータを操作する場合は、このオプションを選択します。Wear OS と Android TV の場合、このオプションは無効になります。

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

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

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

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

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

ハードウェアプロファイルのプロパティ	説明
Device Name	ハードウェアプロファイルの名前を入力します。使用できるのは、英字の大文字と小文字、数字、ピリオド、アンダースコア、丸かっこ、スペースです。このハードウェアプロファイル名が、ハードウェアプロファイルを保存するファイルの名前になります。
Device Type	次のいずれかを選択します。 Phone/Tablet Wear OS Android TV Google TV Chrome OS Device Android Automotive
Screen: Screen Size	対角線で計測された画面の物理サイズをインチ単位で指定します。このサイズがコンピュータの画面よりも大きい場合、起動時に縮小されます。
Screen: Screen Resolution	ピクセル単位で幅と高さを入力して、シミュレートされる画面の総ピクセル数を指定します。
Screen: Round	一部の Wear OS デバイスのような画面が丸いデバイスの場合は、このオプションを選択します。
Memory: RAM	デバイスの RAM サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）のいずれかの単位を選択します。
Input: Has Hardware Buttons (Back/Home/Menu)	デバイスにハードウェアナビゲーションボタンがある場合は、このオプションを選択します。これらのボタンがソフトウェアでのみ実装されている場合は、選択を解除します。このオプションを選択した場合、これらのボタンは画面に表示されません。いずれの場合も、エミュレータのサイドパネルを使用して、ボタンの押下をシミュレートできます。
Input: Has Hardware Keyboard	デバイスにハードウェアキーボードがある場合は、このオプションを選択します。ない場合は選択を解除します。このオプションを選択した場合、キーボードは画面に表示されません。いずれの場合も、コンピュータのキーボードを使用して、キー入力をエミュレータに送信できます。
Input: Navigation Style	次のいずれかを選択します。 None: ハードウェアコントロールを行いません。ソフトウェアを介してナビゲーションを行います。 D-pad: 十字キーをサポートします。 Trackball Wheel これらのオプションは、デバイス本体のハードウェアコントロールに使用します。ただし、外部コントローラによってデバイスに送信されるイベントにも同様に使用します。
Supported device states	次のいずれかまたは両方を選択します。 Portrait: 縦向き（縦長の画面） Landscape: 横向き（横長の画面）少なくとも 1 つのオプションを選択する必要があります。両方を選択した場合は、エミュレータで向きを切り替えることができます。
Cameras	カメラを有効にするには、次のいずれかまたは両方を選択します。 Back-Facing Camera: レンズがユーザーの反対側にあるカメラ Front-Facing Camera: レンズがユーザーと同じ側にあるカメラカメラが有効になっている場合は、AVD 構成で選択したオプションに基づいて、開発マシンのウェブカメラか、エミュレータが提供する写真を使用して、写真の撮影をシミュレートできます。 <
Sensors: Accelerometer	向きの判定に役立つハードウェアをデバイスが備えている場合は、このオプションを選択します。
Sensors: Gyroscope	回転または傾きを検出するハードウェアをデバイスが備えている場合は、このオプションを選択します。ジャイロスコープを加速度計と組み合わせると、向きの検出がよりスムーズになり、6 軸方向システムに対応できます。
Sensors: GPS	グローバルポジショニングシステム（GPS）の衛星測位システムをサポートするハードウェアをデバイスが備えている場合は、このオプションを選択します。
Sensors: Proximity Sensor	通話時にデバイスがユーザーの顔に近づいたことを検出して画面からの入力を無効にするハードウェアをデバイスが備えている場合は、このオプションを選択します。
Default Skin	エミュレータで表示されたときのデバイスの外観を決定するスキンを選択します。解像度に対して大きすぎる画面サイズを指定すると、画面の一部がカットされ、画面全体を表示できなくなります。詳細については、以下のエミュレータスキンを作成するをご覧ください。

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

Android Emulator スキンは、エミュレータディスプレイの視覚要素とコントロール要素を定義するファイルの集合です。AVD 設定で利用可能なスキン定義の中に、自身の要件を満たすものがない場合は、自身でカスタムスキンの定義を作成して AVD に適用できます。

各エミュレータスキンには、以下のものが含まれます。

hardware.ini ファイル
サポートされる画面の向きと物理構成に対応するレイアウトファイル
背景、キー、ボタンなどのディスプレイ要素に対応する画像ファイル

カスタムスキンを作成して使用するには:

スキン構成ファイルを保存するディレクトリを作成します。

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
            }
        }
    }
    ...
}

同じディレクトリに、デバイス画像のビットマップファイルを追加します。
デバイス設定用の INI ファイルで、追加のハードウェア固有のデバイス設定（hw.keyboard や hw.lcd.density など）を指定します。
スキンフォルダ内のファイルをアーカイブして、そのファイルをカスタムスキンとして選択します。

エミュレータスキンの作成に関する詳細については、ツールのソースコードに含まれている Android Emulator スキンファイル仕様をご覧ください。

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

AVD について

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

システム イメージ