구성 가능한 에뮬레이터를 사용하여 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
OEM에서 볼 수 있는 일부 구성을 에뮬레이션하는 데 도움이 되도록 특정 하드웨어 프로필은 런타임 구성 가능성을 지원합니다.
이러한 구성은 런타임 리소스 오버레이 (RRO)를 사용하여 구현되며 adb shell cmd overlay
명령어를 사용하여 관리할 수 있습니다.
다음 명령어를 사용하여 RRO를 사용 설정하거나 중지합니다.
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
시스템 표시줄 위치 수정
기본적으로 구성 가능한 에뮬레이터에는 두 개의 시스템 표시줄이 있습니다. 화면 상단의 상태 표시줄과 화면 하단의 탐색 메뉴입니다. 많은 자동차가 이 레이아웃을 공유하지만 일부는 그렇지 않습니다. 특히 일부 자동차에는 시스템 표시줄이 세로 측면이 아닌 화면의 가로 측면에 있어 모바일 폼 팩터용 앱을 개발할 때의 가정이 무너질 수 있습니다. 자세한 내용과 기술 안내는 시스템 표시줄, 몰입형 모드, 더 넓은 화면 렌더링을 참고하세요.
다음 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
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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`"]]