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 SPBU. 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 bentuk pendek. 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>