Mengonfigurasi file manifes

Mengonfigurasi file manifes aplikasi Anda untuk berintegrasi dengan Android Auto dan Android Automotive OS (AAOS). Untuk mengaktifkan penemuan dan koneksi oleh platform ini, deklarasikan layanan browser media Anda dalam manifes. Tentukan ikon aplikasi yang diperlukan, termasuk ikon peluncur untuk ikon atribusi yang akan digunakan oleh komponen UI sistem seperti kontrol media.

Untuk mempelajari lebih lanjut file manifes, lihat Ringkasan manifes aplikasi.

Mendeklarasikan layanan browser media Anda

Android Auto dan AAOS terhubung ke aplikasi Anda melalui layanan browser media untuk menjelajahi item media. Deklarasikan layanan browser media Anda dalam manifes untuk memungkinkan Android Auto dan AAOS menemukan layanan tersebut dan terhubung ke aplikasi Anda.

Cuplikan kode ini menunjukkan cara mendeklarasikan layanan browser media di manifes Anda. Bagian berikutnya dari panduan ini, Membuat layanan browser media, menjelaskan proses penerapan layanan.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

Menentukan ikon aplikasi

Untuk merepresentasikan aplikasi Anda di UI sistem, tentukan ikon aplikasi yang harus digunakan Android Auto dan AAOS. Dua ikon ini diperlukan:

Menentukan ikon peluncur

Ikon peluncur merepresentasikan aplikasi Anda di UI sistem, seperti pada peluncur dan baki ikon.

Secara default, atribut android:icon elemen <application> aplikasi Anda digunakan sebagai ikon peluncur:

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

Untuk menggunakan ikon yang berbeda, tetapkan atribut android:icon elemen <service> layanan browser media:

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

Menentukan ikon atribusi

Ikon atribusi digunakan di tempat konten media diprioritaskan, seperti pada kartu media. Pertimbangkan untuk menggunakan kembali ikon kecil yang digunakan untuk notifikasi. Ikon ini harus monokrom.

Ikon atribusi di kartu media

Gambar 1. Ikon atribusi di kartu media.

Anda dapat menentukan ikon yang digunakan untuk merepresentasikan aplikasi Anda menggunakan deklarasi manifes ini:

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

Menentukan label aplikasi Anda

Secara default, nilai atribut android:label elemen <application> aplikasi Anda digunakan sebagai nama tampilan untuk aplikasi Anda di layar mobil.

Untuk menggunakan nama tampilan yang berbeda – atau jika aplikasi Anda memiliki beberapa layanan browser media – tetapkan atribut android:label elemen <service> layanan browser media.

Menentukan warna aksen aplikasi

Warna aksen aplikasi Anda digunakan oleh Android Auto dan AAOS untuk menata gaya kontrol pemutaran dan elemen UI lainnya.

Secara default, warna aksen diambil dari item colorAccent dari resource gaya android:theme elemen <application> aplikasi Anda.

Untuk menggunakan warna aksen yang berbeda untuk pengalaman dalam mobil, sertakan elemen <meta-data> untuk resource gaya yang berbeda yang berisi item colorAccent:

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

Konfigurasi khusus platform

Selain konfigurasi yang dijelaskan di halaman ini, lihat bagian berikut untuk mengetahui persyaratan khusus platform: