Selain mendukung aplikasi yang dibangun untuk digunakan saat mengemudi, Android Automotive OS mendukung aplikasi browser, game, dan video untuk digunakan saat parkir. Anda dapat mengirimkan aplikasi yang sama ke mobil, seperti yang Anda lakukan ke perangkat layar besar lainnya, hanya dengan beberapa perubahan kecil.
Menguji aplikasi yang ada di emulator Android Automotive OS
Untuk mulai membangun aplikasi untuk Android Automotive OS, uji terlebih dahulu aplikasi seluler yang ada di emulator Android Automotive OS. Untuk menyiapkan emulator, ikuti langkah-langkah di Pengujian menggunakan emulator Android Automotive OS. Selanjutnya, Anda dapat menjalankan aplikasi dengan mengikuti petunjuk di Menjalankan aplikasi di emulator.
Saat menjalankan aplikasi, perhatikan masalah kompatibilitas, seperti berikut:
- Layar infotainment memiliki orientasi tetap. Untuk memenuhi pedoman kualitas aplikasi mobil, aplikasi harus mendukung orientasi potret dan lanskap.
- API yang tersedia pada perangkat lain mungkin tidak tersedia di Android Automotive OS. Misalnya, beberapa API layanan Google Play tidak tersedia di Android Automotive OS. Lihat bagian Menonaktifkan fitur untuk mengetahui detail tentang cara menangani masalah ini.
Mengonfigurasi file manifes aplikasi Anda
Untuk menargetkan perangkat Android Automotive OS, aplikasi Anda harus memiliki entri manifes tertentu. Setelah Anda memilih untuk mendistribusikan ke perangkat Android Automotive OS, aplikasi yang kompatibel akan menjalani proses peninjauan manual untuk membantu memastikan aplikasi tersebut aman digunakan di dalam mobil. Lihat Mendistribusikan ke mobil untuk mengetahui detail selengkapnya.
Fitur Android Automotive OS yang diperlukan
Agar muncul sebagai listingan di Play Store di mobil, aplikasi yang di-build untuk Android Automotive OS
harus menyertakan elemen <uses-feature>
di file
AndroidManifest.xml untuk fitur android.hardware.type.automotive:
<manifest ...> ... <!-- Depending on the track you choose to distribute your app, the android:required attribute can also be "false" or left unset. See Choose a track for Android Automotive OS. --> <uses-feature android:name="android.hardware.type.automotive" android:required="[true|false]" /> ... </manifest>
Selain elemen yang ditampilkan dalam contoh kode sebelumnya, aplikasi yang dibangun untuk
Android Automotive OS harus menyertakan elemen <uses-feature> berikut di
elemen <manifest> root:
<uses-feature
android:name="android.hardware.wifi"
android:required="false"/>
<uses-feature
android:name="android.hardware.screen.portrait"
android:required="false"/>
<uses-feature
android:name="android.hardware.screen.landscape"
android:required="false"/>
Menyetel fitur ini secara eksplisit ke tidak wajib akan membantu memastikan aplikasi Anda tidak bentrok dengan fitur hardware yang tersedia di perangkat Android Automotive OS.
Memastikan tidak ada aktivitas distraksi dioptimalkan
Untuk memastikan aplikasi Anda hanya tersedia untuk digunakan saat parkir, jangan
sertakan elemen <meta-data> berikut dalam
elemen <activity> dalam
manifes Anda:
<!-- NOT ALLOWED -->
<meta-data
android:name="distractionOptimized"
android:value="true"/>
Tanpa metadata ini, aktivitas aplikasi Anda akan diblokir secara otomatis
oleh OS saat mobil memasuki mode mengemudi untuk mengurangi gangguan bagi
pengemudi. Hal ini terjadi sebagai callback siklus proses
onPause
dan selama itu Anda harus menjeda pemutaran video dan audio
dari aplikasi Anda.
Entri manifes khusus kategori
Selain persyaratan sebelumnya, yang berlaku untuk semua aplikasi yang diparkir, kategori video dan game memiliki persyaratan tambahan:
- Untuk aplikasi video, lihat Menandai aplikasi sebagai aplikasi video.
- Untuk game, lihat Menandai aplikasi Anda sebagai game.
Mengoptimalkan aplikasi untuk Android Automotive OS
Untuk memberi pengguna pengalaman terbaik, perhatikan hal-hal berikut saat membangun aplikasi untuk Android Automotive OS.
Mengoptimalkan aplikasi untuk layar besar
Layar yang ada di kendaraan Android Automotive OS memiliki ukuran, resolusi, dan rasio aspek yang mirip dengan tablet dan perangkat foldable dibandingkan dengan ponsel. Dengan demikian, mengoptimalkan aplikasi untuk perangkat layar besar juga akan menguntungkan pengguna di mobil.
Secara khusus, lihat Mendukung berbagai ukuran layar untuk mengetahui detail tentang cara mengoptimalkan ukuran layar besar, serta galeri media dan game untuk mendapatkan inspirasi dan panduan desain.
Pengoptimalan layar besar lainnya seperti kompatibilitas input tidak bermanfaat secara langsung untuk Android Automotive OS, tetapi tetap dapat meningkatkan pengalaman pengguna. Misalnya, navigasi keyboard menggunakan API yang sama seperti navigasi putar, sehingga setiap pengoptimalan yang dibuat di sana dapat menguntungkan kedua faktor bentuk.
Menggunakan inset jendela dan potongan layar
Seperti faktor bentuk lainnya, Android Automotive OS menyertakan elemen UI sistem, seperti status dan menu navigasi, serta dukungan untuk layar non-persegi panjang.
Secara default, aplikasi menggambar di area yang tidak tumpang-tindih dengan panel sistem atau potongan layar. Namun, Anda mungkin ingin aplikasi menyembunyikan panel sistem, menggambar konten di belakangnya, atau menampilkan konten dalam potongan tampilan seperti yang dijelaskan di Menata letak aplikasi dalam inset jendela. Jika aplikasi Anda melakukan salah satu hal tersebut, lihat subbagian berikut untuk mengetahui detail tentang cara membuat aplikasi Anda berfungsi dengan baik di seluruh ekosistem perangkat Android Automotive OS.
Kolom sistem, mode imersif, dan rendering layar penuh
Panel sistem di mobil dapat berukuran dan diposisikan secara berbeda dengan faktor bentuk lainnya. Misalnya, menu navigasi dapat diposisikan di sebelah kiri, kanan, atau bawah layar. Meskipun ada status bar di bagian atas dan menu navigasi di bagian bawah (seperti pada sebagian besar ponsel dan tablet), ukuran elemen ini kemungkinan akan jauh lebih besar di mobil.
Selain itu, Android Automotive OS memungkinkan OEM mengontrol apakah
aplikasi dapat menampilkan atau menyembunyikan panel sistem untuk masuk dan keluar dari mode
imersif. Misalnya, dengan mencegah aplikasi
menyembunyikan kolom sistem, OEM dapat memastikan bahwa kontrol kendaraan, seperti kontrol
kondisi udara, selalu dapat diakses di layar. Jika OEM telah mencegah aplikasi
mengontrol panel sistem, tidak ada yang terjadi saat aplikasi memanggil
API WindowInsetsController (atau WindowInsetsControllerCompat)
untuk menampilkan atau menyembunyikan panel sistem. Lihat dokumentasi show dan
hide untuk mempelajari lebih lanjut cara mendeteksi apakah aplikasi Anda dapat mengubah
inset.
Demikian pula, OEM juga dapat mengontrol apakah aplikasi dapat menetapkan warna dan transparansi panel sistem atau tidak untuk memastikan bahwa panel dan elemen yang ada di dalamnya terlihat jelas setiap saat. Jika aplikasi Anda menggambar dari tepi ke tepi, pastikan hanya konten non-penting yang digambar di belakang kolom sistem. Konten ini mungkin tidak terlihat jika OEM perangkat mencegah setelan warna atau transparansi panel.
<!-- Depending on OEM configuration, these style declarations
(and the corresponding runtime calls) may be ignored -->
<style name="...">
<item name="android:statusBarColor">...</item>
<item name="android:navigationBarColor">...</item>
<item name="android:windowTranslucentStatus">...</item>
<item name="android:windowTranslucentNavigation">...</status>
</style>
Jika aplikasi Anda menggunakan layar penuh, jangan membuat asumsi tentang ukuran, jumlah, jenis, atau lokasi panel sistem. Sebagai gantinya, gunakan API inset jendela untuk menata konten aplikasi Anda relatif terhadap panel sistem. Lihat Menampilkan konten layar penuh di aplikasi Anda untuk mengetahui detail selengkapnya tentang cara menggunakan API ini. Nilai padding hard code yang, meskipun tidak pernah direkomendasikan, dapat menyimpan konten di area aman di perangkat lain kemungkinan tidak akan ada di mobil.
Menyesuaikan dengan layar berbentuk tidak beraturan
Selain layar persegi panjang, beberapa kendaraan mungkin memiliki layar berbentuk tidak beraturan, seperti yang ditunjukkan pada Gambar 1:
Jika aplikasi tidak dirender dari tepi ke tepi, Anda tidak perlu melakukan apa pun agar dirender dalam area aman.
Jika aplikasi merender dari tepi ke tepi, Anda dapat memilih perilaku aplikasi
terkait potongan tampilan. Anda dapat melakukannya menggunakan resource
dengan menetapkan
atribut
android:windowLayoutInDisplayCutoutMode
untuk tema aplikasi atau saat runtime
dengan mengubah atribut
layoutInDisplayCutoutMode
jendela.
Karena jenis cutout layar yang ada di perangkat Android Automotive OS
berbeda dengan yang ada di perangkat seluler, jangan gunakan
LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT
atau LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES,
yang memiliki perilaku yang dioptimalkan untuk cutout yang ditemukan di perangkat seluler. Sebagai gantinya,
gunakan LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER
atau LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
untuk selalu menghindari atau selalu memasuki potongan. Saat memilih yang terakhir,
lihat Mendukung potongan layar untuk mengetahui detail
selengkapnya tentang API yang terkait dengan potongan layar.
Jika aplikasi Anda dirender ke area potongan layar dan Anda ingin memiliki perilaku yang berbeda antara Android Automotive OS dan perangkat seluler, lihat Menonaktifkan fitur untuk mendapatkan panduan jika aplikasi Anda menetapkan perilaku ini saat runtime dan Menggunakan resource alternatif jika aplikasi Anda menetapkan perilaku ini menggunakan file resource.
Menonaktifkan fitur
Jika Anda menyediakan aplikasi seluler di Android Automotive OS, fitur dan fungsi tertentu mungkin tidak relevan atau tidak tersedia. Misalnya, mobil biasanya tidak menyediakan akses ke kamera. Selain itu, hanya sebagian layanan Google Play yang tersedia di Android Automotive OS; lihat Layanan Google Play untuk mobil untuk detail selengkapnya.
Anda dapat menggunakan PackageManager.hasSystemFeature
API untuk mendeteksi apakah aplikasi berjalan di Android Automotive OS dengan memeriksa
fitur FEATURE_AUTOMOTIVE,
seperti ditunjukkan pada contoh berikut:
Kotlin
val packageManager: PackageManager = ... // Get a PackageManager from a Context val isCar = packageManager.hasSystemFeature(PackageManager.FEATURE_AUTOMOTIVE) if (isCar) { // Enable or disable a given feature }
Java
PackageManager packageManager = ... // Get a PackageManager from a Context boolean isCar = packageManager.hasSystemFeature(PackageManager.FEATURE_AUTOMOTIVE) if (isCar) { // Enable or disable a given feature }
Atau, jika aplikasi Anda juga memiliki komponen Android Auto, Anda dapat menggunakan CarConnection API dari Library Aplikasi Android untuk Mobil untuk mendeteksi apakah aplikasi berjalan di Android Automotive OS atau Android Auto—atau apakah aplikasi tidak terhubung ke mobil sama sekali.
Untuk Picture-in-Picture (PiP), ikuti praktik terbaik yang telah ditetapkan untuk memeriksa apakah fitur ini tersedia dan bereaksi dengan tepat.
Menangani skenario offline
Meskipun mobil menjadi lebih banyak terhubung ke internet, aplikasi direkomendasikan untuk menangani operasi tanpa koneksi internet, seperti dalam kasus berikut:
- Pengguna dapat memilih untuk tidak menggunakan data seluler yang ditawarkan sebagai bagian dari paket langganan dari produsen mobil.
- Akses ke data seluler mungkin dibatasi di area tertentu.
- Mobil dengan radio Wi-Fi mungkin berada di luar jangkauan Wi-Fi, atau OEM mungkin menonaktifkan Wi-Fi dan mengutamakan jaringan seluler.
Bersiaplah untuk menangani skenario ini di aplikasi Anda dengan melakukan degradasi halus pada fungsi yang bergantung pada akses internet, misalnya dengan menawarkan konten offline. Untuk mengetahui informasi selengkapnya, lihat praktik terbaik untuk mengoptimalkan jaringan.
Menggunakan resource alternatif
Guna membantu menyesuaikan aplikasi untuk mobil, Anda dapat menggunakan penentu resource car untuk menyediakan
resource alternatif
saat berjalan di kendaraan Android Automotive OS Google. Misalnya, jika menggunakan
Resource dimensi untuk menyimpan
nilai padding, Anda dapat menggunakan nilai yang lebih besar bagi set resource car untuk membuat
target sentuh lebih besar.
Mendistribusikan aplikasi
Setelah menguji aplikasi berdasarkan pedoman kualitas aplikasi mobil untuk kategorinya, Anda dapat menggunakan Google Play untuk mendistribusikan ke Mobil dengan Google bawaan. Lihat Mendistribusikan ke mobil untuk mengetahui detail selengkapnya tentang proses publikasi.
Memberikan masukan tentang aplikasi parkir
Jika Anda mengalami masalah atau memiliki permintaan fitur saat mengembangkan aplikasi parkir untuk Android Automotive OS, Anda dapat melaporkannya menggunakan Issue Tracker Google. Pastikan untuk mengisi semua informasi yang diminta pada template masalah. Sebelum mengajukan masalah baru, periksa apakah masalah tersebut sudah dilaporkan dalam daftar masalah. Anda dapat berlangganan dan memberi suara untuk masalah dengan mengklik bintang untuk masalah di tracker. Untuk mengetahui informasi selengkapnya, lihat Berlangganan pada topik Masalah.