Araba Uygulaması
Son Güncelleme | Kararlı Sürüm | Yayın Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
26 Haziran 2024 | 1.4.0 | - | 1.7.0-beta01 | - |
Bağımlılıkları bildirme
Araba Uygulaması Kitaplığı'na bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanız veya modülünün build.gradle
dosyasına ihtiyaç duyduğunuz yapılar için bağımlılıkları ekleyin:
Eski
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") }
Bağımlılıklar hakkında daha fazla bilgi edinmek için Derleme bağımlılıkları ekleme bölümüne bakın.
Geri bildirim
Geri bildiriminiz Jetpack'i iyileştirmemize yardımcı olacaktır. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici dokümanlarına bakın.
Sürüm 1.7
Sürüm 1.7.0-beta01
26 Haziran 2024
androidx.car.app:app-*:1.7.0-beta01
yayınlandı. Sürüm 1.7.0-beta01 bu kayıtları içerir. Özellikler, alfa01'de yayınlanan özelliklerle aynıdır ve aşağıda tekrarlanmaktadır:
Yeni Özellikler
- İçerik İçeren Eşleme: Yeni şablon, Harita Tuvali ve içerik şablonu (şimdilik Liste / Izgara / Bölme / İleti olabilir).
RoutePreview
,PlaceListNavigation
,MapTemplate
desteği sonlandırıldı. Şablonlar olduğu gibi çalışmaya devam eder.- Örnek uygulamalar, desteği sonlandırılmış şablonlar yerine
MapWithContent
kullanımını gösterecek şekilde güncellendi
- İleti dizisi öğesi: Araçta konuşmaları (IM, SMS) ve Asistan sesli okumasını görüntülemek için yeni API'ler.
- Araç Boyutları: Araç ölçümlerini almak için yeni API (şu anda AAOS ile ilgili veriler).
API Değişiklikleri
MediaPlaybackTemplate.Builder
adlı kampanyaya@ExperimentalCarApi
etiketi ekleyin. (Ic1957)- Deneme modunda yeni bir
SectionedItemTemplate
ekler. (I5958a) CarAppApiLevel 8
(I3fa22) ile tanışın- Araba Uygulama Kitaplığı'nda medya oynatma sırasında içeriği görüntülemek için
MediaPlaybackTemplate
ekler. (I3c10d) - Sürüş sırasında sistemin arka plan sesini destekleyip desteklemediğini algılamak için uygulamalara yeni bir API eklendi (I0f868)
Hata Düzeltmeleri
- CAL istemci kodu ve CAL Gezinme Örnek Uygulaması'ndaki belirli bellek sızıntısı ve kilitlenme örneklerini düzeltir. (I55e04)
- Kilitlenmeleri önlemek için
BaseCarAppActivity
uygulamasınınonDestroy
yöntemindekirequireNotNull instances
değerini if-null kontrolleriyle değiştirin. (Iec676)
Sürüm 1.7.0-alpha02
17 Nisan 2024
androidx.car.app:app-*:1.7.0-alpha02
yayınlandı. Sürüm 1.7.0-alpha02 bu kaydetmeleri içerir.
Yeni Özellikler
- Harita tabanlı şablonlar için
MapWithContent
şablonunun ileride destekleyeceği kullanımdan kaldırılan işaretler eklendi.
API Değişiklikleri
- Eski
MapTemplate
,RoutePreviewNavigationTemplate
,PlaceListNavigationTemplate
desteğini sonlandı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 oluşturma şemamızı, etkin CarApi sürümüyle eşleşecek şekilde taşıdık. Bunun amacı, geliştirici geri bildirimlerine dayalı olarak adlandırma düzenindeki karışıklığı azaltmak içindir. Bu nedenle, 1.5 / 1.6 sürümleri atlayarak doğrudan bu kaydetmeleri içeren 1.7.0-alpha01 sürümü olan 1.7 sürümüne geçeceğiz.
Yeni Özellikler
- İçerik İçeren Eşleme: Harita içinde İçerik olarak Liste / Izgara / Bölme / İleti özelliğini destekleyen
MapWithContent
adlı yeni şablon.RoutePreview
,PlaceListNavigation
, Harita şablonları kullanımdan kaldırıldı.- Örnek uygulamalar,
MapWithContent
kullanılarak kullanımdan kaldırılan şablonların işlevlerini gösterecek şekilde güncellendi.
- İleti dizisi öğesi: Araçta konuşmaları (IM, SMS) ve Asistan sesli okumasını görüntülemek için yeni API'ler.
- Araç Boyutları: Araç ölçümlerini almak için yeni API (şu anda AAOS ile ilgili veriler).
API Değişiklikleri
- Ekstra küçük satırlı resim türünü deneme olarak işaretleme (I5184b)
- Yükseklik, genişlik vb. gibi dış boyut bilgilerine (Ia40c5) erişim sağlayan
CarInfo#fetchExteriorDimensions
API eklendi ExperimentalAPI
etiketiMapWithContentTemplate
adlı reklamdan (I66db8) kaldırıldıGridItem#setTitle
parametresini boş değer olacak şekilde güncelleyin. (I3d610)GetHeader
API, geriye dönük uyumlu olduğundan API 7 gerektirmez (I8c812)ListTemplate
ürünündeHeader
desteği ekleyin,headerAction
,headerTitle
,actionStrip
öğelerini kullanımdan kaldırın (I7ae01)GridTemplate
içindetitle
,headerAction
,actionStrip
desteğini sonlandırın veHeader
(I41a9c) için destek ekleyin- Deneysel API'ler için 7. seviye şartını kaldırın: Rozet,
GridTemplate
öğe boyutu ve resim şekli belirleyiciler/belirleyiciler, Rozet almak/ayarlamak içinGridItem
yöntem. (Id71eb) PaneTemplate
içindetitle
,headerAction
,actionStrip
desteğini sonlandırın, yeniHeader
desteği ekleyin (I23154)BroadcastReceiver
olan Media Center telemetri verileri Özel İşleme Göz At olarak değiştirildi. (I4185f)MessageTemplate
ürününeHeader
özellik desteği eklendi.ActionStrip
,headerAction
vetitle
için destek 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ına ana kullanıcı arayüzü parametreleri (I85ca2) hakkında bilgi vermek için ekstralar ekleyin
MediaExtensions
ürününe medya merkezi analizi özelliği ekleme (I7ce28)- Satırlarda ekstra küçük resim seçeneği eklendi. (I72c03)
Hata Düzeltmeleri
ConversationItem
üzerinde Javadoc'u güncelleyerek mesajların en eskiden en yeniye doğru sıralanacağını belirtin. (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
29 Mayıs 2024
androidx.car.app:app-*:1.4.0
yayınlandı. Sürüm 1.4.0, 1.4.0-rc02 promosyonudır.
1.3.0'dan bu yana önemli değişiklikler
- Navigasyon uygulamaları için Araç Kümesi harita oluşturma
- İyileştirilmiş uygulama düzeni / kullanılabilirliği için Yeni Sekme Şablonu
- Uyarlanabilir görev sınırları desteği
- Liste öğelerinde ikincil işlemler
Sürüm 1.4.0-rc02
13 Aralık 2023
androidx.car.app:app-*:1.4.0-rc02
yayınlandı. Sürüm 1.4.0-rc02 bu kaydetmeleri içerir. Yalnızca küçük düzeltmeler
Hata Düzeltmeleri
ConversationItem
üzerinde Javadoc'u, mesajların en eskiden en yeniye doğru sıralanacağını 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
herhangi bir önemli değişiklik yapılmadan yayınlandı. Sürüm 1.4.0-rc01 bu kaydetmeleri içerir.
Sürüm 1.4.0-beta02
20 Eylül 2023
androidx.car.app:app-*:1.4.0-beta02
yayınlandı. Sürüm 1.4.0-beta02 bu kaydetmeleri içerir. Bu, beta01 ile neredeyse aynıdır ancak compileSdk
gereksinimini 33'e düşürür.
Hata Düzeltmeleri
- Sekmelerdeki yükleme ekranlarının düzgün şekilde 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ı. Sürüm 1.4.0-beta01 bu kaydetmeleri içerir.
Not: 1.4-beta01 için buildSdk34 gerekir. Bu da hâlâ geliştirici durumundadır. 1.4-beta02 bu sorunu düzeltecektir. Dilerseniz uyarıyı geçici olarak engellemek için projenizin
settings.gradle
dosyasınaandroid.suppressUnsupportedCompileSdk=34
öğesini ekleyebilirsiniz.
Yeni Özellikler
- Navigasyon uygulamaları için küme harita oluşturma aracı
- İyileştirilmiş 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'ye bakın
Sürüm 1.4.0-alpha02
26 Temmuz 2023
androidx.car.app:app-*:1.4.0-alpha02
yayınlandı. 1.4.0-alpha02 sürümü bu kaydetmeleri içerir.
- Alpha02 sürümü, yakında yayınlanacak olan beta01 sürümüne hazırlık olarak tasarlanmıştır.
Yeni Özellikler
- Navigasyon uygulamaları için Gösterge Kümesi desteğinde harita oluşturma
- Düzen deneyimini iyileştirmek için uygulamalara Sekmeler eklendi
- Eklenen Liste / Izgara şablonu oluşturma seçenekleri
- Hava Durumu ve İletişim için yeni kategoriler eklendi
- Birden fazla API'yi bir sonraki CarApi 7 sürümüne taşıma
API Değişiklikleri
CarMessage
ürününe multimedya alanları ekleyin (I5aaf6)- Araba Uygulaması Kitaplığı'nda (Ie5ed6)
ConversationItem
için özel işlemler ekler - Bir medya öğesinin sürükleyici bir ses biçimiyle oynatıldığını belirtmek ve içerik biçimi logosunu (Icb5bb) göstermek için ekstra özellikler ekleyin
- Oluştur düğmesini desteklemek için yeni işlem türü olan
ActionsConstraints
API'yi ekleyin. (I31661) set/getTemplate
,set/get ContentTemplate
(Ica036) olarak yapıldı- Şablon parametresi artık
@NonNull
olur.MapWithContentTemplate
API dokümanları güncellendi (I0f8ed) - CAL 1.4'te (I2cfcb) başlatma için
ListTemplate
uygulamasındaki İşlemlere ait@ExperimentalCarApi
etiketini kaldırır TabTemplate
(Ifcb82) için@ExperimentalCarApi
etiketini kaldırır- Satır ikincil işlemlerinden ve süslemelerinden (I8487e)
@ExperimentalCarApi
ek açıklamalarını kaldır TabTemplate
öğesine etkin sekme Content ID ekler ve Sekmeler'deki etkin durumu kullanımdan kaldırır (I96932)ItemImageShape
özelliğiniGridTemplate
(Ibf431) için ekleyinGridTemplate
öğesine göreceli 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 (I2be44) hava durumu uygulamaları için kategori ekler
- Araba Uygulaması Kitaplığı'na çağrı uygulamaları için kategori ekler (Icab33)
GridItem.Builder#setBadge()
, aşırı yüklenmişsetImage()
yöntemleriyle değiştirildi (Id2000)- Rozete simge özelliği ekleme (I629b2)
- Nokta rozeti arka plan rengini ayarlama yöntemi ekleme (I6411c)
GridItem
ürününe Rozet özelliği ekleyerekGridItem
resminin üstünde rozet gösterin. (I95de7)- Resim üzerinde gösterilecek 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ı. 1.4.0-alpha01 sürümü bu kaydetmeleri içerir.
API Değişiklikleri
- Araba Uygulaması Kitaplığı'nda (Id0191)
GridTemplate
öğesine üst düzey işlemler ekler - Araba Uygulaması Kitaplığı'nda (I9efab)
ListTemplate
için üst düzey işlemler ekler - Bir medya öğesinin altyazısını veya açıklamasını diğer medya öğelerine bağlamak için ekstralar ekleme (Ic84bf)
- Satır işlemleri için API düzeyini 6. düzey olarak güncelleyin. (Ie0a69)
- A4C'ye mesajlaşma geri çağırması ekleme (Ie3986)
Hata Düzeltmeleri
CarMessage
için eksik Java dokümanı referanslarını ekleyin. (I5db1c)ConversationItem
veCarMessage
(I6fd10) içinequals()
vehashCode()
değerlerini geçersiz kılConversationItem.mMessages
doğrulamasını iyileştirin (boş olmayan, boş olmayan zorunlu kılın (Iafc51)ConversationItem
alanlarına@Keep
ek açıklamaları ekleyin (I5d250)- Satır dekorasyonu 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ı. Sürüm 1.3.0-rc01 bu kaydetmeleri içerir.
- Beta01 sürümünde 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
serbest bırakıldı. Sürüm 1.3.0-beta01 bu kaydetmeleri 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ılavuzumuza bakın). API düzeyi 5 ve altındaki ek açıklamalı özellikler, hem Android Auto 8.1 ve sonraki sürümler hem de Google Automotive App Host 1.4 ve sonraki sürümler ile uyumludur.
Yeni Özellikler
Araba Uygulama Kitaplığı 1.3.0-alpha01'de eklenen özelliklere ek olarak aşağıdaki özellikler de beta01 kapsamında eklenmiştir (Buradaki tüm özellikler yalnızca API değişikliği olmadan ana makine tarafında yapılan değişikliklerle ilişkilidir):
- Kullanıcı
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
veMapTemplate
alanlarındaki harita tabanlı seçim ekranında olsa bile kayan gezinme çubuğu gösterilmeye devam edecek. Bunun için navigasyon bilgileriniNavigationManager.updateTrip()
üzerinden güncelleyebilirsiniz. - Zaman aşımı animasyonu için
FLAG_DEFAULT
ile işlem düğmesini etkinleştirin. Bu düğme, zaman aşımı süresi dolduktan sonra varsayılan olarak tıklanır. ([API 5 - All Templates]
) Row
alt metni, araba park hâlindeyken kısaltılmaz, sürüş sırasında 2 satıra kısaltılır. ([API 5 - All Templates]
)Action
,Toggle
,Row
([API 5 - All Templates]
) için destek devre dışı bırakıldı durumu
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
ürününün, standart simge türleri dışındaki işlemler içinOnClickDelegate()
değerini ayarlamasına izin verdiği yerde. (TYPE_APP_ICON
,TYPE_BACK
veTYPE_PAN
) (I3c745)
Hata Düzeltmeleri
- Android Automotive Template Host 1.4+ sürümünün kavisli ekranlarla 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
serbest bırakıldı. 1.3.0-alpha01 sürümü bu kaydetmeleri içerir.
API düzeyi 5 ek açıklaması olan özellikler, Android Auto 7.9 ve sonraki sürümleriyle uyumludur.
Yeni Özellikler
- API Düzeyi 5: Gezinme uygulamaları tarafından bölmeyi görüntülemek veya haritayla birlikte içeriği listelemek için kullanılabilecek yeni
MapTemplate
(If5826, If44b8) - API Düzeyi 5: Ana aracın mikrofonu (I5e71a) aracılığıyla ses girişi kaydı yapılmasını sağlayan yeni
CarAudioRecord
API - API Düzeyi 5: Uygulamaların ana makineye öneri sağlamasına izin vermek için yeni
SuggestionManager
API (I5c103) - API Düzeyi 5:
NavigationTemplate
üzerindeki 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) androidx.car.app.category.POI
, ÖY uygulamalarını etkinleştirmek için bir kategori olarak eklendi (ve kullanımdan kaldırılanandroidx.car.app.category.PARKING
veandroidx.car.app.category.CHARGING
) (I59da1)
API Değişiklikleri
- API Düzeyi 5: Harita etkileşimine dokunmaya olanak tanıyan
SurfaceCallback
arayüzünde yenionClick
yöntemi (Ia9777) - API Düzeyi 5:
Action
öğelerini açıklamak için yeni işaretlerAction.FLAG_IS_PERSISTENT
veAction.FLAG_DEFAULT
(I96318, I5ad70) - API Düzeyi 5:
Action
,Row
veToggle
bileşenleri için yeni etkin/devre dışı durum (kitaplığın 1.3.0-beta01 sürümünde ana makine desteği kullanıma sunuluyor) (Id8a09) - API Düzeyi 5:
PlaceListNavigationTemplate.Builder
veRoutePreviewNavigationTemplate.Builder
üzerindesetHeader
üzerinden yeniHeader
bileşenine öncelik verin ve mevcutsetTitle
vesetHeaderAction
yöntemlerini (I30e6a) kullanımdan kaldırın - API Düzeyi 5:
PlaceListMapTemplate.Builder
vePlaceListNavigationTemplate.Builder
üzerinde, yeniOnContentRefreshListner
arayüzünün uygulamalarında kullanım için yenisetOnContentRefreshListner
yöntemi. - API Düzeyi 5: Seyahat tahmini kartını özelleştirmek için
TravelEstimate.Builder
üzerinde yenisetTripText
vesetTripIcon
(Idcc6d, Ic620d) PaneTemplate
başlığınaCarIconSpan
desteği ekleyin (Ia1ee0)Row
öğesinin başlık ve metnindeCarIconSpan
desteği ekleyin (Ic1e3c)ActionStrip
haritalarında artık dört işlem yapılabilir (If3522)- Car App API düzeyini 5 olarak güncelleyin (I26b8e)
- Başlıklar artık
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
veSignInTemplate
(I2078d, Icadde) için isteğe bağlı.
Hata Düzeltmeleri
PaneTemplate
görüntü boyutlandırma kuralı, kare sınırlayıcı kutu (Idd72e) olacak şekilde güncellendi- Ekran yığını
State.DESTROYED
tarihinden sonra değiştirilirse ortaya çıkan bir istisna düzeltildi. (I3c8eb) - Uygulama simgesi almak için boş bir kontrol 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
ile ilgiliCarValue.equals()
hatasını düzeltin (I24451)
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 kaydetmeleri içerir.
- Bu bir sabitleme sürümüdür ve 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ı. Sürüm 1.2.0-rc01 bu kaydetmeleri içerir.
- Bu bir sabitleme sürümüdür ve
v1.2.0-beta02
ile kıyaslandığında 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
- Ekran yığını
State.DESTROYED
tarihinden sonra değiştirilirse ortaya çıkan bir istisna düzeltildi. (I3c8eb) CarSensors
API, AAOS (Idd57b) için uygulanmadığını belirtecek şekilde güncellendiPlaceListMapTempalte.Builder#setCurrentLocationEnabled
, ACCESS_COARSE_LOCATION alanının özellik için yeterli olacağını belirtecek şekilde güncellendi (I510c2)- Açılı döner kavşak manevra türleri için çıkış numarası isteğe bağlı yapıldı (Ife7d1)
Sürüm 1.2.0-beta02
26 Ocak 2022
androidx.car.app:app-*:1.2.0-beta02
yayınlandı. Sürüm 1.2.0-beta02 bu kaydetmeleri içerir.
Bu kitaplık sürümü ile oluşturulmuş Android Automotive OS
platformunu hedefleyen 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ındaki ek açıklamalı ö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 makinesinin bağlantısı kaldırıldığında
CarAppService
cihazındaki bellek sızıntısı düzeltildi. (I5c9ca, b/203594731) CarAppActivity
Javadoc dosyası, singleTask launchmode (Id2f95) gereksinimlerini içerecek şekilde güncellendi- Devam ettirme sırasındaki görsel arızayı azaltır. (Iff7e0)
Bilinen Sorunlar
PlaceListNavigationTemplate
veRoutePreviewNavigateTemplate
içindekiActionStrip
haritaları sonrakiAndroid Auto
veAndroid Automotive OS
sürümlerinde kullanıma sunulmaya başlayacak.
Sürüm 1.2.0-alpha02
15 Aralık 2021
androidx.car.app:app-*:1.2.0-alpha02
yayınlandı. 1.2.0-alpha02 sürümü bu kaydetmeleri içerir.
PlaceListNavigationTemplate
ve RoutePreviewNavigateTemplate
içinde harita ActionStrip
, Pane
dilindeki CarIcon
resmi, QRCodeSignInMethod
ve Action
içinde oluşturma ipuçlarını (ör. işaretler) ayarlama yeteneği dahil olmak üzere API düzeyi 4 ile ek açıklama eklenen özellikler, deneysel sürümden 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 yükseltildi.
API Değişiklikleri
CarUnit
ürününe deneysel birtoString()
yöntemi eklendi(I36a3b)
Hata Düzeltmeleri
- Geri çağırma sona ererse
CarAppPermissionActivity
içinde gerçekleşen kilitlenme düzeltildi (If9823) Pane
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 kaydetmeleri içerir.
Tüm yeni v1.2.0
özellikleri (API 4+), şu anda gelecekteki Android Auto ve Android Automotive OS sürümlerini hedeflemek için deneysel aşamadadır. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API Değişiklikleri
AutomotiveCarInfo
API deneysel hale getirildi. (Ia13e5)- Car App Library API düzey 4 eklendi (I2a2e7)
- API Düzeyi 4:
Pane
ürünündeCarIcon
ayarı için destek eklendi (Ifcc12) - API Düzeyi 4: QR koduyla oturum açma yöntemi eklendi (Ib623e)
- API Düzeyi 4: set/getFlags öğeleri
Action
(Ic03ab) sürümüne eklendi - API Düzeyi 4:
PlaceListNavigationTemplate
veRoutePreviewNavigationTemplate
uygulamalarında kaydırma ve yakınlaştırma desteği eklendi (I9d8a3)
Hata Düzeltmeleri
- API Düzeyi 4: Uygulamaların, konum güncellemelerini araç ana makinesine göndermesine izin vermek için mekanizma ekleyin (I3bad3)
- Ana makine doğrulama mantığının TEMPLATE_RENDERER iznini düzgün bir şekilde bulamamasına neden olan sorunu düzeltin (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 kaydetmeleri 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. Ayrıca, araba uygulama kitaplığındaki yeni özellikler hakkında daha fazla bilgi için v1.2.0-alpha02
sürüm notlarına bakabilirsiniz.
1.0.0'dan bu yana önemli değişiklikler
- API Düzeyi 2: Araç park hâlindeyken oturum açma akışları için kullanılabilecek
SignInTemplate
veLongMessageTemplate
- API Düzeyi 2:
NavigationTemplate
içinde harita etkileşim desteği - API Düzeyi 2: Uygulamaların, araç ekran boyutlarına bağlı olarak gösterilecek dizenin birden fazla sürümünü sağlamasına izin vermek için çok uzunluklu metin desteği.
- API Düzeyi 3:
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ı. Sürüm 1.1.0-rc01 bu kaydetmeleri içerir.
Bu bir sabitleme sürümüdür ve v1.1.0-beta01
ile kıyaslandığında API değişikliği yoktur. Gelecekteki Android Auto sürümleri için tasarlanmış yeni deneysel özellikler (API düzeyi 4) eklendi. Deneysel API'ler hakkında daha fazla bilgi için v1.2.0-alpha01
sürüm notlarına bakın.
Sürüm 1.1.0-beta01
1 Eylül 2021
androidx.car.app:app-*:1.1.0-beta01
yayınlandı. Sürüm 1.1.0-beta01 bu kaydetmeleri içerir.
Tüm v1.1.0
özellikleri (API 2+), Android Auto 6.7 ve sonraki sürümleriyle 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 olanağı eklendi (I74b76)
ScreenManager.getStackSize
eklendi (I0b16a)- Uygunsuz olarak
TestCarContext
alanScreenController
oluşturucu kaldırıldı (Iefebc)
Hata Düzeltmeleri
CarHardwareManager
oluşturulurken API düzeyi kontrolü eklendi (I48f9b)- API genelinde geçersiz
CarSpan
kullanımı için kontroller eklendi (I65ae6) - Bir
Screen
, oluşturma işlemi sırasında tamamlandı olarak işaretlenirse yığının bozuk durumda (I81b13) bırakılmasına neden olan sorun düzeltildi CarAppExtender
içindeki (I3633d) simgeler içeren işlemler varsaCarNotificationManager.notify
ürününün AutomotiveOS için hata günlüğe kaydetmesine neden olan sorun düzeltildi- 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ı. 1.1.0-alpha02 sürümü bu kaydetmeleri içerir.
Yeni Özellikler
- API Seviyesi 3: Aracın model ve marka, yakıt seviyeleri ve diğer sensörler gibi donanım verilerini sorgulamak için kullanılabilecek bir
CarHardwareManager
eklendi. Bu özellik şu anda yalnızca açık test kanalındaki Android Auto 6.7 ve sonraki sürümlerde kullanılabilir. Bunun bir masaüstü ortamında test edilmesi, ayrı olarak yayınlanacak yeni birDesktop Head Unit
sürümü gerektirir. 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 araba ana makinelerinde nasıl kullanılacağına ilişkin ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzuna ve kitaplık referansına başvurun.
API Değişiklikleri
SessionController
veScreenController
yaşam döngüsü yöntemleri tek birmoveToState
yönteminde (I1ed00) birleştirilmiş- Eklenme tarihi:
CarContext#getHostInfo()
(I8977e) - Kullanımdan kaldırılan alanlar kaldırıldı. (I67168)
SessionController
veScreenController
, oluşturucuları doğrudan kullanıma sunacak şekilde güncellendi (Iabf22)PinSignInMethod.Builder
veProviderSignInMethod.Builder
kaldırıldı (I9f0cb)- AAOS'de (I37741) "sonuç için" şablonlu uygulamaların kullanımını etkinleştirmek için "setCarAppResult()" eklendi
@MainThread
ile ek açıklamalıCarHardware
arayüzleri. (Ib2f85)OnCarDataListener
adlı dosyaOnCarDataAvailableListener
olarak yeniden adlandırıldı (I518ca)CarInfo
,Speed
,Mileage
yöntem adları ve javadoc güncellendi. (I86672)Toll
adlı dosyaTollCard
olarak yeniden adlandırıldı. (I3e7c8)- Kullanımdan kaldırılan
PinSignInMethod.getPin
, yeriniPinSignInMethod.getPinCode
(I996ce) aldı OnInputCompletedListener
kaldırıldı (InputCallback
ile değiştirildi). (Ib5be1)PinSignInMethod
,String
yerineCharSequence
alacak şekilde değiştirildi (I275d5)
Hata Düzeltmeleri
- Araba donanımı için Javadoc düzeltmeleri. (I2abbc)
Harici Katkı
Bilinen Sorunlar
SignInTemplate
içindeInputSignInMethod
kullanımı, araba ana makinesindeNullPointerException
oluşması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
serbest bırakıldı. Sürüm 1.1.0-alpha01 bu kaydetmeleri içerir.
Yeni Özellikler
- API Düzeyi 2: Araç park hâlindeyken oturum açma akışları için kullanılabilecek yeni
SignInTemplate
veLongMessageTemplate
. - API Düzeyi 2:
NavigationTemplate
içinde yeni harita etkileşim desteği - API Düzeyi 2: Uygulamaların, araç ekran boyutlarına bağlı olarak gösterilecek dizenin birden fazla sürümünü sağlamasına olanak tanımak için çok uzunluklu yeni metin desteği.
- Bu özelliklerin, API düzeyi 2 ile uyumlu araba ana makinelerinde 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ığını takip edin.
API Değişiklikleri
- Tüm
*Callback
arayüz yöntemleri varsayılan olarak ayarlandı 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, pil ve hız gibi arabaya özel verilere erişim için
androidx.car.app.hardware
sınıf eklendi. (Iff3c9) MessageTemplate
(Ida657) sürümüneActionStrip
desteği eklendisetLoading
,MessageTemplate
koleksiyonuna eklendi. (I2a4b5)ConnectionToCar
adlı dosyaCarConnection
(Ife9bd) olarak yeniden adlandırıldıNavigationTemplate
, açık birPanModeDelegate
(I13877) döndürülecek şekilde değiştirildiCarContext.requestPermissions
(Ib890a) için parametre sırası güncellendi- Minimum araba API düzeyini tanımlamak için meta veri anahtarı
androidx.car.api.minCarApiLevel
(Ib0d41) olarak güncellendi - Araç bağlantı durumunun gözlemlenmesine olanak tanıyan bir API oluşturuldu (Ifc935)
Action
için açma/kapatma düğmesi ayarlama desteği eklendi ve kaydırma moduAction
türü (Ica6af) eklendi.- Arabada bildirim göndermeyi desteklemek için
CarNotificationManager
oluşturuldu (I10d7a) - Ana makineden liste sınırlarını sağlamak için
ConstraintManager
eklendi (I8690e) NavigationTemplate
ürününe (I77aa6) kaydırma modu ve harita işlem şeridi API'si eklendi- Gezinme uygulamaları için
SurfaceCallback
uygulamasına kaydırma ve yakınlaştırma API'si eklendi (Id5e9d) CarAppApiLevel
, 2 (Ic1540) olarak güncellendiCarAppService
cihazından (I5421e) izin isteme özelliği eklendi- Çoklu metin API'sine (Iacb62)
RequiresCarApi(2)
ek açıklaması eklendi - Yarı liste şablon başlığında (Ib8df7) birden fazla metin varyantına izin veriliyor
- Yeni
LongMessageTemplate
eklendi (Car API düzeyi 2 gerekir) (Ic5cee)
Hata Düzeltmeleri
- Resim boyutu gereksinimleri daha büyük araç ekranlarını da hesaba katacak şekilde güncellendi (I116dc)
- Şablon gövdelerine 2'den fazla işlem eklenmesine izin verilmiyor (I32157)
- Araba uygulama kitaplığı grup işaretlerinde her
PendingIntent
öğesinin oluşturulmasını sağlayın. (If84fe, b/186394900) - Javadoc, yenileme sırasında
Row
öğesinin metin değişikliklerine izin verecek şekilde güncellendi (If3f9c) androidx.activity:activity:1.2.0
artık bir API bağımlılığı (Id1cb9)SignInTemplate
veLongMessageTemplate
uygulamalarının gövdesinde yalnızca park halinde işlem yapılmasını gerektirecek şekilde yapılandırıldı ve dokümanların yalnızca araç park edildiğinde (Iddaa9) gösterileceğini belirtecek şekilde güncellendi.- Başlatma sırasında
Screen
açılırken ortaya çıkan istisna düzeltildi (Ifcf40, b/184664896) ForegroundCarColorSpan
ürününde izin verilen özel metin rengi (I69e59)Screen
öğesininON_DESTROY
öğesinden sonraSession
üzerindeON_DESTROY
değerinin gözlemlenmesine neden olan sorun düzeltildi (I52e01, b/183696617)TravelEstimate
öğesinin kalan süresi bilinmeyen bir zamana ayarlanırken Javadoc'un güncellenmesine izin verilir. (I99610, b/183632456)- Başlıkta
ForegroundColorSpan
ve herhangi bir özel arka plan rengini (I578e4) 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, Lifecycle-common-Java8 (I8b8c8) üzerindeki bir bağımlılığı açıkça üstlenmesini gerektiren sorun düzeltildi.
Bilinen Sorunlar
SignInTemplate
seçeneğinde, kullanıcı girişi onaylamak istediğinde dokunmatik klavyede "Enter" simgesi yerine "arama" simgesi gösteriliyor. 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
uygulamasındaki kaydırma ve yakınlaştırma geri çağırmaları bazı dokunma hareketleri için yanlış çağrılabiliyor.
Araba Uygulama Testi 1.0.0 Sürümü
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 kaydetmeleri içerir.
Bu, önceden kapalı kaynak test kitaplığının ilk Jetpack sürümüdür. Testlerinizde bu kitaplığın nasıl kullanılacağıyla ilgili örneklerimize bakın.
Yeni Özellikler
- Model sınıflarının denetleyicileri kaldırıldı. Model alıcılar artık derleyicilerde ayarlanan değerlerin doğrulanmasına olanak tanıyan herkese açık API yüzeyinin bir parçası.
- Önceki
CarAppServiceController
, hotspot bağlantısı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 kaydetmeleri 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
özelliğini kullanarak üretim kanalında yayınlamaya başlayabileceğini duyurmuştuk. Araba Uygulama Kitaplığı 1.0.0 sürümü artık kararlı ve Android Auto 6.1 ve sonraki sürümlerle tamamen uyumludur. - Kitaplığı kullanarak Android Auto için navigasyon, park ve şarj uygulamaları oluşturma hakkında ayrıntılı bilgi edinmek üzere geliştirme kılavuzuna başvurun.
Hata Düzeltmeleri
- Başlatma sırasında bir
Screen
açılırken ortaya çıkan istisna düzeltildi (70aae1, b/184664896) Screen
öğesininON_DESTROY
etiketinden (0ceecb, b/183696617) sonraSession
üzerindekiON_DESTROY
öğesinin gözlemlenmesine neden olan sorun düzeltildi
Sürüm 1.0.0-rc01
24 Mart 2021
androidx.car.app:app:1.0.0-rc01
yayınlandı. Sürüm 1.0.0-rc01 bu kaydetmeleri içerir.
Hata Düzeltmeleri
- Geri çağırma temizlendikten sonra
NavigationManagerCallback#onStopNavigation
işlevinin çağrılmasına neden olan bir yarış durumu hatası düzeltildi. Bu durum, geri arama yürütücü gerçekten çalışmadan önce geri arama giderilmişse meydana gelmiştir (I7fc5e, b/181143772) - Uygulamanın
lifecycle-common-java8
(I8b8c8) üzerindeki bağımlılığı açıkça almasını gerektiren bir sorun düzeltildi. - Uygulama, zaten bir geri çağırmayı kaldırdığında
stopNavigation
çağrısı aldığında ortaya çıkanNullPointerException
sorunu düzeltildi (Ib8b89, b/181143772) - Yaşam döngüsü en az
CREATED
durumunda değilse uygulamanın çağrıların gönderilmemesine yönelik iyileştirmeler (I86965, b/179800224, b/177921120) - Uygulamanın manifest dosyasında geçersiz bir min API belirtilen geçersiz bir min API'nin gönderilmesine neden olarak ana makinede ANR sorunu 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ı. Sürüm 1.0.0-beta01 bu kaydetmeleri içerir.
Bu, önceden kapalı kaynak kitaplığının ilk Jetpack sürümüdür ve Android Auto 6.1 veya sonraki sürümlerle uyumludur. Kitaplığı kullanarak araba uygulamaları oluşturma hakkında ayrıntılı bilgi için geliştirme kılavuzundaki adımları 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 (ör. 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
işlevinin devam ettirilmesine neden olan sorun düzeltildi. (b/177590791)