Araba Uygulaması

Android Auto ve Android Automotive OS için şablonlu uygulamalar oluşturun.
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:

Modern

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.

Yeni sayı oluştur

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 MapWithContentkullanı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ın onDestroy yöntemindeki requireNotNull 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 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 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 etiketi MapWithContentTemplate 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ünde Header desteği ekleyin, headerAction, headerTitle, actionStrip öğelerini kullanımdan kaldırın (I7ae01)
  • GridTemplate içinde title, headerAction, actionStrip desteğini sonlandırın ve Header (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çin GridItem yöntem. (Id71eb)
  • PaneTemplate içinde title, headerAction, actionStrip desteğini sonlandırın, yeni Header desteği ekleyin (I23154)
  • BroadcastReceiver olan Media Center telemetri verileri Özel İşleme Göz At olarak değiştirildi. (I4185f)
  • MessageTemplate ürününe Header özellik desteği eklendi. ActionStrip, headerAction ve title 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çin ListTemplate 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ç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 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ına android.suppressUnsupportedCompileSdk=34 öğesini ekleyebilirsiniz.

Yeni Özellikler

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ğini GridTemplate (Ibf431) için ekleyin
  • GridTemplate öğesine göreceli 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 (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 ekleyerek GridItem 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 ve CarMessage (I6fd10) için equals() ve hashCode() değerlerini geçersiz kıl
  • ConversationItem.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.

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 ve MapTemplate alanlarındaki harita tabanlı seçim ekranında olsa bile kayan gezinme çubuğu gösterilmeye devam edecek. Bunun için navigasyon bilgilerini NavigationManager.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çin setOnClickListenerAllowed() kısıtlaması ekleyin. Action ürününün, standart simge türleri dışındaki işlemler için OnClickDelegate() değerini ayarlamasına izin verdiği yerde. (TYPE_APP_ICON, TYPE_BACK ve TYPE_PAN) (I3c745)

Hata Düzeltmeleri

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 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)
  • androidx.car.app.category.POI, ÖY uygulamalarını etkinleştirmek için bir kategori olarak eklendi (ve kullanımdan kaldırılan androidx.car.app.category.PARKING ve androidx.car.app.category.CHARGING) (I59da1)

API Değişiklikleri

  • API Düzeyi 5: Harita etkileşimine dokunmaya olanak tanıyan SurfaceCallback arayüzünde yeni onClick yöntemi (Ia9777)
  • API Düzeyi 5: Action öğelerini açıklamak için yeni işaretler Action.FLAG_IS_PERSISTENT ve Action.FLAG_DEFAULT (I96318, I5ad70)
  • API Düzeyi 5: Action, Row ve Toggle 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 ve RoutePreviewNavigationTemplate.Builder üzerinde setHeader üzerinden yeni Header bileşenine öncelik verin ve mevcut setTitle ve setHeaderAction yöntemlerini (I30e6a) kullanımdan kaldırın
  • API Düzeyi 5: PlaceListMapTemplate.Builder ve PlaceListNavigationTemplate.Builder üzerinde, yeni OnContentRefreshListner arayüzünün uygulamalarında kullanım için yeni setOnContentRefreshListner yöntemi.
  • API Düzeyi 5: Seyahat tahmini kartını özelleştirmek için TravelEstimate.Builder üzerinde yeni setTripText ve setTripIcon (Idcc6d, Ic620d)
  • PaneTemplate başlığına CarIconSpan desteği ekleyin (Ia1ee0)
  • Row öğesinin başlık ve metninde CarIconSpan 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 ve SignInTemplate (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 yerine STATUS_UNKNOWN kullanacak şekilde güncelleyin (Ic9444)
  • Yüzey oluşturmadan önce ekranın var olup olmadığını kontrol edin (Ice027a)
  • STATUS_UNIMPLEMENTED ile ilgili CarValue.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üncellendi
  • PlaceListMapTempalte.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 ve RoutePreviewNavigateTemplate içindeki ActionStrip haritaları sonraki Android Auto ve Android 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 bir toString() 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ünde CarIcon 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 ve RoutePreviewNavigationTemplate 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 ve LongMessageTemplate
  • 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: 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ı. 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 alan ScreenController 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 varsa CarNotificationManager.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 bir Desktop 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 ve ScreenController yaşam döngüsü yöntemleri tek bir moveToState yönteminde (I1ed00) birleştirilmiş
  • Eklenme tarihi: CarContext#getHostInfo() (I8977e)
  • Kullanımdan kaldırılan alanlar kaldırıldı. (I67168)
  • SessionController ve ScreenController, oluşturucuları doğrudan kullanıma sunacak şekilde güncellendi (Iabf22)
  • PinSignInMethod.Builder ve ProviderSignInMethod.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ı dosya OnCarDataAvailableListener olarak yeniden adlandırıldı (I518ca)
  • CarInfo, Speed, Mileage yöntem adları ve javadoc güncellendi. (I86672)
  • Toll adlı dosya TollCard olarak yeniden adlandırıldı. (I3e7c8)
  • Kullanımdan kaldırılan PinSignInMethod.getPin, yerini PinSignInMethod.getPinCode (I996ce) aldı
  • OnInputCompletedListener kaldırıldı (InputCallback ile değiştirildi). (Ib5be1)
  • PinSignInMethod, String yerine CharSequence alacak şekilde 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ımı, araba ana makinesinde NullPointerException 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 ve LongMessageTemplate.
  • 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ı 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, 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üne ActionStrip desteği eklendi
  • setLoading, MessageTemplate koleksiyonuna eklendi. (I2a4b5)
  • ConnectionToCar adlı dosya CarConnection (Ife9bd) olarak yeniden adlandırıldı
  • NavigationTemplate, açık bir PanModeDelegate (I13877) döndürülecek şekilde değiştirildi
  • CarContext.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 modu Action 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üncellendi
  • CarAppService 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 ve LongMessageTemplate 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 öğesinin ON_DESTROY öğesinden sonra Session üzerinde ON_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ç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, 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 yeni SessionController 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 öğesinin ON_DESTROY etiketinden (0ceecb, b/183696617) sonra Session üzerindeki ON_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 çıkan NullPointerException 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

Hata Düzeltmeleri

  • Ekranlar sırayla açılırken yanlış Screen işlevinin devam ettirilmesine neden olan sorun düzeltildi. (b/177590791)