設定可能なエミュレータを使用してテストする
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
OEM 全体で使用されている一部の構成をエミュレートできるように、特定のハードウェア プロファイルはランタイム構成をサポートしています。
これらの構成は、ランタイム リソース オーバーレイ(RRO)を使用して実装され、adb shell cmd overlay
コマンドを使用して管理できます。
RRO を有効または無効にするには、次のコマンドを使用します。
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
システムバーの位置を変更する
デフォルトでは、構成可能なエミュレータには 2 つのシステムバーがあります。画面上部のステータスバーと画面下部のナビゲーション バーです。多くの車はこのレイアウトを共有していますが、そうでない車もあります。特に注意すべき点として、一部の自動車ではシステムバーが画面の縦方向ではなく横方向に配置されているため、モバイル フォーム ファクタ向けのアプリを開発する際に想定していたことが崩れる可能性があります。詳細と技術的なガイダンスについては、システムバー、没入モード、エッジ ツー エッジのレンダリングをご覧ください。
システムバーを変更するには、次の RRO を使用します。
com.android.systemui.rro.bottom
com.android.systemui.rro.bottom.rounded
com.android.systemui.rro.left
com.android.systemui.rro.right
ディスプレイ カットアウトをエミュレートする
一部の自動車のディスプレイ カットアウトは、モバイル デバイスの場合とは大きく異なります。モバイル デバイスの場合はノッチやピンホールカメラのためのカットアウトが一般的ですが、Android Automotive OS を搭載した自動車には、非矩形の画面(輪郭が曲線になっているもの)が採用されている場合もあります。詳細と技術的なガイダンスについては、不規則な形状のディスプレイに適応するをご覧ください。
ディスプレイの切り欠きをエミュレートするには、次の RRO を使用できます。
com.android.internal.display.cutout.emulation.top_and_right
com.android.internal.display.cutout.emulation.free_form
com.android.internal.emulation.automotive_ultrawide_cutout
推奨されるテスト構成
これらの RRO を組み合わせて作成できる構成の合計数は非常に多いため、現在走行している一部の自動車に似ている次のハードウェア プロファイルと RRO の組み合わせを使用してアプリをテストすることをおすすめします。
com.android.systemui.rro.left
または com.android.systemui.rro.right
の Automotive (1080p landscape)
com.android.systemui.rro.left
と com.android.internal.emulation.automotive_ultrawide_cutout
を使用したAutomotive Ultrawide
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-07-27 UTC。
[null,null,["最終更新日 2025-07-27 UTC。"],[],[],null,["# Test using the configurable emulator\n\nTo help emulate some of the configurations seen across OEMs, certain [hardware\nprofiles](/training/cars/testing/emulator#bundled-profiles) support runtime\nconfigurability.\n\nThese configurations are implemented using [Runtime Resource\nOverlays](https://source.android.com/docs/core/runtime/rros) (RROs)\nand can be managed using the `adb shell cmd overlay` command.\n\nUse the following commands to enable or disable a RRO: \n\n adb shell cmd overlay enable \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e\n adb shell cmd overlay disable \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e\n\nModify system bar position\n--------------------------\n\nBy default, the configurable emulator has two system bars -- a status bar on the\ntop of the screen and a navigation bar at the bottom of the screen. Though many\ncars share this layout, some don't. Of particular note is that some cars have\ntheir system bar(s) on the horizontal sides of the screen and not the vertical\nsides, which may break assumptions made when developing apps for mobile form\nfactors. See [System bars, immersive mode, and\nedge-to-edge rendering](/training/cars/parked/automotive-os#bars-immersive-edge)\nfor more details and technical guidance.\n\nThe following RROs can be used to modify the system bars:\n\n- `com.android.systemui.rro.bottom`\n- `com.android.systemui.rro.bottom.rounded`\n- `com.android.systemui.rro.left`\n- `com.android.systemui.rro.right`\n\nEmulate display cutouts\n-----------------------\n\nSome cars have screens with display cutouts that are very different when\ncompared to those seen on mobile devices. Instead of the notches or pinhole\ncamera cutouts, some Android Automotive OS vehicles have curved screens that\nmake the screen non-rectangular. See [Adapt to irregularly shaped displays](/training/cars/parked/automotive-os#irregular-displays)\nfor more details and technical guidance.\n\nThe following RROs can be used to emulate display cutouts:\n\n- `com.android.internal.display.cutout.emulation.top_and_right`\n- `com.android.internal.display.cutout.emulation.free_form`\n- `com.android.internal.emulation.automotive_ultrawide_cutout`\n\nRecommended testing configurations\n----------------------------------\n\nSince the total number of configurations that can be created by combining these\nRROs is quite large, we recommend testing your app using the following\ncombinations of [hardware profiles](/training/cars/testing/emulator#bundled-profiles)\nand RROs, which are similar to some vehicles on the road today.\n\n- *Automotive (1080p landscape)* with `com.android.systemui.rro.left` or `com.android.systemui.rro.right`\n- *Automotive Ultrawide* with `com.android.systemui.rro.left` and `com.android.internal.emulation.automotive_ultrawide_cutout`"]]