Menyiapkan project

Halaman ini menjelaskan cara menginstal library Aplikasi Mobil dan cara mengonfigurasi file manifes untuk aplikasi Anda.

Menginstal library Aplikasi Mobil

Untuk menambahkan library ke aplikasi Anda, lihat halaman rilis library Jetpack.

Mengonfigurasi file manifes aplikasi Anda

Sebelum dapat membuat aplikasi mobil, Anda harus mengonfigurasi file manifes aplikasi Anda.

Mendeklarasikan CarAppService Anda

Host terhubung ke aplikasi Anda melalui penerapan CarAppService. Anda mendeklarasikan layanan ini dalam manifes agar host dapat menemukan dan terhubung ke aplikasi Anda.

Anda juga harus mendeklarasikan kategori aplikasi Anda dalam elemen <category> dari filter intent aplikasi Anda. Lihat daftar kategori aplikasi yang didukung untuk nilai yang diizinkan untuk elemen ini.

Cuplikan kode berikut menunjukkan cara mendeklarasikan layanan aplikasi mobil untuk aplikasi tempat menarik di manifes Anda:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService"/>
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>

    ...
<application>

Kategori aplikasi yang didukung

Saat mendeklarasikan CarAppService seperti yang dijelaskan dalam Mendeklarasikan CarAppService, Anda juga harus mendeklarasikan kategori aplikasi dengan menambahkan satu atau beberapa nilai ini dalam filter intent.

• androidx.car.app.category.NAVIGATION: Memberikan petunjuk navigasi belokan demi belokan. Lihat Membangun aplikasi navigasi untuk mobil.

• androidx.car.app.category.POI: Menyediakan fungsi yang relevan untuk menemukan tempat menarik seperti tempat parkir, stasiun pengisian daya, dan pompa bensin. Lihat Membangun aplikasi lokasi menarik untuk mobil.

• androidx.car.app.category.IOT: Memungkinkan pengguna mengambil tindakan yang relevan di perangkat terhubung dari dalam mobil. Lihat Membangun aplikasi Internet of Things untuk mobil.

• androidx.car.app.category.WEATHER: Memungkinkan pengguna melihat informasi cuaca yang relevan terkait lokasi mereka saat ini atau di sepanjang rute mereka. Lihat Membangun aplikasi cuaca untuk mobil.

• androidx.car.app.category.MEDIA: Memungkinkan pengguna menjelajahi dan memutar musik, radio, buku audio, dan konten audio lainnya di dalam mobil. Lihat Membangun aplikasi media ber-template untuk mobil.

• androidx.car.app.category.MESSAGING: Memungkinkan pengguna berkomunikasi dengan pesan teks singkat. Lihat Membangun pengalaman pesan berbasis template untuk Android Auto.

• androidx.car.app.category.CALLING: Memungkinkan pengguna berkomunikasi dengan panggilan suara. Lihat Membangun pengalaman panggilan untuk Android Auto.

Untuk mengetahui deskripsi mendetail setiap kategori dan kriteria yang diperlukan agar memenuhi syarat untuk suatu kategori, lihat Kualitas aplikasi Android untuk mobil.

Menentukan nama dan ikon aplikasi

Untuk merepresentasikan aplikasi Anda di UI sistem, carPermissionActivityLayout harus menentukan nama aplikasi dan ikon untuk host. Gunakan atribut label dan icon dari CarAppService untuk menentukan nama dan ikon aplikasi yang digunakan oleh host untuk mewakili aplikasi Anda:

...
<service
   android:name=".MyCarAppService"
   android:exported="true"
   android:label="@string/my_app_name"
   android:icon="@drawable/my_app_icon">
   ...
</service>
...

Jika Anda tidak mendeklarasikan label atau ikon dalam elemen <service>, host akan kembali ke nilai yang ditentukan oleh elemen <application>.

Menetapkan tema kustom

Untuk menyetel tema kustom untuk aplikasi mobil Anda:

1. Tambahkan elemen <meta-data> di file manifes Anda:

   <meta-data
       android:name="androidx.car.app.theme"
       android:resource="@style/MyCarAppTheme />
   

2. Deklarasikan resource gaya untuk menetapkan atribut tema aplikasi mobil kustom Anda:

   <resources>
     <style name="MyCarAppTheme">
       <item name="carColorPrimary">@color/my_primary_car_color</item>
       <item name="carColorPrimaryDark">@color/my_primary_dark_car_color</item>
       <item name="carColorSecondary">@color/my_secondary_car_color</item>
       <item name="carColorSecondaryDark">@color/my_secondary_dark_car_color</item>
       <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
     </style>
   </resources>
   

API Level Aplikasi Mobil

Library Aplikasi Mobil menentukan API level-nya sendiri sehingga Anda dapat mengetahui fitur library yang didukung oleh host template pada kendaraan. Untuk mengambil level API Aplikasi Mobil tertinggi yang didukung oleh host, gunakan metode getCarAppApiLevel.

Deklarasikan level Car App API minimum yang didukung oleh aplikasi Anda di file AndroidManifest.xml:

<manifest ...>
    <application ...>
        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="1"/>
    </application>
</manifest>

Untuk mengetahui detail tentang cara mempertahankan kompatibilitas mundur dan mendeklarasikan API level minimum yang diperlukan untuk menggunakan fitur, lihat dokumentasi untuk anotasi RequiresCarApi. Untuk mengetahui definisi level API mana yang diperlukan untuk menggunakan fitur tertentu dari Library Aplikasi Mobil, lihat dokumentasi referensi untuk CarAppApiLevels.