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

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] を選択します。

[Pair device] メニューオプションがハイライト表示されている新しいデバイスマネージャウィンドウ

AVD について

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

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

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

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

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

システムイメージ

[Google API] というラベルの付いたシステムイメージには、Google Play 開発者サービスへのアクセスが含まれています。[Play Store] 列に Google Play のロゴが付いているシステムイメージには、Google Play ストアアプリと Google Play 開発者サービスへのアクセスが含まれ、[Extended controls] ダイアログの [Google Play] タブには、デバイスの Google Play 開発者サービスをアップデートするのに便利なボタンが提供されます。

アプリのセキュリティを確保し、実際のデバイスと同じように動作できるようにするため、Google Play ストアを含むシステムイメージはリリースキーで署名されています。つまり、それらのイメージでは、昇格された権限（root）を取得することはできません。アプリのトラブルシューティングに昇格された権限（root）が必要な場合は、Google のアプリやサービスが含まれていない Android オープンソースプロジェクト（AOSP）のシステムイメージを使うことができます。

ストレージ領域

AVD は開発マシン上に専用のストレージ領域を確保します。インストールしたアプリや設定内容、エミュレートされた SD カードなどのデバイスのユーザーデータは、そのストレージ領域に保存されます。必要に応じて、デバイスマネージャを使用してユーザーデータを消去し、デバイス内のデータを新品と同じ状態に戻せます。

スキン

エミュレータスキンはデバイスの外観を決めるものです。デバイスマネージャには、あらかじめスキンがいくつか用意されています。また、自身で定義したスキンやサードパーティから提供されたスキンを使用することもできます。

AVD とアプリの機能

AVD 定義に、アプリが依存しているデバイス機能が含まれていることを確認してください。 AVD で定義できる機能のリストについては、ハードウェアプロファイルのプロパティと AVD プロパティをご覧ください。

AVD を作成する

ヒント: アプリをエミュレータで起動する場合は、その代わりに Android Studio からアプリを実行し、表示される [Select Deployment Target] ダイアログで [Create New Virtual Device] をクリックします。

AVD を新規作成するには:

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

一部のハードウェアプロファイルにのみ、Play ストアが含まれることが示されています。これは、それらのプロファイルが CTS を完全に遵守し、Play ストアアプリを含むシステムイメージを使用できることを示しています。
ハードウェアプロファイルを選択して [Next] をクリックします。

使用したいハードウェアプロファイルがない場合は、ハードウェアプロファイルを作成またはインポートできます。

[System Image] ページが表示されます。

特定の API レベル用のシステムイメージを選択して [Next] をクリックします。

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

システムイメージの隣に [Download] と表示されている場合は、クリックしてシステムイメージをダウンロードする必要があります。ダウンロードするにはインターネット接続が必要です。

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

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

[Verify Configuration] ページが表示されます。

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

新しい AVD が、デバイスマネージャの [Virtual] タブとターゲットのプルダウンメニューに表示されます。

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

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

[Verify Configuration] ページが表示されます。

[System Image] ページと [Select Hardware] ページで変更を行う必要がある場合は、[Change] または [Previous] をクリックします。
変更が完了したら、[Finish] をクリックします。

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

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

デバイスマネージャには一般的なデバイスのハードウェアプロファイルがあらかじめ定義されており、それらを簡単に自身の AVD 定義に追加できます。一方、別のデバイスを定義する必要がある場合は、ハードウェアプロファイルを新規作成できます。新しいハードウェアプロファイルを一から作成することも、ハードウェアプロファイルをコピーしてそれを元に作成することもできます。なお、プリロード済みのハードウェアプロファイルは編集できません。

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

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

新しいハードウェアプロファイルが [Select Hardware] ページに表示されます。 [Next] をクリックすると、オプションとして、そのハードウェアプロファイルを使用する AVD を作成できます。[Cancel] をクリックすると、[Virtual] タブまたはターゲットデバイスのプルダウンメニューに戻ります。

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

[Select Hardware] ページでハードウェアプロファイルを選択し、[Clone Device] をクリックします。

またはハードウェアプロファイルを右クリックして、[Clone] を選択します。

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

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

既存の 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] を選択するか、メニューアイコンをクリックして [Wipe Data] を選択します。

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

[Select Hardware] ページからハードウェアプロファイルのインポートとエクスポートができます。

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

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

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

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

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

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

AVD プロパティ

[Verify Configuration] ページで、AVD 構成の以下のプロパティを指定できます。 AVD 構成では、開発用コンピュータとエミュレータのインタラクションに加え、ハードウェアプロファイルでオーバーライドするプロパティを指定できます。

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

AVD プロパティ	説明
AVD Name	AVD の名前。使用できるのは大文字と小文字の英字、0 から 9 までの数字、ピリオド（.）、アンダースコア（_）、丸かっこ（()）、ダッシュ（-）、スペースです。この AVD 名が、AVD 構成を保存するファイルの名前になります。
AVD ID (Advanced)	この ID が AVD ファイル名になり、コマンドラインから AVD を参照するのに使用できます。
Hardware Profile	[Change] をクリックすると、[Select Hardware] ページで異なるハードウェアプロファイルを選択できます。
System Image	[Change] をクリックすると、[System Image] ページで異なるシステムイメージを選択できます。新しいイメージをダウンロードする際はインターネット接続が必要です。
Startup Orientation	どちらかを選択して、エミュレータ画面の初期の向きを決定します。 [Portrait]: 縦長の画面になります。 [Landscape]: 横長の画面になります。このオプションはハードウェアプロファイルで選択している場合のみ、有効になります。ハードウェアプロファイルで縦向きと横向きの両方をサポートしている場合、エミュレータで AVD を実行している最中に画面の向きを切り替えることができます。
Camera (Advanced)	カメラを有効にするには、以下のどちらか、または両方を選択します。 [Front]: ユーザーの反対方向を向いたカメラを有効にします。 [Back]: ユーザーの方向を向いたカメラを有効にします。 [Emulated] 設定では、ソフトウェアで生成される画像を作成します。[Webcam] 設定では、開発用コンピュータのウェブカメラを使用して写真を撮影できます。このオプションはハードウェアプロファイルで選択している場合のみ、有効になります。Wear OS と Android 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 (default)]: コンピュータで実現できる最高速度でデータを転送します。
Network: Latency (Advanced)	ネットワークプロトコルを選択して、そのネットワークプロトコルがある地点から別の地点へデータパケットを転送する際の遅延時間を設定します。
Emulated Performance: Graphics	エミュレータでのグラフィックのレンダリング方法を選択します。 [Hardware]: コンピュータグラフィックカードを使用して高速レンダリングします。 [Software]: ソフトウェアでグラフィックをエミュレートします。グラフィックカードでのレンダリングに問題がある場合に便利です。 [Automatic]: グラフィックカードに応じてエミュレータが最適なオプションを選択します。
Emulated Performance: Boot option (Advanced)	[Cold boot]: 毎回、デバイスがオフの状態から電源を入れてデバイスを起動します。 [Quick boot]: 保存されたスナップショットからデバイスの状態を読み込んでデバイスを起動します。詳細については、クイックブートでエミュレータを実行するをご覧ください。
Emulated Performance: Multi-Core CPU (Advanced)	エミュレータに使用するコンピュータ上のプロセッサコア数を選択します。プロセッサコア数が多いほどエミュレータが高速になります。
Memory and Storage: RAM	デバイスの RAM 容量。この値はハードウェアメーカーによって設定されていますが、エミュレータの動作を高速化したい場合など、必要に応じてオーバーライドできます。このサイズを大きくするほど、コンピュータのリソースをより多く使用します。RAM サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）から単位を選択します。
Memory and Storage: VM Heap	VM ヒープサイズ。この値はハードウェアメーカーによって設定されていますが、必要に応じてオーバーライドできます。ヒープサイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）から単位を選択します。Android VM の詳細については、さまざまな仮想マシンでのメモリ管理をご覧ください。
Memory and Storage: Internal Storage	デバイスで利用可能な取り外しができないメモリ領域の容量。この値はハードウェアメーカーによって設定されていますが、必要に応じてオーバーライドできます。サイズを入力して、B（バイト）、KB（キロバイト）、MB（メガバイト）、GB（ギガバイト）、TB（テラバイト）から単位を選択します。
Memory and Storage: SD Card	デバイス上のデータの保存に利用できる取り外し可能なメモリ領域の容量。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 向けには、このオプションは無効になっています。

エミュレータスキンの作成

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

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

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

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

AVD について

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

システム イメージ