매니페스트 파일 구성

Android Auto 및 Android Automotive OS (AAOS)와 통합되도록 앱의 매니페스트 파일을 구성합니다. 이러한 플랫폼에서 검색 및 연결을 사용 설정하려면 매니페스트에서 미디어 브라우저 서비스를 선언하세요. 미디어 컨트롤과 같은 시스템 UI 구성요소에서 사용할 저작자 표시 아이콘의 런처 아이콘을 비롯한 필수 앱 아이콘을 지정합니다.

매니페스트 파일에 대해 자세히 알아보려면 앱 매니페스트 개요를 참고하세요.

미디어 브라우저 서비스 선언

Android Auto와 AAOS는 미디어 브라우저 서비스를 통해 앱에 연결되어 미디어 항목을 탐색합니다. 매니페스트에서 미디어 브라우저 서비스를 선언하면 Android Auto 및 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 속성이 런처 아이콘으로 사용됩니다.

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

다른 아이콘을 사용하려면 미디어 브라우저 서비스의 <service> 요소의 android:icon 속성을 설정하세요.

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

저작자 표시 아이콘 정의

저작자 표시 아이콘은 미디어 카드와 같이 미디어 콘텐츠가 우선하는 위치에 사용됩니다. 알림에 사용되는 작은 아이콘을 재사용해 보세요. 이 아이콘은 단색이어야 합니다.

미디어 카드의 저작자 표시 아이콘

그림 1. 미디어 카드의 저작자 표시 아이콘

다음 매니페스트 선언을 통해 앱을 나타내는 데 사용할 아이콘을 지정할 수 있습니다.

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

앱의 라벨 지정

기본적으로 앱의 <application> 요소의 android:label 속성 값이 자동차 화면에 앱의 표시 이름으로 사용됩니다.

다른 표시 이름을 사용하거나 앱에 미디어 브라우저 서비스가 여러 개 있는 경우 미디어 브라우저 서비스의 <service> 요소에 android:label 속성을 설정합니다.

앱의 강조 색상 지정

앱의 강조 색상은 Android Auto 및 AAOS에서 재생 컨트롤과 기타 UI 요소를 스타일링하는 데 사용됩니다.

기본적으로 강조 색상은 앱의 <application> 요소의 android:theme 스타일 리소스의 colorAccent 항목에서 가져옵니다.

차량 내 환경에 다른 강조 색상을 사용하려면 colorAccent 항목이 포함된 다른 스타일 리소스의 <meta-data> 요소를 포함하세요.

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

플랫폼별 구성

이 페이지에 자세히 설명된 구성 외에도 플랫폼별 요구사항은 다음 섹션을 참고하세요.