Araba Uygulaması
Son Güncelleme | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
17 Nisan 2024 | 1.2.0 | 1.4.0-rc02 | - | 1.7.0-alpha02 |
Bağımlılıkları bildirme
Araba Uygulama Kitaplığı'na bir bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanızın veya modülünüz için build.gradle
dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:
Modern
dependencies { implementation "androidx.car.app:app:1.2.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.2.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.2.0" // For testing testImplementation "androidx.car.app:app-testing:1.2.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.2.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.2.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.2.0") // For testing testImplementation("androidx.car.app:app-testing:1.2.0") }
Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme bağımlılıkları ekleme konusuna bakın.
Geri bildirim
Geri bildiriminiz Jetpack'i daha iyi hale getirmemize yardımcı oluyor. Yeni sorunlar keşfederseniz veya bu kitaplığı nasıl geliştirebileceğimizle ilgili fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Sürüm 1.7
Sürüm 1.7.0-alpha02
17 Nisan 2024
androidx.car.app:app-*:1.7.0-alpha02
yayınlandı. 1.7.0-alpha02 sürümü bu kayıtları içerir.
Yeni Özellikler
- Harita tabanlı şablonlar için kullanımdan kaldırılmış işaretler eklendi. Bu işaretler,
MapWithContent
şablonun ilerleyen zamanlarda desteklediğini sağlayacaktır.
API Değişiklikleri
- Eski
MapTemplate
,RoutePreviewNavigationTemplate
vePlaceListNavigationTemplate
öğelerini kullanımdan kaldırın ve yeniMapWithContentTemplate
(Ib0a08) kullanımını teşvik edin
Sürüm 1.7.0-alpha01
3 Nisan 2024
androidx.car.app:app-*:1.7.0-alpha01
yayınlandı. Kitaplık sürümü şemamızı, etkin CarApi sürümüyle eşleşecek şekilde taşıdık. Bu uygulamanın amacı, geliştiriciden alınan geri bildirimler doğrultusunda adlandırma şemasındaki karışıklığı azaltmaktır. Sonuç olarak, bu kayıtları içeren Sürüm 1.7.0-alpha01'in 1.5 / 1.6 sürümlerini doğrudan 1.7 sürümüne geçireceğiz.
Yeni Özellikler
- İçerikle Harita: Harita içinde İçerik olarak Liste / Izgara / Bölme / İleti'yi destekleyen,
MapWithContent
adlı yeni şablon.RoutePreview
,PlaceListNavigation
, Harita şablonları kullanımdan kaldırıldı.- Örnek uygulamalar,
MapWithContent
kullanan kullanımdan kaldırılmış şablonların işlevlerini gösterecek şekilde güncellendi.
- İleti Dizisi Öğesi: Araçta görüşmeleri (IM, SMS) ve Asistan okumasını görüntülemek için yeni API'ler.
- Araç Boyutları: Araç ölçümlerini almak için yeni API (şu anda AAOS verileri).
API Değişiklikleri
- Ekstra küçük satır resim türünü deneysel olarak işaretleyin (I5184b)
- Yükseklik, genişlik gibi aracın dış boyut bilgilerine erişim sağlayan
CarInfo#fetchExteriorDimensions
API eklendi (Ia40c5) ExperimentalAPI
etiketiMapWithContentTemplate
öğesinden kaldırıldı (I66db8)GridItem#setTitle
parametresini boş değer atanabilir olacak şekilde güncelleyin. (I3d610)GetHeader
API, geriye dönük uyumlu olduğundan API 7 gerektirmez (I8c812)ListTemplate
içindeHeader
desteği ekleyin,headerAction
,headerTitle
,actionStrip
(I7ae01) öğelerini kullanımdan kaldırınGridTemplate
ürünündetitle
,headerAction
,actionStrip
uygulamalarını kullanımdan kaldırın veHeader
(I41a9c) desteği ekleyin- Deneysel API'ler için 7. seviye gereksinimini kaldırın: Rozet,
GridTemplate
öğe boyutu ve resim şekli belirleyiciler/belirleyiciler, Rozet alma/ayarlama içinGridItem
yöntemler. (Id71eb) PaneTemplate
ürünündetitle
,headerAction
,actionStrip
hizmetlerini kullanımdan kaldırın, yeniHeader
desteği ekleyin (I23154)BroadcastReceiver
olan Medya Merkezi telemetrisi, Özel İşleme Göz At olarak değiştirildi. (I4185f)MessageTemplate
içinHeader
özelliği desteği eklendi.ActionStrip
,headerAction
vetitle
desteğinin desteği sonlandırıldı. (Ie2de8)- Uyarı sabit görünürlüğünü değiştirme (Icf8a8)
isLoading
özelliğini üst şablondan (I651e6) kaldırın- Medya uygulamalarını ana kullanıcı arayüzü parametreleri hakkında bilgilendirmek için ekstra özellikler ekleyin (I85ca2)
MediaExtensions
uygulamasına medya merkezi analiz özelliği eklenir (I7ce28)- Satırlarda ekstra küçük resimler ekleme seçeneği eklendi. (I72c03)
Hata Düzeltmeleri
ConversationItem
adresindeki javadoc dosyasını, iletilerin en eskiden en yeniye doğru sıralanması gerektiğini belirtecek şekilde güncelleyin. (I77a2a)ConversationItem
öğesinden en eski iletileri kaldırmak içinListTemplate
kısaltma mantığını güncelleyin (Ie0a61)
Sürüm 1.4
Sürüm 1.4.0-rc02
13 Aralık 2023
androidx.car.app:app-*:1.4.0-rc02
yayınlandı. 1.4.0-rc02 sürümü bu kayıtları içerir. Yalnızca küçük düzeltmeler
Hata Düzeltmeleri
ConversationItem
adresindeki javadoc dosyasını, iletilerin en eskiden en yeniye doğru sıralanması gerektiğini belirtecek şekilde güncelleyin (I77a2a)ConversationItem
öğesinden en eski iletileri kaldırmak içinListTemplate
kısaltma mantığını güncelleyin (Ie0a61)
Sürüm 1.4.0-rc01
1 Kasım 2023
androidx.car.app:app-*:1.4.0-rc01
dikkate değer bir değişiklik olmadan yayınlandı. 1.4.0-rc01 sürümü bu kayıtları içerir.
Sürüm 1.4.0-beta02
20 Eylül 2023
androidx.car.app:app-*:1.4.0-beta02
yayınlandı. 1.4.0-beta02 sürümü bu kayıtları içerir. Bu değer beta01 ile neredeyse aynıdır, ancak compileSdk
şartını 33'e düşürür.
Hata Düzeltmeleri
- Sekmelerdeki yükleme ekranlarının düzgün görüntülenmemesine neden olan hata düzeltildi. (cae860)
Sürüm 1.4.0-beta01
9 Ağustos 2023
androidx.car.app:app-*:1.4.0-beta01
yayınlandı. 1.4.0-beta01 sürümü bu kayıtları içerir.
Not: 1.4-beta01 sürümü için hâlâ geliştirici durumunda olan derSdk34 gerekir. 1.4-beta02 bu sorunu düzeltecektir. Alternatif olarak, uyarıyı güvenli bir şekilde geçici olarak engellemek için projenizin
settings.gradle
dosyasınaandroid.suppressUnsupportedCompileSdk=34
ekleyebilirsiniz.
Yeni Özellikler
- Navigasyon uygulamaları için gösterge Kümesi harita oluşturma
- Daha iyi uygulama düzeni / kullanılabilirliği için yeni sekme şablonu
- Uyarlanabilir görev sınırları desteği
- Liste öğelerinde ikincil işlemler
API Değişiklikleri
- Alfa02 sürümünü göster
Sürüm 1.4.0-alpha02
26 Temmuz 2023
androidx.car.app:app-*:1.4.0-alpha02
yayınlandı. Sürüm 1.4.0-alpha02 bu kayıtları içerir.
- Alfa02 sürümü, yakında çıkacak Beta01 sürümüne hazırlık amacıyla tasarlanmıştır.
Yeni Özellikler
- Navigasyon uygulamaları için Gösterge Grubu desteğinde harita oluşturma
- Düzen deneyimini iyileştirmek için uygulamalar için Sekmeler eklendi
- Eklenen Liste / Izgara şablonu oluşturma seçenekleri
- Hava Durumu ve İletişim için yeni kategoriler eklendi
- Birkaç API'yi bir sonraki CarApi 7 sürümüne taşıma
API Değişiklikleri
CarMessage
ürününe (I5aaf6) multimedya alanları ekleyin- Araba Uygulama Kitaplığı'nda (Ie5ed6)
ConversationItem
öğesine özel işlemler ekler - Bir medya öğesinin kapsamlı bir ses biçiminde oynatıldığını belirtmek için ekstra öğeler ekleyin ve içerik formatı logosunu gösterin (Icb5bb)
- Oluştur düğmesini desteklemek için
ActionsConstraints
API'de yeni işlem türü eklendi. (I31661) set/getTemplate
,set/get ContentTemplate
(Ica036) olarak yapıldı- Şablon parametresi artık
@NonNull
olur.MapWithContentTemplate
API belgeleri güncellendi (I0f8ed) - CAL 1.4'te (I2cfcb) kullanıma sunmak üzere
ListTemplate
işlevindeki İşlemler için@ExperimentalCarApi
etiketini kaldırır TabTemplate
(Ifcb82) için@ExperimentalCarApi
etiketini kaldırır- Satır ikincil işlemlerinden ve süslemelerinden
@ExperimentalCarApi
ek açıklamasını kaldırma (I8487e) TabTemplate
öğesine etkin sekme içerik kimliği ekler ve Sekmelerdeki etkin durumu kullanımdan kaldırır (I96932)GridTemplate
alanına (Ibf431)ItemImageShape
özelliğini ekleyinGridTemplate
için, göreli küçük, orta ve büyük gruplara göre ızgara öğesi boyutlandırmasını kontrol edenItemSize
özelliğini ekleyin. (Icdb3b)- Mevcut ekran yığınının bir kopyasını edinmek için geliştiricilerin API erişimini açın. (I48107)
- Araba Uygulama Kitaplığı'na hava durumu uygulamaları için kategori ekler (I2be44)
- Araba Uygulama Kitaplığı'na (Icab33) uygulama çağırmak için kategori ekler
GridItem.Builder#setBadge()
, aşırı yüklenmişsetImage()
yöntemleriyle değiştirildi (Id2000)- Rozete simge özelliği ekle (I629b2)
- Nokta rozet arka plan rengini ayarlama yöntemi ekleyin (I6411c)
GridItem
ürününe Rozet özelliği ekleyerekGridItem
resminin üzerinde bir rozetin görüntülenmesini sağlayın. (I95de7)- Bir resmin üzerinde görüntülenecek bir rozeti temsil edecek deneysel bir Rozet nesnesi eklendi. (I9878d)
Sürüm 1.4.0-alpha01
22 Şubat 2023
androidx.car.app:app-*:1.4.0-alpha01
yayınlandı. Sürüm 1.4.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
- Araba Uygulama Kitaplığı'nda
GridTemplate
öğesine üst düzey işlemler ekler (Id0191) - Araba Uygulama Kitaplığı'nda (I9efab)
ListTemplate
öğesine üst düzey işlemler ekler - Bir medya öğesinin alt başlığını veya açıklamasını diğer medya öğelerine bağlamak için ekstra öğeler ekleyin (Ic84bf)
- Satır işlemlerinin API düzeyini düzey 6'ya güncelleyin. (Ie0a69)
- A4C'ye (Ie3986) mesajlaşma geri çağırmaları ekleme
Hata Düzeltmeleri
CarMessage
için eksik java dokümanı referanslarını ekleyin. (I5db1c)ConversationItem
veCarMessage
içinequals()
vehashCode()
değerlerini geçersiz kıl (I6fd10)ConversationItem.mMessages
doğrulamasını iyileştirin (boş olmayan, boş olmayan (Iafc51) olmayan doğrulamayı zorunlu kılınConversationItem
alana (I5d250)@Keep
ek açıklaması ekleyin- Satır süslemesi ve ikincil işlemler için Java dokümanlarını güncelleyin. (I000b6)
Sürüm 1.3
Sürüm 1.3.0-rc01
7 Aralık 2022
androidx.car.app:app-*:1.3.0-rc01
yayınlandı. 1.3.0-rc01 sürümü bu kayıtları içerir.
- Beta01 sürümünden küçük hata düzeltmeleri. Önemli Değişiklik Yok.
Sürüm 1.3.0-beta01
7 Eylül 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
ve androidx.car.app:app-testing:1.3.0-beta01
yayınlandı. 1.3.0-beta01 sürümü bu kayıtları içerir.
- Bu kitaplık kullanılarak oluşturulan araba uygulamaları artık API Düzeyi 5 kullanılarak Play Store'a gidebilir (geliştirme kılavuzumuzu inceleyin). API düzeyi 5 ve altı ile ek açıklama girilen özellikler hem Android Auto 8.1+ ile hem de Google Automotive App Host 1.4+ ile uyumludur.
Yeni Özellikler
Araba Uygulama Kitaplığı 1.3.0-alpha01'de eklenen özelliklere ek olarak, beta01 kapsamında aşağıdaki özellikler de eklenmiştir (Buradaki tüm özellikler yalnızca herhangi bir API değişikliği yapılmadan ana makine tarafında yapılan değişiklikleri içerir):
- Kullanıcı
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
veMapTemplate
bölgelerinde harita tabanlı bir seçim ekranında olsa bile kayan gezinme çubuğu gösterilmeye devam eder. Bunun için navigasyon bilgileriniNavigationManager.updateTrip()
üzerinden güncelleyebilirsiniz. - Zaman aşımı animasyonu için
FLAG_DEFAULT
içeren işlem düğmesini etkinleştirin. Bu düğme, zaman aşımı süresinden sonra varsayılan olarak tıklanacaktır. ([API 5 - All Templates]
) - Araba park edildiğinde
Row
alt metni kısaltılmaz ancak sürüş sırasında 2 satır olacak şekilde kısaltılır. ([API 5 - All Templates]
) Action
,Toggle
,Row
([API 5 - All Templates]
) için destek devre dışı bırakıldı
API Değişiklikleri
- Seçilebilir listeleri desteklemek için
MapTemplate
listesindeki kısıtlamaları gevşetin (I961ed) - Özel simgelere izin vermek için Başlık İşlemleri kısıtlamasını kaldırın. (Iad28f)
ActionsConstraints
içinsetOnClickListenerAllowed()
kısıtlaması ekleyin.Action
öğesinin standart simge türleri dışındaki işlemlereOnClickDelegate()
ayarlanmasına izin verdiği yerler. (TYPE_APP_ICON
,TYPE_BACK
veTYPE_PAN
) (I3c745)
Hata Düzeltmeleri
- Kavisli ekranlarla Android Automotive Template Host 1.4+ uyumluluğu eklendi (
[Host change]
)
Sürüm 1.3.0-alpha01
27 Temmuz 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
ve androidx.car.app:app-testing:1.3.0-alpha01
yayınlandı. Sürüm 1.3.0-alpha01 bu kayıtları içerir.
API düzeyi 5 ek açıklamasına sahip özellikler, Android Auto 7.9 ve sonraki sürümlerle uyumludur.
Yeni Özellikler
- API Seviyesi 5: Gezinme uygulamaları tarafından, bir haritanın yanında içerik bölmesi veya listelemek için kullanılabilecek yeni
MapTemplate
(If5826, If44b8) - API Seviye 5: Ana aracın mikrofonu aracılığıyla ses girişi kaydetmeye izin veren yeni
CarAudioRecord
API (I5e71a) - API Seviyesi 5: Uygulamaların ana makineye öneri sağlamasına izin vermek için yeni
SuggestionManager
API'si (I5c103) - API Seviyesi 5:
NavigationTemplate
'da bağlam bildirimlerinde gösterilecek yeniAlert
API'si (I163a7, I5ad70) - API Düzeyi 5: Şablonlar arasında yeniden kullanımı kolaylaştırmak için yeni
Header
veMapController
bileşenleri (If5826) - Önemli yer uygulamalarını etkinleştirmek için
androidx.car.app.category.POI
kategorisi eklendi (veandroidx.car.app.category.PARKING
ileandroidx.car.app.category.CHARGING
kullanımdan kaldırıldı) (I59da1)
API Değişiklikleri
- API Düzeyi 5: Harita üzerinde dokunma etkileşimine olanak tanımak için
SurfaceCallback
arayüzünde yenionClick
yöntemi (Ia9777) - API Düzeyi 5:
Action
öğelerini tanımlamak için yeniAction.FLAG_IS_PERSISTENT
veAction.FLAG_DEFAULT
işaretleri (I96318, I5ad70) - API Düzeyi 5:
Action
,Row
veToggle
bileşenleri için yeni etkin/devre dışı durumu (kitaplık 1.3.0-beta01 sürümünde ana makine desteği kullanıma sunuluyor) (Id8a09) - API Düzeyi 5: Mevcut
setTitle
vesetHeaderAction
yöntemlerini (I30e6a) kullanımdan kaldırarakPlaceListNavigationTemplate.Builder
veRoutePreviewNavigationTemplate.Builder
'dasetHeader
aracılığıyla yeniHeader
bileşenini tercih edin - API Düzeyi 5: Yeni
OnContentRefreshListner
arayüzünün uygulamalarıyla kullanım içinPlaceListMapTemplate.Builder
vePlaceListNavigationTemplate.Builder
ile ilgili yenisetOnContentRefreshListner
yöntemi. - API Düzeyi 5: Seyahat tahmini kartını özelleştirmek için
TravelEstimate.Builder
'da yenisetTripText
vesetTripIcon
(Idcc6d, Ic620d) PaneTemplate
başlığında (Ia1ee0)CarIconSpan
için destek ekleyinRow
adlı videonun başlık ve metnineCarIconSpan
desteği ekleyin (Ic1e3c)- Harita
ActionStrip
öğeleri artık dört adede kadar işlem içerebilir (If3522) - Araba Uygulaması API düzeyini 5 olarak güncelleme (I26b8e)
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
veSignInTemplate
(I2078d, Icadde) için başlıklar/başlıklar artık isteğe bağlıdır
Hata Düzeltmeleri
PaneTemplate
görüntü boyutlandırma kuralı, kare sınırlayıcı kutu olarak güncellendi (Idd72e)State.DESTROYED
tarihinden sonra ekran yığını değiştirilirse ortaya çıkan bir istisna düzeltildi. (I3c8eb)- Uygulama simgesini geri almak için null denetim eklendi (I3f710)
- Araba Donanımı API'sini varsayılan olarak
STATUS_UNAVAILABLE
yerineSTATUS_UNKNOWN
kullanacak şekilde güncelleyin (Ic9444) - Yüzey oluşturmadan önce ekranın var olup olmadığını kontrol edin (Ice027a)
STATUS_UNIMPLEMENTED
(I24451) ile ilgiliCarValue.equals()
hatasını düzeltin
Sürüm 1.2
Sürüm 1.2.0
9 Kasım 2022
androidx.car.app:app-*:1.2.0
yayınlandı. 1.2.0 sürümü bu kayıtları içerir.
- Bu bir sabitleme sürümüdür. 1.2.0-rc01 sürümüne kıyasla herhangi bir değişiklik yoktur.
Sürüm 1.2.0-rc01
23 Mart 2022
androidx.car.app:app-*:1.2.0-rc01
yayınlandı. 1.2.0-rc01 sürümü bu kayıtları içerir.
- Bu bir sabitleme sürümüdür ve
v1.2.0-beta02
ile karşılaştırıldığında herhangi bir API değişikliği yoktur. Gelecekteki Android Auto ve Android Automotive sürümleri için tasarlanmış yeni deneysel özellikler (API düzeyi 5) eklendi.
Hata Düzeltmeleri
State.DESTROYED
tarihinden sonra ekran yığını değiştirilirse ortaya çıkan bir istisna düzeltildi. (I3c8eb)CarSensors
API, AAOS için uygulanmadıklarını belirtecek şekilde güncellendi (Idd57b)- Bu özellik için ACCESS_COARSE_LOCATION değerinin yeterli olacağını belirtmek üzere
PlaceListMapTempalte.Builder#setCurrentLocationEnabled
güncellendi (I510c2) - Açılı manevra türleri için çıkış numarası isteğe bağlı hale getirildi (Ife7d1)
Sürüm 1.2.0-beta02
26 Ocak 2022
androidx.car.app:app-*:1.2.0-beta02
yayınlandı. 1.2.0-beta02 sürümü bu kayıtları içerir.
Android Automotive OS
platformunu hedefleyen bu kitaplık sürümüyle oluşturulan araba uygulamaları artık Play Store açık test kanalında yayınlanabilir. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API düzeyi 4 ve altı ile ek açıklama verilen özellikler, hem Android Auto
7.2 ve sonraki sürümler hem de yeni Android Automotive OS
platformuyla uyumludur. Uyarılar için aşağıdaki Known Issues
bölümüne bakın.
API Değişiklikleri
- ÖY şablonlarına deneysel
setOnContentRefreshListener
API eklendi (I6bf22)
Hata Düzeltmeleri
- Araba ana makinesi bağlandığında
CarAppService
ürününde yaşanan bellek sızıntısı düzeltildi. (I5c9ca, b/203594731) CarAppActivity
javadoc, singleTask başlatma modu gereksinimlerini içerecek şekilde güncellendi (Id2f95)- Özgeçmişte görülen görsel kusurları azaltır. (Iff7e0)
Bilinen Sorunlar
PlaceListNavigationTemplate
veRoutePreviewNavigateTemplate
içindekiActionStrip
haritaları sonrakiAndroid Auto
veAndroid Automotive OS
sürümlerinde kullanılabilecek.
Sürüm 1.2.0-alpha02
15 Aralık 2021
androidx.car.app:app-*:1.2.0-alpha02
yayınlandı. Sürüm 1.2.0-alpha02 bu kayıtları içerir.
PlaceListNavigationTemplate
ve RoutePreviewNavigateTemplate
haritalarındaki ActionStrip
haritaları, Pane
içindeki CarIcon
resmi, QRCodeSignInMethod
ve Action
için oluşturma ipuçları (ör. işaretler) ayarlayabilme de dahil olmak üzere, API düzeyi 4 ile ek açıklama eklenen özellikler deneme aşamasından kararlı sürüme yükseltildi.
Yeni Özellikler
- Android Auto 7.1 ve sonraki sürümlerde
Pane
için öğe sınırı 2'den 4'e çıkarılmıştır.
API Değişiklikleri
CarUnit
öğesine deneysel birtoString()
yöntemi eklendi(I36a3b)
Hata Düzeltmeleri
- Geri çağırma devre dışıyken
CarAppPermissionActivity
içinde gerçekleşen kilitlenme düzeltildi (If9823) Pane
için varsayılan liste sınırı 4 olarak değiştirildi (I0068b)
Sürüm 1.2.0-alpha01
3 Kasım 2021
androidx.car.app:app-*:1.2.0-alpha01
yayınlandı. Sürüm 1.2.0-alpha01 bu kayıtları içerir.
Tüm yeni v1.2.0
özellikleri (API 4 ve sonraki sürümler) şu anda deneysel olarak gelecekteki Android Auto ve Android Automotive OS sürümlerini hedeflemektedir. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API Değişiklikleri
AutomotiveCarInfo
API deneysel hale getirildi. (Ia13e5)- Araba Uygulama Kitaplığı API'sı seviye 4 eklendi (I2a2e7)
- API Düzeyi 4:
Pane
içindeCarIcon
ayarlama desteği eklendi (Ifcc12) - API Düzeyi 4: QR kodu oturum açma yöntemi eklendi (Ib623e)
- API Düzeyi 4:
Action
öğesine set/getFlags eklendi (Ic03ab) - API Düzeyi 4:
PlaceListNavigationTemplate
veRoutePreviewNavigationTemplate
dillerinde kaydırma ve yakınlaştırma desteği eklendi (I9d8a3)
Hata Düzeltmeleri
- API Düzeyi 4: Uygulamaların, araba ana makinesine konum güncellemeleri göndermesine izin verecek mekanizma ekleyin (I3bad3)
- Ana makine doğrulama mantığının TEMPLATE_RENDERER iznini düzgün bulamamasına neden olan sorunu düzelt (I62618)
Sürüm 1.1.0
Sürüm 1.1.0
15 Aralık 2021
androidx.car.app:app-*:1.1.0
yayınlandı. 1.1.0 sürümü bu kayıtları içerir.
Bu bir sabitleme sürümüdür ve v1.1.0-rc01
ile karşılaştırıldığında herhangi bir değişiklik yoktur. Araba uygulama kitaplığındaki yeni özelliklerle ilgili daha fazla ayrıntı için v1.2.0-alpha02
sürüm notlarına da bakın.
1.0.0'dan sonraki önemli değişiklikler
- API Düzeyi 2: Araç park edildiğinde oturum açma akışları için kullanılabilecek
SignInTemplate
veLongMessageTemplate
- API Düzeyi 2:
NavigationTemplate
kapsamında harita etkileşimi desteği - API Düzeyi 2: Uygulamaların, araç ekran boyutlarına bağlı olarak görüntülemek üzere birden fazla dize versiyonunu sağlamasına izin vermek için birden fazla uzunlukta metin desteği.
- 3. API Seviyesi:
CarHardwareManager
Model ve marka, yakıt seviyeleri ve diğer sensörler gibi aracın donanım verilerini sorgulamak için kullanılabilir.
Sürüm 1.1.0-rc01
3 Kasım 2021
androidx.car.app:app-*:1.1.0-rc01
yayınlandı. 1.1.0-rc01 sürümü bu kayıtları içerir.
Bu bir sabitleme sürümüdür ve v1.1.0-beta01
ile karşılaştırıldığında herhangi bir API değişikliği yoktur. Gelecekteki Android Auto sürümlerine yönelik yeni deneysel özellikler (API düzeyi 4) eklendi. Deneysel API'ler hakkında daha fazla bilgi edinmek için v1.2.0-alpha01
sürüm notlarına göz atın.
Sürüm 1.1.0-beta01
1 Eylül 2021
androidx.car.app:app-*:1.1.0-beta01
yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.
Tüm v1.1.0
özellikleri (API 2+) Android Auto 6.7 ve sonraki sürümlerle tamamen uyumludur. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API Değişiklikleri
Manager
, herkese açık arayüz olarak kaldırıldı (Ie381b)- İzin isteği için özel markalı arka plan ayarlama özelliği eklendi (I74b76)
ScreenManager.getStackSize
(I0b16a) eklendi- Açıkça
TestCarContext
(Iefebc) alanScreenController
kurucusu kaldırıldı
Hata Düzeltmeleri
CarHardwareManager
oluşturulurken API düzeyi kontrolü eklendi (I48f9b)- API'de geçersiz
CarSpan
kullanımıyla ilgili kontroller eklendi (I65ae6) Screen
oluşturma sırasında tamamlandı olarak işaretlenirse yığını bozuk durumda bırakma sorunu (I81b13) düzeltildi.CarAppExtender
içinde simge içeren işlemler varsaCarNotificationManager.notify
aracının AutomotiveOS için hata kaydetmesine neden olan sorunu düzeltme (I3633d)- API sürümü oluşturmak amacıyla uygulama ve ana makine için el sıkışma yöntemi eklendi (I7d6f8)
Sürüm 1.1.0-alpha02
21 Temmuz 2021
androidx.car.app:app-*:1.1.0-alpha02
yayınlandı. Sürüm 1.1.0-alpha02 bu kayıtları içerir.
Yeni Özellikler
- API Düzeyi 3: Model ve marka, yakıt seviyeleri ve diğer sensörler gibi aracın donanım verilerini sorgulamak için kullanılabilecek bir
CarHardwareManager
eklendi. Şu anda bu özellik yalnızca açık test kanalındaki Android Auto 6.7 ve sonraki sürümlerde kullanılabilir. Bunu bir masaüstü ortamında test etmek için ayrı olarak yayınlanacak yeni birDesktop Head Unit
sürümü gerekiyor. Yeni sürümün ne zaman kullanıma sunulacağıyla ilgili ayrıntılar için Arabalar için Android uygulamalarını test etme sayfasını takip edin. - Bu özelliklerin API düzeyi 3 ile uyumlu araç barındırıcılarında nasıl kullanılacağıyla ilgili ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzunu ve kitaplık referansını takip edin.
API Değişiklikleri
SessionController
veScreenController
yaşam döngüsü yöntemleri tek birmoveToState
yönteminde birleştirildi (I1ed00)CarContext#getHostInfo()
(I8977e) eklendi- Kullanımdan kaldırılan alanlar kaldırıldı. (I67168)
- Oluşturucuları doğrudan göstermek için
SessionController
veScreenController
güncellendi (Iabf22) PinSignInMethod.Builder
veProviderSignInMethod.Builder
(I9f0cb) kaldırıldı- AAOS'de "sonuç için" şablonlu uygulamaların kullanımını etkinleştirmek üzere "setCarAppResult()" eklendi (I37741)
- Açıklamalı
CarHardware
arayüz,@MainThread
. (Ib2f85) OnCarDataListener
,OnCarDataAvailableListener
olarak değiştirildi (I518ca)CarInfo
,Speed
,Mileage
yöntem adları ve javadoc güncellendi. (I86672)Toll
,TollCard
olarak yeniden adlandırıldı. (I3e7c8)- Kullanımdan kaldırılan
PinSignInMethod.getPin
yerinePinSignInMethod.getPinCode
(I996ce) ile değiştirildi OnInputCompletedListener
kaldırıldı (InputCallback
ile değiştirildi). (Ib5be1)PinSignInMethod
,String
yerineCharSequence
olarak değiştirildi (I275d5)
Hata Düzeltmeleri
- Araba donanımı için Javadoc düzeltmeleri. (I2abbc)
Harici Katkı
Bilinen Sorunlar
SignInTemplate
içindeInputSignInMethod
kullanılması, araba ana makinesindeNullPointerException
hatasına neden olabilir. Bu sorun, kitaplığın bir sonraki sürümünde ele alınacaktır. Sorunu geçici olarak çözmek için uygulamanızın ProGuard yapılandırmasına şu satırı ekleyin:-keep class androidx.car.app.model.signin.InputSignInMethod { *; }
Sürüm 1.1.0-alpha01
16 Haziran 2021
androidx.car.app:app:1.1.0-alpha01
, androidx.car.app:app-automotive:1.1.0-alpha01
ve androidx.car.app:app-testing:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
Yeni Özellikler
- API Düzeyi 2: Araç park edildiğinde oturum açma akışları için kullanılabilecek yeni
SignInTemplate
veLongMessageTemplate
. - API Düzeyi 2:
NavigationTemplate
içinde yeni harita etkileşimi desteği - API Düzeyi 2: Uygulamaların, araç ekranı boyutlarına bağlı olarak görüntülemek üzere birden fazla dize sürümü sağlamasına izin veren çok uzunlukta yeni metin desteği.
- Bu özelliklerin API düzeyi 2 ile uyumlu araç barındırıcılarında nasıl kullanılacağına ilişkin ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzu ve Javadoc kitaplığından yararlanın.
API Değişiklikleri
*Callback
arayüz yöntemlerinin tümü varsayılan yapıldı veOnRequestPermissionsCallback
->OnRequestPermissionsListener
(Ib3ec9) olarak yeniden adlandırıldı- Gereksiz derleyicileri ve parametre sınıflarını kaldırmak için
androidx.car.app.hardware
sınıfları güncellendi. (I67beb) - Yakıt, akü ve hız gibi araca özel verilere erişim için
androidx.car.app.hardware
sınıfları eklendi. (Iff3c9) MessageTemplate
adlı cihazaActionStrip
desteği eklendi (Ida657)setLoading
,MessageTemplate
koleksiyonuna eklendi. (I2a4b5)ConnectionToCar
,CarConnection
(Ife9bd) olarak yeniden adlandırıldıNavigationTemplate
, açık birPanModeDelegate
(I13877) döndürecek şekilde değiştirildiCarContext.requestPermissions
(Ib890a) için parametre sırası güncellendi- Meta veri anahtarı, min. araç API düzeyini
androidx.car.api.minCarApiLevel
(Ib0d41) olarak tanımlamak için güncellendi - Araba bağlantı durumunun gözlemlenmesine olanak tanıyan bir API oluşturuldu (Ifc935)
Action
için açma/kapatma düğmesi ayarlama desteği ve kaydırma moduAction
türü (Ica6af) eklendi- Arabada bildirim göndermeyi desteklemek için
CarNotificationManager
oluşturuldu (I10d7a) - Ana makineden (I8690e) liste sınırları sağladığı için
ConstraintManager
eklendi NavigationTemplate
uygulamasına kaydırma modu ve harita işlemi şeridi API'si eklendi (I77aa6)- Gezinme uygulamaları için
SurfaceCallback
uygulamasına kaydırma ve yakınlaştırma API'si eklendi (Id5e9d) CarAppApiLevel
, 2 olarak güncellendi (Ic1540)CarAppService
(I5421e) cihazından izin isteme olanağı eklendi- Çok metinli API'ye
RequiresCarApi(2)
ek açıklaması eklendi (Iacb62) - Yarım liste şablon başlığında birden fazla metin varyantına izin veriliyor (Ib8df7)
- Yeni
LongMessageTemplate
eklendi (Car API düzey 2 gerekir) (Ic5cee)
Hata Düzeltmeleri
- Resim boyutu şartları, daha büyük araba ekranlarını kapsayacak şekilde güncellendi (I116dc)
- Şablon gövdelerine 2'den fazla işlem eklenmesine izin verilmiyor (I32157)
- Araba uygulama kitaplığında tüm
PendingIntent
oluşturma işlemlerinin bayrakların ayarlanmasını sağladık. (If84fe, b/186394900) - Yenileme sırasında
Row
metni değişikliğine izin vermek için javadoc güncellendi (If3f9c) androidx.activity:activity:1.2.0
artık bir API bağımlılığı (Id1cb9)SignInTemplate
veLongMessageTemplate
, gövdelerinde yalnızca park halindeyken işlem yapılmasını zorunlu kılacak şekilde ayarlandı ve dokümanları yalnızca araba park edildiğinde gösterileceklerini belirtecek şekilde güncelledi (Iddaa9)- Başlatma sırasında
Screen
başlatılırken oluşan bir istisna düzeltildi (Ifcf40, b/184664896) ForegroundCarColorSpan
içinde izin verilen özel metin rengi (I69e59)Screen
öğesininON_DESTROY
öğesinden sonraSession
öğesindeON_DESTROY
gözlemlenmesiyle ilgili sorun düzeltildi (I52e01, b/183696617)TravelEstimate
için kalan süre bilinmeyen bir zamana ayarlandığında javadoc'un güncellenmesine izin verilir. (I99610, b/183632456)- Başlıkta ve herhangi bir özel arka plan renginde (I578e4)
ForegroundColorSpan
öğesini desteklemek içinAction
güncellendi - Yürütücü yürütülmeden önce geri çağırma temizlenirse
NavigationManagerCallback#onStopNavigation
öğesini yürütmeyin (I7fc5e, b/181143772) - Uygulamanın açıkça yaşam döngüsü-common-java8 (I8b8c8) bağımlılığı almasını gerektiren bir sorun düzeltildi
Bilinen Sorunlar
- Kullanıcı, girişi onaylamak istediğinde,
SignInTemplate
ekranında dokunmatik klavyede "enter" simgesi yerine bir "ara" simgesi gösterilir. Geçici bir çözüm olarak kullanıcılar, giriş alanı odaktayken etkinleştirilen telefon klavyesine erişebilir. - Android Auto sürüm 6.5'te,
SurfaceCallback
ürünündeki kaydırma ve yakınlaştırma geri çağırmaları bazı dokunma hareketleri için yanlış bir şekilde çağrılabilir.
Araba Uygulaması Test Sürümü 1.0.0
Sürüm 1.0.0-alpha01
24 Mart 2021
androidx.car.app:app-testing:1.0.0-alpha01
yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
Bu, daha önce kapalı kaynak test kitaplığının ilk Jetpack sürümüdür. Bu kitaplığı testlerinizde nasıl kullanacağınızla ilgili olarak örneklerimize bakın.
Yeni Özellikler
- Model sınıflarının denetleyicileri kaldırıldı. Model alıcıları artık, derleyicilerde belirlenen değerlerin doğrulanmasına olanak tanıyan herkese açık API yüzeyinin bir parçasıdır.
- Önceki
CarAppServiceController
, sıcak cihazlarla bağlantının ömrüyle ilgili test mantığı için yeniSessionController
ile değiştirildi.
Sürüm 1.0.0
Sürüm 1.0.0
21 Nisan 2021
androidx.car.app:app:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları içerir.
1.0.0'ın temel özellikleri
- Nisan ayının başlarında uygulamaların
androidx.car.app:app:1.0.0-rc01
kullanarak üretim kanalına yayınlanabileceğini duyurmuştuk. Araba Uygulama Kitaplığı 1.0.0 sürümü kararlı durumda olup Android Auto 6.1 ve sonraki sürümlerle tamamen uyumludur. - Kitaplığı kullanarak Android Auto için navigasyon, park etme ve şarj uygulamaları oluşturma ile ilgili ayrıntıları geliştirme kılavuzunda bulabilirsiniz.
Hata Düzeltmeleri
- Başlatma sırasında
Screen
başlatılırken oluşan bir istisna düzeltildi (70aae1, b/184664896) Screen
öğesininON_DESTROY
öğesinden (0ceecb, b/183696617) sonraSession
öğesindeON_DESTROY
görünmesiyle ilgili sorun giderildi
Sürüm 1.0.0-rc01
24 Mart 2021
androidx.car.app:app:1.0.0-rc01
yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
- Geri çağırma temizlendikten sonra
NavigationManagerCallback#onStopNavigation
çağrılmasına neden olan bir yarış durumu hatası düzeltildi. Bu durum, geri çağırma yürütücüsü çalıştırılmadan önce geri çağırmanın temizlenmesi durumunda gerçekleşmiştir (I7fc5e, b/181143772) - Uygulamanın açıkça
lifecycle-common-java8
ürününe (I8b8c8) bağımlı olmasını gerektiren bir sorun düzeltildi - Uygulama bir geri çağırmayı (Ib8b89, b/181143772) kaldırmış olmasına rağmen bir
stopNavigation
çağrısı aldığında oluşturulanNullPointerException
sorunu giderildi - Kullanım ömrü en azından
CREATED
durumunda değilse, çağrıları uygulamaya göndermemeyle ilgili iyileştirmeler (I86965, b/179800224, b/177921120) - Uygulamanın manifest dosyasında belirtilen geçersiz bir min API'sinin, ana makinede ANR'ye neden olarak tetiklenmesine neden olan sorun düzeltildi. (Iffedd, b/174231592)
Sürüm 1.0.0-beta01
24 Şubat 2021
androidx.car.app:app:1.0.0-beta01
yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
Bu, önceden kapalı kaynak kitaplığın ilk Jetpack sürümüdür ve Android Auto 6.1 veya sonraki sürümlerle uyumludur. Kitaplığı kullanarak araba uygulamaları oluşturmayla ilgili ayrıntılar için geliştirme kılavuzundaki talimatları uygulayın.
Yeni Özellikler
- Uygulamanızın, kullanıcı arayüzü öğelerinin listesini ızgara düzeninde göstermek için kullanabileceği bir
GridTemplate
kullanıma sunuldu. - Ana makine bağlantısının güvenilir bir kaynaktan (örneğin, Android Auto) olduğunu doğrulamak için bir
CarAppService.createHostValidator
yöntemi kullanıma sunuldu. CarAppExtender.Builder.setColor
API'si eklendi. (b/174231592)
Hata Düzeltmeleri
- Ekranlar sırayla açılırken yanlış
Screen
öğesinin devam ettirilmesine neden olan sorun düzeltildi. (b/177590791)