Car App
Update Terbaru | Rilis Stabil | Kandidat Rilis | Rilis Beta | Rilis Alfa |
---|---|---|---|---|
26 Juni 2024 | 1.4.0 | - | 1.7.0-beta01 | - |
Mendeklarasikan dependensi
Untuk menambahkan dependensi pada Library Car App, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk informasi selengkapnya.
Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle
bagi aplikasi atau modul Anda:
Groovy
dependencies { implementation "androidx.car.app:app:1.4.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.4.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.4.0" // For testing testImplementation "androidx.car.app:app-testing:1.4.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.4.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.4.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.4.0") // For testing testImplementation("androidx.car.app:app-testing:1.4.0") }
Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.
Masukan
Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.
Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.
Versi 1.7
Versi 1.7.0-beta01
26 Juni 2024
androidx.car.app:app-*:1.7.0-beta01
dirilis. Versi 1.7.0-beta01 berisi commit ini. Fiturnya sama dengan yang dipublikasikan di alpha01, yang diulang di bawah:
Fitur Baru
- Peta dengan Konten: Template baru Kanvas Peta plus template konten, yang untuk saat ini dapat berupa Daftar / Petak / Panel / Pesan.
RoutePreview
,PlaceListNavigation
,MapTemplate
kini tidak digunakan lagi. Template akan terus berfungsi sebagaimana mestinya.- Aplikasi contoh telah diupdate untuk menampilkan penggunaan
MapWithContent
, bukan template yang tidak digunakan lagi
- Item Percakapan: API baru untuk menampilkan percakapan (IM, SMS), dan pembacaan Asisten di mobil.
- Dimensi Kendaraan: API baru untuk mengambil data ukuran kendaraan (data di AAOS saat ini).
Perubahan API
- Tambahkan tag
@ExperimentalCarApi
keMediaPlaybackTemplate.Builder
. (Ic1957) - Menambahkan
SectionedItemTemplate
baru dalam tahap eksperimental. (I5958a) - Memperkenalkan
CarAppApiLevel 8
(I3fa22) - Menambahkan
MediaPlaybackTemplate
untuk menampilkan konten selama pemutaran media di Library Aplikasi Mobil. (I3c10d) - Menambahkan API baru untuk aplikasi guna mendeteksi apakah sistem mendukung audio latar belakang saat mengemudi (I0f868)
Perbaikan Bug
- Memperbaiki instance kebocoran memori dan error tertentu di kode klien CAL dan di Aplikasi Contoh Navigasi CAL. (I55e04)
- Ganti
requireNotNull instances
dalam metodeonDestroy
BaseCarAppActivity
dengan pemeriksaan if-null untuk menghindari error. (Iec676)
Versi 1.7.0-alpha02
17 April 2024
androidx.car.app:app-*:1.7.0-alpha02
dirilis. Versi 1.7.0-alpha02 berisi commit ini.
Fitur Baru
- Menambahkan tanda yang tidak digunakan lagi untuk template berbasis peta yang akan didukung template
MapWithContent
di masa mendatang.
Perubahan API
- Menghentikan penggunaan
MapTemplate
,RoutePreviewNavigationTemplate
,PlaceListNavigationTemplate
lama dan mendorong penggunaanMapWithContentTemplate
yang baru (Ib0a08)
Versi 1.7.0-alpha01
3 April 2024
androidx.car.app:app-*:1.7.0-alpha01
dirilis. Kami telah memindahkan skema pembuatan versi library agar cocok dengan versi CarApi yang aktif. Hal ini untuk mengurangi kebingungan pada skema penamaan berdasarkan masukan developer. Oleh karena itu, versi 1.5 / 1.6 tidak akan langsung dipindahkan ke 1.7 Versi 1.7.0-alpha01 yang berisi commit ini.
Fitur Baru
- Peta dengan Konten: Template baru bernama
MapWithContent
yang mendukung Daftar / Petak / Panel / Pesan sebagai Konten di dalam peta.RoutePreview
,PlaceListNavigation
, Template peta kini tidak digunakan lagi.- Aplikasi contoh telah diupdate untuk menampilkan fungsi template yang tidak digunakan lagi menggunakan
MapWithContent
.
- Item Percakapan: API baru untuk menampilkan percakapan (IM, SMS), dan pembacaan Asisten di mobil.
- Dimensi Kendaraan: API baru untuk mengambil data ukuran kendaraan (data di AAOS saat ini).
Perubahan API
- Menandai jenis gambar baris kecil tambahan sebagai eksperimental (I5184b)
- Menambahkan
CarInfo#fetchExteriorDimensions
API yang memungkinkan akses ke informasi dimensi eksterior kendaraan seperti tinggi, lebar, dll. (Ia40c5) - Menghapus tag
ExperimentalAPI
dariMapWithContentTemplate
(I66db8) - Perbarui parameter
GridItem#setTitle
agar nullable. (I3d610) GetHeader
API tidak memerlukan API 7 karena kompatibel dengan versi sebelumnya (I8c812)- Menambahkan dukungan untuk
Header
diListTemplate
, menghentikan penggunaanheaderAction
,headerTitle
,actionStrip
(I7ae01) - Menghentikan penggunaan
title
,headerAction
,actionStrip
diGridTemplate
dan menambahkan dukungan untukHeader
(I41a9c) - Menghapus persyaratan level 7 untuk API eksperimental: Badge, ukuran item
GridTemplate
dan pengambil/penyetel bentuk gambar, metodeGridItem
untuk mendapatkan/menyetel Badge. (Id71eb) - Menghentikan penggunaan
title
,headerAction
,actionStrip
diPaneTemplate
, menambahkan dukunganHeader
baru (I23154) - Mengubah telemetri Pusat Media dari
BroadcastReceiver
menjadi Jelajahi Tindakan Kustom. (I4185f) - Menambahkan dukungan atribut
Header
diMessageTemplate
. Dukungan untukActionStrip
,headerAction
, dantitle
tidak digunakan lagi. (Ie2de8) - Mengubah visibilitas konstanta pemberitahuan (Icf8a8)
- Menghapus atribut
isLoading
dari template induk (I651e6) - Menambahkan tambahan untuk memberi tahu aplikasi media tentang parameter UI utama (I85ca2)
- Menambahkan fitur analisis pusat media ke
MediaExtensions
(I7ce28) - Menambahkan opsi untuk gambar berukuran kecil ekstra pada baris. (I72c03)
Perbaikan Bug
- Update javadoc di
ConversationItem
untuk menyatakan bahwa pesan harus diurutkan dari yang terlama hingga terbaru. (I77a2a) - Memperbarui logika pemotongan
ListTemplate
untuk menghapus pesan terlama dariConversationItem
(Ie0a61)
Versi 1.4
Versi 1.4.0
29 Mei 2024
androidx.car.app:app-*:1.4.0
dirilis. Versi 1.4.0 adalah promosi 1.4.0-rc02.
Perubahan penting sejak versi 1.3.0
- Rendering peta Cluster Instrumen untuk aplikasi Navigasi
- Template Tab Baru untuk meningkatkan tata letak / kegunaan aplikasi
- Dukungan untuk Batas tugas adaptif
- Tindakan sekunder pada elemen daftar
Versi 1.4.0-rc02
13 Desember 2023
androidx.car.app:app-*:1.4.0-rc02
dirilis. Versi 1.4.0-rc02 berisi commit ini.. Hanya perbaikan kecil
Perbaikan Bug
- Mengupdate javadoc di
ConversationItem
untuk menyatakan bahwa pesan harus diurutkan dari yang terlama hingga terbaru (I77a2a) - Memperbarui logika pemotongan
ListTemplate
untuk menghapus pesan terlama dariConversationItem
(Ie0a61)
Versi 1.4.0-rc01
1 November 2023
androidx.car.app:app-*:1.4.0-rc01
dirilis tanpa perubahan penting. Versi 1.4.0-rc01 berisi commit ini..
Versi 1.4.0-beta02
20 September 2023
androidx.car.app:app-*:1.4.0-beta02
dirilis. Versi 1.4.0-beta02 berisi commit ini.. Hal ini hampir identik dengan beta01, tetapi menurunkan persyaratan compileSdk
menjadi 33.
Perbaikan Bug
- Memperbaiki bug saat layar pemuatan di Tab tidak ditampilkan dengan benar. (cae860)
Versi 1.4.0-beta01
9 Agustus 2023
androidx.car.app:app-*:1.4.0-beta01
dirilis. Versi 1.4.0-beta01 berisi commit ini..
Catatan: 1.4-beta01 memerlukan compileSdk34, yang masih dalam status dev. 1.4-beta02 akan memperbaiki masalah ini. Atau, Anda dapat menambahkan
android.suppressUnsupportedCompileSdk=34
ke filesettings.gradle
project guna menyembunyikan peringatan untuk sementara dengan aman.
Fitur Baru
- Instrumen rendering peta Cluster untuk aplikasi Navigasi
- Template Tab baru untuk meningkatkan tata letak / kegunaan aplikasi
- Dukungan untuk Batas tugas adaptif
- Tindakan sekunder pada elemen daftar
Perubahan API
- Lihat alpha02
Versi 1.4.0-alpha02
26 Juli 2023
androidx.car.app:app-*:1.4.0-alpha02
dirilis. Versi 1.4.0-alpha02 berisi commit ini.
- Rilis Alpha02 dimaksudkan sebagai persiapan untuk rilis beta01 yang akan datang.
Fitur Baru
- Rendering peta pada dukungan Cluster Instrumen untuk aplikasi navigasi
- Menambahkan Tab untuk aplikasi guna meningkatkan pengalaman tata letak
- Menambahkan opsi rendering template Daftar / Petak
- Menambahkan kategori baru untuk Cuaca dan Komunikasi
- Memindahkan beberapa API ke rilis CarApi 7 berikutnya
Perubahan API
- Menambahkan kolom multimedia ke
CarMessage
(I5aaf6) - Menambahkan tindakan kustom ke
ConversationItem
di Library Aplikasi Mobil (Ie5ed6) - Menambahkan tambahan untuk menunjukkan bahwa item media diputar dengan format audio imersif dan menampilkan logo format kontennya (Icb5bb)
- Menambahkan jenis Action baru,
ActionsConstraints
API untuk mendukung tombol tulis. (I31661) - Membuat
set/getTemplate
sebagaiset/get ContentTemplate
(Ica036) - Parameter template sekarang menjadi
@NonNull
. Memperbarui dokumentasi APIMapWithContentTemplate
(I0f8ed) - Menghapus tag
@ExperimentalCarApi
untuk Actions diListTemplate
untuk diluncurkan pada CAL 1.4 (I2cfcb) - Menghapus tag
@ExperimentalCarApi
untukTabTemplate
(Ifcb82) - Menghapus anotasi
@ExperimentalCarApi
dari tindakan dan dekorasi sekunder Row (I8487e) - Menambahkan ID konten tab aktif ke
TabTemplate
dan menghentikan penggunaan status aktif di Tab (I96932) - Menambahkan properti
ItemImageShape
keGridTemplate
(Ibf431) - Tambahkan properti
ItemSize
keGridTemplate
, yang mengontrol ukuran item petak sesuai dengan bucket relatif, sedang, dan besar. (Icdb3b) - Buka akses API bagi developer untuk mendapatkan salinan stack layar saat ini. (I48107)
- Menambahkan kategori untuk aplikasi cuaca ke Library Aplikasi Mobil (I2be44)
- Menambahkan kategori untuk aplikasi panggilan ke Library Aplikasi Mobil (Icab33)
- Mengganti
GridItem.Builder#setBadge()
dengan metodesetImage()
yang kelebihan beban (Id2000) - Menambahkan properti ikon ke Badge (I629b2)
- Menambahkan metode untuk menetapkan warna latar belakang badge titik (I6411c)
- Tambahkan properti Badge ke
GridItem
, sehingga badge dapat ditampilkan di atas gambarGridItem
. (I95de7) - Menambahkan objek Badge eksperimental yang akan mewakili badge untuk ditampilkan di atas gambar. (I9878d)
Versi 1.4.0-alpha01
22 Februari 2023
androidx.car.app:app-*:1.4.0-alpha01
dirilis. Versi 1.4.0-alpha01 berisi commit ini.
Perubahan API
- Menambahkan tindakan tingkat atas ke
GridTemplate
di Library Aplikasi Mobil (Id0191) - Menambahkan tindakan tingkat atas ke
ListTemplate
di Library Aplikasi Mobil (I9efab) - Menambahkan tambahan untuk menautkan subtitel item media atau deskripsinya ke item media lain (Ic84bf)
- Mengupdate API level untuk tindakan baris menjadi level 6. (Ie0a69)
- Menambahkan callback fitur pesan ke A4C (Ie3986)
Perbaikan Bug
- Menambahkan referensi dokumen java yang tidak ada untuk
CarMessage
. (I5db1c) - Mengganti
equals()
danhashCode()
untukConversationItem
danCarMessage
(I6fd10) - Meningkatkan validasi
ConversationItem.mMessages
(memerlukan nilai non-null, non-kosong (Iafc51) - Menambahkan anotasi
@Keep
ke kolomConversationItem
(I5d250) - Memperbarui dokumen java untuk dekorasi Baris dan tindakan sekunder. (I000b6)
Versi 1.3
Versi 1.3.0-rc01
7 Desember 2022
androidx.car.app:app-*:1.3.0-rc01
dirilis. Version 1.3.0-rc01 berisi commit ini.
- Perbaikan bug minor dari versi beta01. Tidak Ada Perubahan Besar.
Versi 1.3.0-beta01
7 September 2022
androidx.car.app:app:1.3.0-beta01
, androidx.car.app:app-projected:1.3.0-beta01
, androidx.car.app:app-automotive:1.3.0-beta01
, dan androidx.car.app:app-testing:1.3.0-beta01
dirilis. Versi 1.3.0-beta01 berisi commit ini.
- Aplikasi mobil yang dibuat menggunakan library ini kini dapat dibuka di Play Store menggunakan API Level 5 (lihat panduan pengembangan kami). Fitur yang dianotasi dengan API level 5 dan yang lebih rendah kompatibel dengan Android Auto 8.1+ dan Google Automotive App Host 1.4+.
Fitur Baru
Selain kemampuan yang ditambahkan di Library Car App 1.3.0-alpha01, fitur berikut telah ditambahkan sebagai bagian dari beta01 (Semua fitur di sini hanya terlibat dengan perubahan sisi host tanpa perubahan API apa pun):
- Menu navigasi mengambang akan terus ditampilkan meskipun pengguna berada di layar pilihan berbasis peta di
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
, danMapTemplate
. Hal ini dapat dilakukan dengan memperbarui info navigasi melaluiNavigationManager.updateTrip()
. - Mengaktifkan tombol tindakan dengan
FLAG_DEFAULT
agar memiliki animasi waktu tunggu. Tombol ini akan diklik secara default setelah waktu tunggu habis. ([API 5 - All Templates]
) - Subteks
Row
tidak terpotong saat mobil diparkir, tetapi dipotong menjadi 2 baris saat mengemudi. ([API 5 - All Templates]
) - Mendukung status nonaktif untuk
Action
,Toggle
,Row
([API 5 - All Templates]
)
Perubahan API
- Melonggarkan batasan dalam daftar
MapTemplate
untuk mendukung daftar yang dapat dipilih (I961ed) - Menghapus batasan untuk Tindakan Header agar ikon khusus dapat digunakan. (Iad28f)
- Menambahkan batasan
setOnClickListenerAllowed()
keActionsConstraints
. Dengan mengizinkanAction
menetapkanOnClickDelegate()
ke tindakan kecuali jenis ikon standar. (TYPE_APP_ICON
,TYPE_BACK
, danTYPE_PAN
) (I3c745)
Perbaikan Bug
- Menambahkan kompatibilitas Android Automotive Template Host 1.4+ dengan layar melengkung (
[Host change]
)
Versi 1.3.0-alpha01
27 Juli 2022
androidx.car.app:app:1.3.0-alpha01
, androidx.car.app:app-projected:1.3.0-alpha01
, androidx.car.app:app-automotive:1.3.0-alpha01
, dan androidx.car.app:app-testing:1.3.0-alpha01
dirilis. Versi 1.3.0-alpha01 berisi commit ini.
Fitur yang dianotasi dengan API level 5 kompatibel dengan Android Auto 7.9 dan yang lebih baru.
Fitur Baru
- API Level 5:
MapTemplate
baru yang dapat digunakan oleh aplikasi navigasi untuk menampilkan panel atau mencantumkan konten bersama peta (If5826, If44b8) - API Level 5:
CarAudioRecord
API baru untuk memungkinkan perekaman input audio melalui mikrofon kendaraan host (I5e71a) - API Level 5:
SuggestionManager
API baru untuk memungkinkan aplikasi memberikan saran kepada host (I5c103) - API Level 5:
Alert
API baru untuk ditampilkan dalam notifikasi konteks padaNavigationTemplate
(I163a7, I5ad70) - API Level 5: komponen
Header
danMapController
baru untuk memfasilitasi penggunaan kembali di seluruh template (If5826) - Menambahkan
androidx.car.app.category.POI
sebagai kategori untuk mengaktifkan aplikasi POI (danandroidx.car.app.category.PARKING
sertaandroidx.car.app.category.CHARGING
yang tidak digunakan lagi) (I59da1)
Perubahan API
- API Level 5: metode
onClick
baru di antarmukaSurfaceCallback
untuk memungkinkan tindakan ketuk pada interaktivitas peta (Ia9777) - API Level 5: flag baru
Action.FLAG_IS_PERSISTENT
danAction.FLAG_DEFAULT
untuk mendeskripsikanAction
(I96318, I5ad70) - API Level 5: status diaktifkan/dinonaktifkan baru untuk komponen
Action
,Row
, danToggle
(dukungan host akan hadir sekitar rilis library 1.3.0-beta01) (Id8a09) - API Level 5: Mendukung komponen
Header
baru melaluisetHeader
padaPlaceListNavigationTemplate.Builder
danRoutePreviewNavigationTemplate.Builder
, serta menghentikan penggunaan metodesetTitle
dansetHeaderAction
yang ada (I30e6a) - API Level 5: metode
setOnContentRefreshListner
baru padaPlaceListMapTemplate.Builder
danPlaceListNavigationTemplate.Builder
untuk digunakan dengan implementasi antarmukaOnContentRefreshListner
yang baru. - API Level 5:
setTripText
dansetTripIcon
baru diTravelEstimate.Builder
untuk menyesuaikan kartu perkiraan perjalanan (Idcc6d, Ic620d) - Menambahkan dukungan untuk
CarIconSpan
dalam judulPaneTemplate
(Ia1ee0) - Menambahkan dukungan untuk
CarIconSpan
dalam judul dan teksRow
(Ic1e3c) - Kini
ActionStrip
peta dapat memiliki hingga empat tindakan (If3522) - Mengupdate API Level Aplikasi Mobil ke 5 (I26b8e)
- Header/judul kini bersifat opsional untuk
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
, danSignInTemplate
(I2078d, Icadde)
Perbaikan Bug
- Mengupdate aturan ukuran gambar
PaneTemplate
menjadi kotak pembatas persegi (Idd72e) - Memperbaiki pengecualian yang terjadi jika stack layar diubah setelah
State.DESTROYED
. (I3c8eb) - Menambahkan pemeriksaan null untuk pengambilan ikon aplikasi (I3f710)
- Mengupdate Car Hardware API untuk menggunakan
STATUS_UNKNOWN
, bukanSTATUS_UNAVAILABLE
secara default (Ic9444) - Periksa apakah tampilan ada sebelum membuat platform (Ice027a)
- Memperbaiki bug
CarValue.equals()
yang melibatkanSTATUS_UNIMPLEMENTED
(I24451)
Versi 1.2
Versi 1.2.0
9 November 2022
androidx.car.app:app-*:1.2.0
dirilis. Versi 1.2.0 berisi commit ini.
- Ini adalah rilis stabilisasi, dan tidak ada perubahan jika dibandingkan dengan v1.2.0-rc01.
Versi 1.2.0-rc01
23 Maret 2022
androidx.car.app:app-*:1.2.0-rc01
dirilis. Versi 1.2.0-rc01 berisi commit ini.
- Ini adalah rilis stabilisasi, dan tidak ada perubahan API jika dibandingkan dengan
v1.2.0-beta02
. Fitur eksperimental baru (API level 5) telah ditambahkan dan ditujukan untuk rilis Android Auto dan Android Automotive mendatang.
Perbaikan Bug
- Memperbaiki pengecualian yang terjadi jika stack layar diubah setelah
State.DESTROYED
. (I3c8eb) - Mengupdate
CarSensors
API guna menunjukkan bahwa implementasinya tidak diterapkan untuk AAOS (Idd57b) - Mengupdate
PlaceListMapTempalte.Builder#setCurrentLocationEnabled
untuk menunjukkan bahwa ACCESS_COARSE_LOCATION akan cukup untuk fitur tersebut (I510c2) - Membuat nomor exit menjadi opsional untuk jenis manuver bundaran bersudut (Ife7d1)
Versi 1.2.0-beta02
26 Januari 2022
androidx.car.app:app-*:1.2.0-beta02
dirilis. Versi 1.2.0-beta02 berisi commit ini.
Aplikasi mobil yang dibuat dengan versi library ini dan menargetkan platform Android Automotive OS
sekarang dapat dipublikasikan ke saluran pengujian terbuka Play Store. Lihat panduan pengembangan untuk detail selengkapnya.
Fitur yang dianotasi dengan API level 4 dan yang lebih rendah kompatibel dengan Android Auto
7.2 dan yang lebih tinggi serta platform Android Automotive OS
baru. Lihat bagian Known Issues
di bawah untuk peringatan.
Perubahan API
- Menambahkan
setOnContentRefreshListener
API eksperimental ke template POI (I6bf22)
Perbaikan Bug
- Memperbaiki kebocoran memori dalam
CarAppService
saat host mobil melepas ikatan. (I5c9ca, b/203594731) - Mengupdate javadoc
CarAppActivity
agar menyertakan persyaratan untuk mode peluncuran singleTask (Id2f95) - Mengurangi glitch visual saat melanjutkan. (Iff7e0)
Masalah Umum
ActionStrip
peta diPlaceListNavigationTemplate
danRoutePreviewNavigateTemplate
akan mulai tersedia di rilisAndroid Auto
danAndroid Automotive OS
berikutnya.
Versi 1.2.0-alpha02
15 Desember 2021
androidx.car.app:app-*:1.2.0-alpha02
dirilis. Versi 1.2.0-alpha02 berisi commit ini.
Fitur yang dianotasi dengan API level 4 telah diupgrade dari eksperimental ke stabil, termasuk peta ActionStrip
di PlaceListNavigationTemplate
dan RoutePreviewNavigateTemplate
, gambar CarIcon
di Pane
, QRCodeSignInMethod
dan kemampuan untuk menetapkan petunjuk rendering (misalnya flag) dalam Action
.
Fitur Baru
- Di Android Auto 7.1 dan yang lebih baru, batas item untuk
Pane
telah dinaikkan dari 2 menjadi 4.
Perubahan API
- Menambahkan metode
toString()
eksperimental keCarUnit
(I36a3b)
Perbaikan Bug
- Memperbaiki error yang terjadi di
CarAppPermissionActivity
jika callback sudah tidak aktif (If9823) - Mengubah batas daftar default
Pane
menjadi 4 (I0068b)
Versi 1.2.0-alpha01
3 November 2021
androidx.car.app:app-*:1.2.0-alpha01
dirilis. Versi 1.2.0-alpha01 berisi commit ini.
Semua fitur v1.2.0
baru (API 4+) saat ini masih bersifat eksperimental yang menargetkan rilis Android Auto dan Android Automotive OS di masa mendatang. Lihat panduan pengembangan untuk detail selengkapnya.
Perubahan API
- Membuat
AutomotiveCarInfo
API menjadi eksperimental. (Ia13e5) - Menambahkan Library Car App API level 4 (I2a2e7)
- API Level 4: Menambahkan dukungan untuk menyetel
CarIcon
diPane
(Ifcc12) - API Level 4: Menambahkan metode login kode QR (Ib623e)
- API Level 4: Menambahkan set/getFlags ke
Action
(Ic03ab) - API Level 4: Menambahkan dukungan untuk menggeser dan memperbesar/memperkecil dalam
PlaceListNavigationTemplate
danRoutePreviewNavigationTemplate
(I9d8a3)
Perbaikan Bug
- API Level 4: Menambahkan mekanisme untuk mengizinkan aplikasi mengirim pembaruan lokasi ke host mobil (I3bad3)
- Memperbaiki masalah saat logika validasi host tidak menemukan izin TEMPLATE_RENDERER dengan benar (I62618)
Versi 1.1.0
Versi 1.1.0
15 Desember 2021
androidx.car.app:app-*:1.1.0
dirilis. Versi 1.1.0 berisi commit ini.
Ini adalah rilis stabilisasi, dan tidak ada perubahan jika dibandingkan dengan v1.1.0-rc01
. Lihat juga catatan rilis untuk v1.2.0-alpha02
guna mengetahui detail selengkapnya tentang fitur baru untuk library aplikasi mobil.
Perubahan penting sejak versi 1.0.0
- API Level 2:
SignInTemplate
danLongMessageTemplate
yang dapat digunakan untuk alur login saat kendaraan diparkir - API Level 2: dukungan interaktivitas peta dalam
NavigationTemplate
- API Level 2: dukungan beberapa teks panjang untuk memungkinkan aplikasi memberikan beberapa versi string untuk ditampilkan, bergantung pada ukuran layar mobil.
- API Level 3:
CarHardwareManager
yang dapat digunakan untuk mengkueri data hardware kendaraan, seperti model dan produsen, tingkat bahan bakar, dan sensor lainnya.
Versi 1.1.0-rc01
3 November 2021
androidx.car.app:app-*:1.1.0-rc01
dirilis. Versi 1.1.0-rc01 berisi commit ini.
Ini adalah rilis stabilisasi, dan tidak ada perubahan API jika dibandingkan dengan v1.1.0-beta01
. Fitur eksperimental baru (API level 4) telah ditambahkan dan ditujukan untuk rilis Android Auto mendatang. Lihat catatan rilis v1.2.0-alpha01
untuk mendapatkan detail selengkapnya tentang API eksperimental.
Versi 1.1.0-beta01
1 September 2021
androidx.car.app:app-*:1.1.0-beta01
dirilis. Versi 1.1.0-beta01 berisi commit berikut ini.
Semua fitur v1.1.0
(API 2+) sepenuhnya kompatibel dengan Android Auto 6.7 dan yang lebih baru. Lihat panduan pengembangan untuk detail selengkapnya.
Perubahan API
- Menghapus
Manager
sebagai antarmuka publik (Ie381b) - Menambahkan kemampuan untuk menyetel latar belakang bermerek kustom untuk permintaan izin (I74b76)
- Menambahkan
ScreenManager.getStackSize
(I0b16a) - Menghapus konstruktor
ScreenController
yang secara eksplisit mengambilTestCarContext
(Iefebc)
Perbaikan Bug
- Menambahkan pemeriksaan API level saat membuat
CarHardwareManager
(I48f9b) - Menambahkan pemeriksaan untuk penggunaan
CarSpan
yang tidak valid di seluruh API (I65ae6) - Memperbaiki masalah yang menyebabkan stack akan mengalami status rusak jika
Screen
ditandai sebagai selesai selama pembuatannya (I81b13) - Memperbaiki masalah yang menyebabkan
CarNotificationManager.notify
mencatat error untuk AutomotiveOS jika ada tindakan dengan ikon diCarAppExtender
(I3633d) - Menambahkan metode handshake untuk aplikasi dan host guna menetapkan versi API (I7d6f8)
Versi 1.1.0-alpha02
21 Juli 2021
androidx.car.app:app-*:1.1.0-alpha02
dirilis. Versi 1.1.0-alpha02 berisi commit ini.
Fitur Baru
- API Level 3: Menambahkan
CarHardwareManager
yang dapat digunakan untuk mengkueri data hardware kendaraan, seperti model dan produsen, tingkat bahan bakar, dan sensor lainnya. Saat ini, fitur ini hanya tersedia untuk Android Auto 6.7+ di saluran pengujian terbuka. Pengujian ini di lingkungan desktop memerlukan versi baruDesktop Head Unit
yang akan dirilis secara terpisah. Nantikan halaman Menguji aplikasi Android untuk mobil untuk mendapatkan detail tentang kapan versi baru tersedia. - Ikuti panduan pengembangan dan referensi library untuk detail tambahan dan panduan desain tentang cara menggunakan fitur tersebut di host mobil yang kompatibel dengan API level 3.
Perubahan API
- Menggabungkan metode siklus proses
SessionController
danScreenController
menjadi satu metodemoveToState
(I1ed00) CarContext#getHostInfo()
telah ditambahkan (I8977e)- Menghapus kolom yang tidak digunakan lagi. (I67168)
- Memperbarui
SessionController
danScreenController
untuk menampilkan konstruktor secara langsungIabf22 ) - Menghapus
PinSignInMethod.Builder
danProviderSignInMethod.Builder
(I9f0cb) - Menambahkan 'setCarAppResult()' untuk memungkinkan penggunaan aplikasi dengan template 'for result' di AAOS (I37741)
- Anotasi antarmuka
CarHardware
dengan@MainThread
. (Ib2f85) - Mengganti nama
OnCarDataListener
menjadiOnCarDataAvailableListener
(I518ca) - Memperbarui nama metode
CarInfo
,Speed
,Mileage
dan javadoc. (I86672) - Mengganti nama
Toll
menjadiTollCard
. (I3e7c8) - Menghapus
PinSignInMethod.getPin
yang tidak digunakan lagi, yang diganti denganPinSignInMethod.getPinCode
(I996ce) - Menghapus
OnInputCompletedListener
(diganti denganInputCallback
). (Ib5be1) - Mengubah
PinSignInMethod
menjadiCharSequence
, bukanString
(I275d5)
Perbaikan Bug
- Perbaikan Javadoc untuk hardware mobil. (I2abbc)
Kontribusi Eksternal
Masalah Umum
- Dalam
SignInTemplate
, menggunakanInputSignInMethod
dapat menyebabkanNullPointerException
di host mobil. Hal ini akan diatasi dalam rilis library berikutnya. Untuk mengatasi masalah ini, sertakan baris ini dalam konfigurasi Proguard aplikasi Anda:-keep class androidx.car.app.model.signin.InputSignInMethod { *; }
Versi 1.1.0-alpha01
16 Juni 2021
androidx.car.app:app:1.1.0-alpha01
, androidx.car.app:app-automotive:1.1.0-alpha01
, dan androidx.car.app:app-testing:1.1.0-alpha01
dirilis. Versi 1.1.0-alpha01 berisi commit berikut.
Fitur Baru
- API Level 2:
SignInTemplate
danLongMessageTemplate
baru yang dapat digunakan untuk alur masuk saat kendaraan diparkir. - API Level 2: dukungan interaktivitas peta baru dalam
NavigationTemplate
- API Level 2: dukungan beberapa teks panjang yang baru untuk memungkinkan aplikasi memberikan beberapa versi string untuk ditampilkan, bergantung pada ukuran layar mobil.
- Ikuti panduan pengembangan dan Javadoc library untuk detail tambahan dan panduan desain tentang cara menggunakan fitur tersebut di host mobil yang kompatibel dengan API level 2.
Perubahan API
- Membuat semua metode antarmuka
*Callback
default dan mengganti namaOnRequestPermissionsCallback
->OnRequestPermissionsListener
(Ib3ec9) - Memperbarui class
androidx.car.app.hardware
untuk menghapus builder dan class parameter yang tidak perlu. (I67beb) - Menambahkan class
androidx.car.app.hardware
untuk akses ke data khusus mobil seperti bahan bakar, baterai, dan kecepatan. (Iff3c9) - Menambahkan dukungan
ActionStrip
diMessageTemplate
(Ida657) - Menambahkan
setLoading
keMessageTemplate
. (I2a4b5) - Mengganti nama
ConnectionToCar
menjadiCarConnection
(Ife9bd) - Mengubah
NavigationTemplate
untuk menampilkanPanModeDelegate
eksplisit (I13877) - Urutan parameter telah diperbarui untuk
CarContext.requestPermissions
(Ib890a) - Mengupdate kunci metadata untuk menentukan API level mobil minimal menjadi
androidx.car.api.minCarApiLevel
(Ib0d41) - Membuat API yang memungkinkan pengamatan status koneksi mobil (Ifc935)
- Menambahkan dukungan untuk penyetelan pengalih untuk
Action
, dan menambahkan jenis mode panAction
(Ica6af) - Membuat
CarNotificationManager
untuk mendukung pengiriman notifikasi di mobil (I10d7a) - Menambahkan
ConstraintManager
untuk memberikan batas daftar dari host (I8690e) - Menambahkan mode geser dan API strip tindakan peta di
NavigationTemplate
(I77aa6) - Menambahkan API geser dan zoom di
SurfaceCallback
untuk aplikasi navigasi (Id5e9d) - Memperbarui
CarAppApiLevel
menjadi 2 (Ic1540) - Menambahkan kemampuan untuk meminta izin dari
CarAppService
(I5421e) - Menambahkan anotasi
RequiresCarApi(2)
ke API multi-teks (Iacb62) - Mengizinkan beberapa variasi teks dalam judul template setengah daftar (Ib8df7)
- Menambahkan
LongMessageTemplate
baru (memerlukan Car API level 2) (Ic5cee )
Perbaikan Bug
- Mengupdate persyaratan ukuran gambar untuk memperhitungkan layar mobil yang lebih besar (I116dc)
- Melarang penambahan lebih dari 2 tindakan dalam isi template (I32157)
- Memastikan semua pembuatan
PendingIntent
dalam flag set library aplikasi mobil. (If84fe, b/186394900) - Mengupdate Javadoc untuk memungkinkan adanya perubahan teks
Row
sebagai pembaruan (If3f9c) androidx.activity:activity:1.2.0
sekarang menjadi dependensi API (Id1cb9)- Membuat
SignInTemplate
danLongMessageTemplate
agar memerlukan tindakan khusus parkir di isinya dan memperbarui dokumentasi untuk menunjukkan bahwa tindakan tersebut hanya akan ditampilkan saat mobil diparkir (Iddaa9) - Memperbaiki pengecualian yang terjadi saat memunculkan
Screen
ketika dimulai (Ifcf40, b/184664896) - Mengizinkan warna teks kustom di
ForegroundCarColorSpan
(I69e59) - Memperbaiki masalah saat
ON_DESTROY
padaSession
diamati setelahON_DESTROY
Screen
(I52e01, b/183696617) - Mengupdate javadoc saat menyetel waktu tersisa
TravelEstimate
ke waktu yang tidak diketahui telah diizinkan. (I99610, b/183632456) - Memperbarui
Action
untuk mendukungForegroundColorSpan
pada judul dan warna latar belakang kustom apa pun (I578e4) - Jangan jalankan
NavigationManagerCallback#onStopNavigation
jika callback dihapus sebelum eksekutor dieksekusi (I7fc5e, b/181143772) - Memperbaiki masalah yang mengharuskan aplikasi untuk secara eksplisit mengambil dependensi pada lifecycle-common-java8 (I8b8c8)
Masalah Umum
- Di
SignInTemplate
, keyboard virtual menampilkan ikon "telusuri", bukan ikon "enter" saat pengguna ingin mengonfirmasi input. Sebagai solusinya, pengguna dapat mengakses keyboard ponsel yang aktif saat kolom input berada di dalam fokus. - Di Android Auto versi 6.5, callback geser dan zoom dalam
SurfaceCallback
mungkin salah dipanggil untuk beberapa gestur sentuhan.
Car App Testing Versi 1.0.0
Versi 1.0.0-alpha01
24 Maret 2021
androidx.car.app:app-testing:1.0.0-alpha01
dirilis. Versi 1.0.0-alpha01 berisi commit berikut ini.
Ini adalah rilis Jetpack pertama dari library pengujian sumber tertutup sebelumnya. Lihat contoh dari kami tentang cara menggunakan library ini dalam pengujian Anda.
Fitur Baru
- Pengontrol untuk class model telah dihapus. Pengambil model sekarang merupakan bagian dari platform API publik yang memungkinkan validasi nilai yang disetel di builder.
CarAppServiceController
yang sebelumnya telah diganti denganSessionController
baru untuk menguji logika yang berkaitan dengan metrik sepanjang waktu koneksi ke host.
Versi 1.0.0
Versi 1.0.0
21 April 2021
androidx.car.app:app:1.0.0
dirilis. Versi 1.0.0 berisi commit ini.
Fitur utama 1.0.0
- Pada awal April, kami mengumumkan bahwa aplikasi dapat mulai memublikasikan ke saluran produksi menggunakan
androidx.car.app:app:1.0.0-rc01
. Library Car App v1.0.0 kini stabil dan sepenuhnya kompatibel dengan Android Auto 6.1 dan yang lebih tinggi. - Ikuti panduan pengembangan untuk detail tentang cara membuat aplikasi navigasi, parkir, dan pengisian daya untuk Android Auto menggunakan library ini.
Perbaikan Bug
- Memperbaiki pengecualian yang terjadi saat memunculkan
Screen
ketika dimulai (70aae1, b/184664896) - Memperbaiki masalah saat
ON_DESTROY
padaSession
diamati setelahON_DESTROY
Screen
(0ceecb, b/183696617)
Versi 1.0.0-rc01
24 Maret 2021
androidx.car.app:app:1.0.0-rc01
dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.
Perbaikan Bug
- Memperbaiki bug kondisi race saat
NavigationManagerCallback#onStopNavigation
dipanggil setelah callback dihapus. Ini terjadi jika callback dihapus sebelum eksekutor callback benar-benar berjalan (I7fc5e, b/181143772) - Memperbaiki masalah yang mengharuskan aplikasi secara eksplisit mengambil dependensi pada
lifecycle-common-java8
(I8b8c8) - Memperbaiki
NullPointerException
yang ditampilkan saat aplikasi menerima panggilanstopNavigation
ketika sudah menghapus callback (Ib8b89, b/181143772) - Peningkatan untuk tidak mengirim panggilan ke aplikasi jika siklus prosesnya setidaknya tidak dalam status
CREATED
(I86965, b/179800224, b/177921120) - Memperbaiki masalah saat API min yang tidak valid yang ditentukan dalam manifes aplikasi akan ditampilkan, menyebabkan ANR pada host. (Iffedd, b/174231592)
Versi 1.0.0-beta01
24 Februari 2021
androidx.car.app:app:1.0.0-beta01
dirilis. Versi 1.0.0-beta01 berisi commit berikut ini.
Ini adalah rilis Jetpack pertama dari library sumber tertutup sebelumnya, dan kompatibel dengan Android Auto 6.1 atau yang lebih baru. Ikuti panduan pengembangan untuk detail cara membuat aplikasi mobil menggunakan library ini.
Fitur Baru
- Memperkenalkan
GridTemplate
yang dapat digunakan aplikasi Anda untuk menampilkan daftar elemen UI dalam tata letak petak. - Memperkenalkan metode
CarAppService.createHostValidator
untuk memvalidasi bahwa koneksi host berasal dari sumber tepercaya (misalnya, Android Auto). - Menambahkan
CarAppExtender.Builder.setColor
API. (b/174231592)
Perbaikan Bug
- Memperbaiki masalah ketika
Screen
yang salah dilanjutkan saat menampilkan layar secara berurutan. (b/177590791)