Bu sayfa, Cloud Translation API ile çevrilmiştir.

Araba Uygulaması

API Referansı
androidx.car.app
androidx.car.app.model
androidx.car.app.navigation
androidx.car.app.notification
androidx.car.app.serialization
androidx.car.app.validation

androidx.car.app.version

Android Auto ve Android Automotive OS için şablonlu uygulamalar oluşturma

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.

Yeni sayı oluşturma

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 ve PlaceListNavigationTemplate öğelerini kullanımdan kaldırın ve yeni MapWithContentTemplate (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 etiketi MapWithContentTemplate öğ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çinde Header desteği ekleyin, headerAction, headerTitle, actionStrip (I7ae01) öğelerini kullanımdan kaldırın
GridTemplate ürününde title, headerAction, actionStrip uygulamalarını kullanımdan kaldırın ve Header (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çin GridItem yöntemler. (Id71eb)
PaneTemplate ürününde title, headerAction, actionStrip hizmetlerini kullanımdan kaldırın, yeni Header desteği ekleyin (I23154)
BroadcastReceiver olan Medya Merkezi telemetrisi, Özel İşleme Göz At olarak değiştirildi. (I4185f)
MessageTemplate için Header özelliği desteği eklendi. ActionStrip, headerAction ve title 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çin ListTemplate 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çin ListTemplate 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ına android.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 ekleyin
GridTemplate için, göreli küçük, orta ve büyük gruplara göre ızgara öğesi boyutlandırmasını kontrol eden ItemSize ö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 ekleyerek GridItem 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 ve CarMessage için equals() ve hashCode() 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ın
ConversationItem 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 ve MapTemplate bölgelerinde harita tabanlı bir seçim ekranında olsa bile kayan gezinme çubuğu gösterilmeye devam eder. Bunun için navigasyon bilgilerini NavigationManager.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çin setOnClickListenerAllowed() kısıtlaması ekleyin. Action öğesinin standart simge türleri dışındaki işlemlere OnClickDelegate() ayarlanmasına izin verdiği yerler. (TYPE_APP_ICON, TYPE_BACK ve TYPE_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 yeni Alert API'si (I163a7, I5ad70)
API Düzeyi 5: Şablonlar arasında yeniden kullanımı kolaylaştırmak için yeni Header ve MapController bileşenleri (If5826)
Önemli yer uygulamalarını etkinleştirmek için androidx.car.app.category.POI kategorisi eklendi (ve androidx.car.app.category.PARKING ile androidx.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 yeni onClick yöntemi (Ia9777)
API Düzeyi 5: Action öğelerini tanımlamak için yeni Action.FLAG_IS_PERSISTENT ve Action.FLAG_DEFAULT işaretleri (I96318, I5ad70)
API Düzeyi 5: Action, Row ve Toggle 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 ve setHeaderAction yöntemlerini (I30e6a) kullanımdan kaldırarak PlaceListNavigationTemplate.Builder ve RoutePreviewNavigationTemplate.Builder'da setHeader aracılığıyla yeni Header bileşenini tercih edin
API Düzeyi 5: Yeni OnContentRefreshListner arayüzünün uygulamalarıyla kullanım için PlaceListMapTemplate.Builder ve PlaceListNavigationTemplate.Builder ile ilgili yeni setOnContentRefreshListner yöntemi.
API Düzeyi 5: Seyahat tahmini kartını özelleştirmek için TravelEstimate.Builder'da yeni setTripText ve setTripIcon (Idcc6d, Ic620d)
PaneTemplate başlığında (Ia1ee0) CarIconSpan için destek ekleyin
Row adlı videonun başlık ve metnine CarIconSpan 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 ve SignInTemplate (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 yerine STATUS_UNKNOWN kullanacak şekilde güncelleyin (Ic9444)
Yüzey oluşturmadan önce ekranın var olup olmadığını kontrol edin (Ice027a)
STATUS_UNIMPLEMENTED (I24451) ile ilgili CarValue.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 ve RoutePreviewNavigateTemplate içindeki ActionStrip haritaları sonraki Android Auto ve Android 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 bir toString() 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çinde CarIcon 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 ve RoutePreviewNavigationTemplate 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

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 ve LongMessageTemplate
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: CarHardwareManagerModel 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) alan ScreenController 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 varsa CarNotificationManager.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 bir Desktop 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 ve ScreenController yaşam döngüsü yöntemleri tek bir moveToState 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 ve ScreenController güncellendi (Iabf22)
PinSignInMethod.Builder ve ProviderSignInMethod.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 yerine PinSignInMethod.getPinCode (I996ce) ile değiştirildi
OnInputCompletedListener kaldırıldı (InputCallback ile değiştirildi). (Ib5be1)
PinSignInMethod, String yerine CharSequence olarak değiştirildi (I275d5)

Hata Düzeltmeleri

Araba donanımı için Javadoc düzeltmeleri. (I2abbc)

Harici Katkı

Bilinen Sorunlar

SignInTemplate içinde InputSignInMethod kullanılması, araba ana makinesinde NullPointerException 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 ve LongMessageTemplate.
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ı ve OnRequestPermissionsCallback -> 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ı cihaza ActionStrip desteği eklendi (Ida657)
setLoading, MessageTemplate koleksiyonuna eklendi. (I2a4b5)
ConnectionToCar, CarConnection (Ife9bd) olarak yeniden adlandırıldı
NavigationTemplate, açık bir PanModeDelegate (I13877) döndürecek şekilde değiştirildi
CarContext.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 modu Action 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 ve LongMessageTemplate, 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 öğesinin ON_DESTROY öğesinden sonra Session öğesinde ON_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çin Action 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.