このページは Cloud Translation API によって翻訳されました。

Android Automotive OS エミュレータを使用してテストする

Android Emulator を使用して、Android Automotive OS 上でアプリの動作をテストできます。

システムイメージを追加する

Android Automotive OS 仮想デバイスを作成するには、Android Studio SDK Manager を使用してシステムイメージを追加する必要があります。

Generic System Image の追加

Android Studio には、アプリのテストに使用できる Android Automotive OS 用の Generic System Image が含まれています。このイメージは、Play ストアのスクリーンショットを撮影するときに使用する必要があります。

名前	API レベル	アーキテクチャ	Google Play 開発者サービス	Google Play ストア	Google Automotive App Host
Automotive Intel x86 Atom System Image	28	x86	✔	✔	（この API レベルの市販車では利用不可）。
Automotive with Play Store Intel x86 Atom System Image	29	x86	✔	✔	✔
Automotive with Play Store Intel x86 Atom_64 System Image	30	x86	✔	✔	✔
Automotive with Play Store ARM 64 v8a System Image	32	ARM	✔	✔	✔
Automotive with Play Store Intel x86 Atom_64 System Image	32	x86	✔	✔	✔
Google API を使用した Android Automotive ARM 64 v8a システムイメージ	33	ARM	✔		✔
Google API を使用した Android Automotive Intel x86 Atom_64 システムイメージ	33	x86	✔		✔

Generic System Image をインストールする手順は次のとおりです。

Android Studio で、[Tools] > [SDK Manager] を選択します。
[SDK Platforms] タブをクリックします。
[Show Package Details] をクリックします。
ダウンロードするイメージを選択します（詳細については上の表を参照）
[Apply]、[OK] の順にクリックします。

OEM のシステムイメージを追加する

GM、Honda、Polestar、Volvo などの OEM 固有のシステムイメージを追加することもできます。OEM のデベロッパーサイトに記載されている手順に沿って行ってください。

以下に、アルファベット順で示します。

車の AVD を作成してエミュレータを実行する

以下の手順に沿って、Android Automotive OS 搭載車を表す Android Virtual Device（AVD）を作成し、その AVD を使用してエミュレータを実行します。

Android Studio で、[Tools] > [AVD Manager] を選択します。
[Create Virtual Device] をクリックします。
[Select Hardware] ダイアログで [Automotive] を選択し、ハードウェアプロファイルを選択します。[Next] をクリックします。
[Android 12L（Play Store の Automotive）] など、Automotive をターゲットとするシステムイメージを選択し、[Next] をクリックします。
AVD に名前を付け、カスタマイズするその他のオプションを選択して、[Finish] をクリックします。
ツールウィンドウバーから、デプロイのターゲットとして Android Automotive OS AVD を選択します。
実行アイコンをクリックします。

バンドルされたハードウェアプロファイルを使用する

AVD を作成する際は、Android Studio にバンドルされている次のハードウェアプロファイルを使用できます。

名前	解決策	対象	互換性
自動車（1024p 横向き）	1024x768	Android Studio	Play ストアのシステムイメージ
自動車（1080p 横向き）	1080×600	Android Studio	Play ストアなしのシステムイメージ
自動車の縦長	800×1280	Android Studio Canary	Play ストアなしのシステムイメージ

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

バンドルされたハードウェアプロファイルに含まれていないハードウェア構成をテストする場合は、Android Automotive OS エミュレータで使用するハードウェアプロファイルを作成することもできます。これを行うには、作成フローでデバイスタイプとして [Android Automotive] を選択します。カスタムハードウェアプロファイルは、Play ストアを含まないシステムイメージにのみ互換性があります。

エミュレータの拡張コントロールを使用する

他の Android エミュレータで利用可能な標準の拡張コントロールの多くに加え、Android Automotive OS エミュレータ専用の拡張コントロールもあります。

ハードウェアの状態をエミュレートする

標準の Android API を使用して読み取り可能な加速度計やジャイロスコープなどのセンサー（利用可能な場合）に加えて、車両に固有の追加のハードウェアプロパティがVehicle Hardware Abstraction Layer（VHAL）を介して伝達されます。これらのプロパティは、VehiclePropertyIds クラスによってモデル化されます。

エミュレータの実行中に、拡張コントロールの自動車データ機能からこれらのプロパティの値を変更できます。たとえば、車両の現在の速度を設定するには、速度のプロパティ（VehiclePropertyIds.PERF_VEHICLE_SPEED）を見つけてその値を変更します。

運転をシミュレーションする

運転をシミュレートするには、[自動車の速度] を 0 以外の値、[Gear] を [P (Park)] 以外に設定する必要があります。駐車状態をシミュレートするには、Gear を P（Park）に設定するだけで済みます。そのためには、[Car sensor data] タブのスライダーとセレクタを使用するか、前のセクションで説明したように VHAL プロパティを変更します。

ロータリー入力をテストする

一部の Android Automotive OS 車両には、タッチスクリーンに加えてロータリーコントローラが搭載されています。このロータリーコントローラは、キーボードナビゲーションと同じフォーカス API を使用して、ユーザーが画面に触れることなくアプリを操作できるようにします。拡張コントロール内で車のロータリー ツールを使用して、アプリのロータリー入力のサポートをテストできます。

メディアアプリの実行構成を編集する

Automotive OS アプリのメディアアプリは、他の Android アプリとは異なります。Android Automotive OS は、明示的インテントを使用して、メディアブラウザサービスに呼び出しを送信することで、メディアアプリとやり取りします。

アプリをテストするには、アプリのマニフェストに起動アクティビティがないことを確認し、次の手順に沿って自動車モジュールがアクティビティで起動しないようにします。

Android Studio で、[Run] > [Edit Configurations] を選択します。
アプリのモジュールのリストから、自動車モジュールを選択します。
[Launch Options] > [Launch] で、[Nothing] を選択します。
[Apply]、[OK] の順にクリックします。

デスクトップヘッドユニットを使用してテストする