매니페스트 파일 구성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Android Auto 및 Android Automotive OS (AAOS)와 통합되도록 앱의 매니페스트 파일을 구성합니다. 이러한 플랫폼에서 검색 및 연결을 사용 설정하려면 매니페스트에서 미디어 브라우저 서비스를 선언하세요. 미디어 컨트롤과 같은 시스템 UI 구성요소에서 사용할 저작자 표시 아이콘의 런처 아이콘을 비롯한 필수 앱 아이콘을 지정합니다.
매니페스트 파일에 대해 자세히 알아보려면 앱 매니페스트 개요를 참고하세요.
미디어 브라우저 서비스 선언
Android Auto와 AAOS는 미디어 브라우저 서비스를 통해 앱에 연결되어 미디어 항목을 탐색합니다. 매니페스트에서 미디어 브라우저 서비스를 선언하면 Android Auto 및 AAOS에서 서비스를 검색하여 앱에 연결할 수 있습니다.
이 코드 스니펫은 매니페스트에서 미디어 브라우저 서비스를 선언하는 방법을 보여줍니다. AAOS 모듈의 매니페스트 파일과 전화 앱의 매니페스트 파일에 이 코드를 포함하세요.
<application>
...
<service android:name=".MyMediaBrowserService"
android:exported="true">
<intent-filter>
<action android:name="android.media.browse.MediaBrowserService"/>
</intent-filter>
</service>
...
</application>
앱 아이콘 지정
시스템 UI에서 앱을 나타내려면 Android Auto 및 AAOS에서 사용할 앱 아이콘을 지정하세요. 다음 두 아이콘이 필요합니다.
런처 아이콘 정의
런처 아이콘은 런처 및 아이콘 트레이와 같은 시스템 UI에서 앱을 나타냅니다. 다음과 같은 매니페스트 선언을 통해 모바일 앱의 아이콘을 사용하여 자동차 미디어 앱을 나타내려 한다고 지정할 수 있습니다.
<application
...
android:icon="@mipmap/ic_launcher"
...
/>
모바일 앱의 아이콘과는 다른 아이콘을 사용하려면 매니페스트에서 미디어 브라우저 서비스의 <service>
요소에 android:icon
속성을 설정하세요.
<application>
...
<service
...
android:icon="@mipmap/auto_launcher"
...
/>
</application>
저작자 표시 아이콘 정의
저작자 표시 아이콘은 미디어 카드와 같이 미디어 콘텐츠가 우선하는 위치에 사용됩니다. 알림에 사용되는 작은 아이콘을 재사용해 보세요.
이 아이콘은 단색이어야 합니다.

그림 1. 미디어 카드의 저작자 표시 아이콘
다음 매니페스트 선언을 통해 앱을 나타내는 데 사용할 아이콘을 지정할 수 있습니다.
<application>
...
<meta-data
android:name="androidx.car.app.TintableAttributionIcon"
android:resource="@drawable/ic_status_icon" />
...
</application>
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-22(UTC)
[null,null,["최종 업데이트: 2025-08-22(UTC)"],[],[],null,["# Configure manifest files\n\nConfigure your app's manifest files to integrate with Android Auto and Android\nAutomotive OS (AAOS). To enable discovery and connection by these platforms,\ndeclare your media browser service in the manifest. Specify the required app\nicons, including a launcher icon for an attribution\nicon for use by system UI components such as media controls.\n\nTo learn more about manifest files, see [App manifest overview](/guide/topics/manifest/manifest-intro).\n\nDeclare your media browser service\n----------------------------------\n\nAndroid Auto and AAOS connect to your app through your media browser service to\nbrowse media items. Declare your media browser service in your manifest to let\nAndroid Auto and AAOS discover the service and connect to your app.\n\nThis code snippet shows how to declare your media browser service in your\nmanifest. The next section of this guide, [Create a media browser service](/training/cars/media/create-media-browser),\ndetails the process of implementing the service. \n\n \u003capplication\u003e\n ...\n \u003cservice android:name=\".MyMediaBrowserService\"\n android:exported=\"true\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.media.browse.MediaBrowserService\"/\u003e\n \u003c/intent-filter\u003e\n \u003c/service\u003e\n ...\n \u003c/application\u003e\n\n| **Caution:** You might see a lint warning because the service is exported, but doesn't set the [`android:permission`](/guide/topics/manifest/service-element#prmsn) attribute. It's generally safe to ignore this warning because you can [Add package validation](/training/cars/media/create-media-browser/content-hierarchy#package-validation), which provides more control over which host apps can connect to your app.\n\nSpecify app icons\n-----------------\n\nTo represent your app in the system UI, specify the app icons that Android Auto\nand AAOS should use. These two icons are required:\n\n- [Define the launcher icon](#launcher-icon)\n- [Define the attribution icon](#attribution-icon)\n\n| **Design guidelines:** [Branding elements](/design/ui/cars/guides/app-cuj/branding-elements).\n\n### Define the launcher icon\n\nThe launcher icon represents your app in the system UI, such as on the launcher\nand in the tray of icons.\n\nBy default, the [`android:icon`](/guide/topics/manifest/application-element#icon) attribute of your app's\n[`\u003capplication\u003e`](/guide/topics/manifest/application-element) element is used as the launcher icon: \n\n \u003capplication\n ...\n android:icon=\"@mipmap/ic_launcher\"\n \u003e\n\nTo use a different icon, set the `android:icon` attribute of your media browser\nservice's [`\u003cservice\u003e`](/guide/topics/manifest/service-element) element: \n\n \u003capplication\u003e\n ...\n \u003cservice\n ...\n android:icon=\"@mipmap/ic_car_launcher\"/\u003e\n \u003c/application\u003e\n\n### Define the attribution icon\n\nThe attribution icon is used in places where media content takes precedence,\nsuch as on media cards. Consider reusing the small icon used for notifications.\nThis icon must be monochrome.\n\n**Figure 1.** Attribution icon on media card.\n\nYou can specify an icon that is used to represent your app using this manifest\ndeclaration: \n\n \u003capplication\u003e\n ...\n \u003cmeta-data\n android:name=\"androidx.car.app.TintableAttributionIcon\"\n android:resource=\"@drawable/ic_status_icon\" /\u003e\n ...\n \u003c/application\u003e\n\nSpecify your app's label\n------------------------\n\nBy default, the value of the [`android:label`](/guide/topics/manifest/application-element#label) attribute of your app's\n`\u003capplication\u003e` element is used as the display name for your app on the car\nscreen.\n\nTo use a different display name -- or if your app has multiple media browser\nservices -- set the `android:label` attribute of the media browser service's\n`\u003cservice\u003e` element.\n\nSpecify your app's accent color\n-------------------------------\n\nYour app's accent color is used by Android Auto and AAOS to style playback\ncontrols and other UI elements.\n\nBy default, the accent color is pulled from the [`colorAccent`](/reference/android/R.attr#colorAccent) item of the\n[`android:theme`](/guide/topics/manifest/application-element#theme) style resource of your app's `\u003capplication\u003e` element.\n\nTo use a different accent color for your in-car experience, include a\n[`\u003cmeta-data\u003e`](/guide/topics/manifest/meta-data-element) element for a different style resource containing a\n`colorAccent` item: \n\n \u003capplication\u003e\n ...\n \u003cmeta-data\n android:name=\"com.google.android.gms.car.application.theme\"\n android:resource=\"@style/\u003cvar translate=\"no\"\u003eTHEME_NAME\u003c/var\u003e\"/\u003e\n ...\n \u003c/application\u003e\n\nPlatform-specific configuration\n-------------------------------\n\nIn addition to the configuration detailed on this page, see the following\nsections for platform-specific requirements:\n\n- [Add support for Android Auto to your media app](/training/cars/media/auto#manifest-car-app)\n- [Add support for Android Automotive OS to your media app](/training/cars/media/automotive-os#automotive-module)"]]