Araba uygulaması

Android Auto ve Android Automotive OS için şablonlu uygulamalar oluşturun.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
13 Kasım 2024 1.4.0 - 1.7.0-beta03 -

Bağımlılıkları beyan etme

Car App Library'e bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını 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 için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen 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 verebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

1.7 sürümü

Sürüm 1.7.0-beta03

13 Kasım 2024

Bir güvenlik açığı ve diğer genel hata düzeltmeleri yapıldı. Daha eski bir sürüm kullanıyorsanız lütfen bu sürümü kullanacak şekilde güncelleyin.

androidx.car.app:app-*:1.7.0-beta03 yayınlanır. 1.7.0-beta03 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • CAL serileştirme / seri dışı bırakma kodunu, yalnızca üzerinde @CarProtocol ek açıklaması bulunan nesneleri işlemek üzere güncelleyin. (Ic730e)
  • CarAppExtender artık yalnızca NotificationCompat.Builder yerine Notification.Builder çerçevesini genişletmek için de kullanılabilir. (Id3ad7)
  • KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST daha ekleyin. (I201f9)
  • ConversationItem üzerinde boş Builder yapıcısını kullanımdan kaldırın ve gerekli parametreleri alan bir yapıcıyla değiştirin. Ayrıca, boş iletilere karşı koruma sağlamak için bir kontrol de ekler. (Ic8221)

Hata Düzeltmeleri

  • PlaceList eşlemesinde dize (Yalnızca metin) üstbilgi başlığı kullanılmalıdır. (Ic992f)
  • Bu kitaplıkta artık tür kullanımı olan JSpecify nullness ek açıklamaları kullanılmaktadır. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için aşağıdaki derleyici bağımsız değişkenlerini kullanmalıdır: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode. (Ib5367, b/326456246)

Sürüm 1.7.0-beta02

18 Eylül 2024

androidx.car.app:app-*:1.7.0-beta02 yayınlanır. 1.7.0-beta02 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • KEY_ROOT_HINT_MEDIA_HOST_VERSION ek ekleyin (I8796b)
  • TabContents.Builder sınıfında TabContents.Api8Builder sınıfını @ExperimentalCarApi kurucusuyla değiştirin (I26fbe)
  • CarMediaApp için intent işlemi ve ekstralar ekleme (I50782)
  • Mesajlaşma API'lerini deneysel olmayan olarak işaretleme (I0b070)
  • SectionedItemTemplate'e uzaktan öğe yükleme özelliği ekleyin (uzun listelerin kilitlenmeden yüklenmesine olanak tanır) (I0d122)
  • API 8'de SectionedItemTemplate'yi TabTemplate içindeki desteklenen şablonlar listesine ekleyin. (Idc5d6)

Hata Düzeltmeleri

  • Yeni platform API'lerine erişim manuel olarak belirtilmemiştir. Bunun nedeni, AGP 7.3 veya sonraki sürümlerde R8 kullanıldığında (ör. R8 3.3 sürümü) ve AGP 8.1 veya sonraki sürümlerde tüm derlemelerde (ör. D8 8.1 sürümü) API modelleme aracılığıyla otomatik olarak gerçekleşmesidir. AGP kullanmayan müşterilerin D8 8.1 veya sonraki bir sürüme güncellemeleri önerilir. Daha fazla bilgi için bu makaleyi inceleyin. (I9496c, b/345472586)

Sürüm 1.7.0-beta01

26 Haziran 2024

androidx.car.app:app-*:1.7.0-beta01 yayınlanır. 1.7.0-beta01 sürümü bu taahhütleri içerir. Özellikler, alpha01 sürümünde yayınlananlarla aynıdır ve aşağıda tekrarlanmıştır:

Yeni Özellikler

  • İçerik içeren harita: Harita kanvası ve içerik şablonu içeren yeni şablon. İçerik şablonu şu anda Liste / Izgara / Panel / Mesaj olabilir.
    • RoutePreview, PlaceListNavigation, MapTemplate özellikleri artık desteklenmiyor. Şablonlar olduğu gibi çalışmaya devam eder.
    • Örnek uygulamalar, desteği sonlandırılan şablonlar yerine MapWithContent kullanımını gösterecek şekilde güncellendi
  • Görüşme Öğesi: Arabada görüşmeleri (IM, SMS) ve Asistan okumalarını görüntülemek için yeni API'ler.
  • Araç Boyutları: Araç ölçülerini almak için yeni API (şu anda AAOS'taki veriler).

API Değişiklikleri

  • MediaPlaybackTemplate.Builder ürününe @ExperimentalCarApi etiketini ekleyin. (Ic1957)
  • Deneysel olarak yeni bir SectionedItemTemplate ekler. (I5958a)
  • CarAppApiLevel 8 ile tanışın (I3fa22)
  • Araç Uygulama Kitaplığı'nda medya oynatma sırasında içerik görüntülemek için MediaPlaybackTemplate ekler. (I3c10d)
  • Sistem sürüş sırasında arka plan sesini destekleyip desteklemediğini algılamak için uygulamalara yeni API eklendi (I0f868)

Hata Düzeltmeleri

  • CAL istemci kodunda ve CAL Gezinme Örnek Uygulaması'nda belirli bellek sızıntısı ve kilitlenme örnekleri düzeltildi. (I55e04)
  • Kilitlenmelerin önüne geçmek için BaseCarAppActivity sınıfının onDestroy yöntemindeki requireNotNull instances değerini boşsa kontrolleriyle değiştirin. (Iec676)

Sürüm 1.7.0-alpha02

17 Nisan 2024

androidx.car.app:app-*:1.7.0-alpha02 yayınlanır. 1.7.0-alpha02 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • Haritaya dayalı şablonlar için desteği sonlandırılmış işaretler eklendi. Bu şablonlar, MapWithContent şablonu tarafından desteklenecek.

API Değişiklikleri

  • Eski MapTemplate, RoutePreviewNavigationTemplate ve PlaceListNavigationTemplate öğelerinin desteğini sonlandırıp yeni MapWithContentTemplate öğesinin kullanımını teşvik edin (Ib0a08)

Sürüm 1.7.0-alpha01

3 Nisan 2024

androidx.car.app:app-*:1.7.0-alpha01 yayınlanır. Kitaplık sürüm numaralandırma şemamız, etkin CarApi sürümüyle eşleşecek şekilde değiştirildi. Bu, geliştirici geri bildirimlerine dayalı olarak adlandırma şemasıyla ilgili kafa karışıklığını azaltmak içindir. Bu nedenle, 1.5 / 1.6 sürümlerini atlayıp doğrudan 1.7'ye geçeceğiz. 1.7.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • İçerik içeren harita: Harita içinde İçerik olarak Liste / Izgara / Bölme / Mesaj'ı destekleyen MapWithContent adlı yeni şablon.
    • RoutePreview, PlaceListNavigation, Harita şablonları artık desteklenmiyor.
    • Örnek uygulamalar, desteği sonlandırılan şablonların işlevlerini MapWithContent kullanarak göstermek için güncellendi.
  • Conversation Item: Arabada sohbetleri (IM, SMS) ve Asistan okumalarını görüntülemek için yeni API'ler.
  • Araç Boyutları: Araç ölçülerini almak için yeni API (şu anda AAOS'taki veriler).

API Değişiklikleri

  • Ekstra küçük satır resim türünü deneysel olarak işaretleme (I5184b)
  • Araç dış boyut bilgilerine (ör. yükseklik, genişlik vb.) erişmeye olanak tanıyan CarInfo#fetchExteriorDimensions API eklendi (Ia40c5)
  • ExperimentalAPI etiketi MapWithContentTemplate'ten kaldırıldı (I66db8)
  • GridItem#setTitle parametresini boş değer kabul edecek şekilde güncelleyin. (I3d610)
  • GetHeader API, geriye dönük uyumlu olduğu için API 7'yi gerektirmez (I8c812)
  • ListTemplate'te Header desteği ekleyin, headerAction, headerTitle, actionStrip için desteği sonlandırın (I7ae01)
  • GridTemplate'ta title, headerAction, actionStrip desteğini sonlandırın ve Header desteğini ekleyin (I41a9c)
  • Deneysel API'ler için 7. düzey şartını kaldırın: Rozet, GridTemplate öğe boyutu ve resim şekli alıcıları/ayarlayıcıları, GridItem rozeti alma/ayarlama yöntemleri. (Id71eb)
  • PaneTemplate'ta title, headerAction, actionStrip desteğini sonlandırın, yeni Header desteği ekleyin (I23154)
  • Media Center telemetrisi BroadcastReceiver yerine Özel İşleme Göz At olarak değiştirildi. (I4185f)
  • MessageTemplate özelliği için MessageTemplate desteği eklendi.Header ActionStrip, headerAction ve title için destek sonlandırıldı. (Ie2de8)
  • Uyarı sabit görünürlüğünü değiştirme (Icf8a8)
  • Üst şablondan isLoading özelliğini kaldırın (I651e6)
  • Medya uygulamalarını ana kullanıcı arayüzü parametreleri hakkında bilgilendirmek için ek bilgiler ekleme (I85ca2)
  • MediaExtensions'e medya merkezi analizleri özelliği ekleme (I7ce28)
  • Satırlarda ekstra küçük resim seçeneği eklendi. (I72c03)

Hata Düzeltmeleri

  • ConversationItem'teki javadoc'u, mesajların en eskiden en yeniye doğru sıralanması gerektiğini belirtecek şekilde güncelleyin. (I77a2a)
  • ConversationItem'teki en eski iletileri kaldırmak için ListTemplate kısaltma mantığını güncelleyin (Ie0a61)

Sürüm 1.4

1.4.0 sürümü

29 Mayıs 2024

androidx.car.app:app-*:1.4.0 yayınlanır. 1.4.0 sürümü, 1.4.0-rc02 sürümünün bir promosyon sürümüdür.

1.3.0 sürümünden bu yana yapılan önemli değişiklikler

  • Navigasyon uygulamaları için gösterge grubunda harita oluşturma
  • İyileştirilmiş uygulama düzeni / kullanılabilirlik için yeni sekme şablonu
  • Uyarlanabilir görev sınırları için destek
  • Liste öğeleriyle ilgili ikincil işlemler

Sürüm 1.4.0-rc02

13 Aralık 2023

androidx.car.app:app-*:1.4.0-rc02 yayınlanır. 1.4.0-rc02 sürümü bu taahhütleri içerir. Yalnızca küçük düzeltmeler

Hata Düzeltmeleri

  • ConversationItem adresindeki javadoc'u, mesajların en eskiden en yeniye göre sıralanması gerektiğini belirtecek şekilde güncelleyin (I77a2a)
  • ConversationItem'teki 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, önemli bir değişiklik içermeden yayınlandı. 1.4.0-rc01 sürümü bu taahhütleri içerir.

Sürüm 1.4.0-beta02

20 Eylül 2023

androidx.car.app:app-*:1.4.0-beta02 yayınlanır. 1.4.0-beta02 sürümü bu taahhütleri içerir. Bu, beta01 ile neredeyse aynıdır ancak compileSdk koşulunu 33'e düşürür.

Hata Düzeltmeleri

  • Sekmelerdeki yükleme ekranlarının düzgün şekilde gösterilmemesine 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ınlanır. 1.4.0-beta01 sürümü bu taahhütleri içerir.

Not: 1.4-beta01, hâlâ geliştirme aşamasında olan compileSdk34 sürümünü gerektirir. 1.4-beta02 sürümünde bu sorun düzeltilecektir. Alternatif olarak, uyarıyı geçici olarak güvenli bir şekilde devre dışı bırakmak için projenizin settings.gradle dosyasına android.suppressUnsupportedCompileSdk=34 ekleyebilirsiniz.

Yeni Özellikler

API Değişiklikleri

  • alpha02'ye bakın

Sürüm 1.4.0-alpha02

26 Temmuz 2023

androidx.car.app:app-*:1.4.0-alpha02 yayınlanır. 1.4.0-alpha02 sürümü bu taahhütleri içerir.

  • Alpha02 sürümünün yayınlanması, beta01 sürümünün yayınlanmasına hazırlık niteliğindedir.

Yeni Özellikler

  • Gösterge grubunda harita oluşturma, navigasyon uygulamaları için destek
  • Uygulamalar için sekmeler eklendi. Bu sayede, sayfa düzeni deneyimi iyileştirilebilir.
  • Liste / ızgara şablonu oluşturma seçenekleri eklendi
  • Hava Durumu ve İletişim için yeni kategoriler eklendi
  • Birkaç API'yi sonraki CarApi 7 sürümüne taşıma

API Değişiklikleri

  • CarMessage (I5aaf6) alanına multimedya alanları ekleme
  • Araba Uygulama Kitaplığı'ndaki ConversationItem'e özel işlemler ekler (Ie5ed6)
  • Bir medya öğesinin etkileyici bir ses biçimiyle oynatıldığını belirtmek ve içerik biçimi logosunu (Icb5bb) göstermek için ekstralar ekleyin.
  • Oluştur düğmesini desteklemek için yeni bir işlem türü ve ActionsConstraints API ekleyin. (I31661)
  • set/getTemplate'ü set/get ContentTemplate olarak oluşturma (Ica036)
  • Şablon parametresi artık @NonNull olur. MapWithContentTemplate API dokümanları güncellendi (I0f8ed)
  • CAL 1.4'te kullanıma sunulacak ListTemplate içindeki İşlemler için @ExperimentalCarApi etiketini kaldırır (I2cfcb)
  • TabTemplate için @ExperimentalCarApi etiketini kaldırır (Ifcb82)
  • Satır ikincil işlemlerinden ve süslemelerinden @ExperimentalCarApi ek açıklamalarını kaldırma (I8487e)
  • Etkin sekme içerik kimliğini TabTemplate alanına ekler ve Sekmelerdeki etkin durum için desteği sonlandırır (I96932)
  • ItemImageShape mülkünü GridTemplate'a ekleme (Ibf431)
  • GridTemplate mülküne ItemSize mülkünü ekleyin. Bu mülk, ızgara öğesi boyutunu göreceli küçük, orta ve büyük gruplara göre kontrol eder. (Icdb3b)
  • Geliştiricilerin mevcut ekran yığınının bir kopyasını alabilmesi için API erişimini açın. (I48107)
  • Araç Uygulama Kitaplığı'na hava durumu uygulamaları kategorisi ekler (I2be44)
  • Araba Uygulama Kitaplığı'na arama uygulamaları kategorisi 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 resminin üzerine rozet gösterilmesine olanak tanıyan Rozet mülkünü GridItem öğesine ekleyin. (I95de7)
  • Bir resim üzerinde gösterilecek 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ınlanır. 1.4.0-alpha01 sürümü bu taahhütleri içerir.

API Değişiklikleri

  • Araç Uygulama Kitaplığı'ndaki (Id0191) GridTemplate öğesine üst düzey işlemler ekler.
  • Araba Uygulama Kitaplığı'ndaki (I9efab) ListTemplate alanına üst düzey işlemler ekler
  • Bir medya öğesinin altyazı 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 olarak güncelleyin. (Ie0a69)
  • A4C'ye mesajlaşma geri çağırma işlevi ekleme (Ie3986)

Hata Düzeltmeleri

  • CarMessage için eksik JavaDoc referanslarını ekleyin. (I5db1c)
  • ConversationItem ve CarMessage için equals() ve hashCode()'ı geçersiz kılma (I6fd10)
  • ConversationItem.mMessages doğrulamasını iyileştirin (boş olmayan, null olmayan bir değer gerektirir (Iafc51))
  • ConversationItem alanlarına @Keep ek açıklamaları ekleme (I5d250)
  • 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ınlanır. 1.3.0-rc01 sürümü bu taahhütleri içerir.

  • Beta01'den 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 taahhütleri içerir.

Yeni Özellikler

Car App Library 1.3.0-alpha01'de eklenen özelliklere ek olarak beta01 kapsamında aşağıdaki özellikler eklendi (Buradaki tüm özellikler, API değişikliği içermeden yalnızca ana makine tarafında değişiklik içerir):

  • Yüzen gezinme çubuğu, kullanıcı PlaceListNavigationTemplate, RoutePreviewNavigationTemplate ve MapTemplate'de haritaya dayalı bir seçim ekranındayken bile gösterilmeye devam eder. Bu işlem, NavigationManager.updateTrip() üzerinden gezinme bilgilerini güncelleyerek yapılabilir.
  • Zaman aşımı animasyonu için FLAG_DEFAULT ile işlem düğmesini etkinleştirin. Zaman aşımı süresi dolduktan sonra bu düğme varsayılan olarak tıklanır. ([API 5 - All Templates])
  • Row alt metni, araba park halindeyken kısaltılmaz ancak 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 devre dışı durumu desteği

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 işlemleriyle ilgili kısıtlamayı kaldırın. (Iad28f)
  • ActionsConstraints için setOnClickListenerAllowed() kısıtlaması ekleyin. Bu durumda, Action'ün OnClickDelegate()'yi standart simge türleri dışındaki işlemler için ayarlaması mümkündü. (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 yayınlandı. 1.3.0-alpha01 sürümü bu taahhütleri içerir.

API seviyesi 5 ile ek açıklamaya sahip özellikler Android Auto 7.9 ve sonraki sürümlerle uyumludur.

Yeni Özellikler

  • API düzeyi 5: Gezinme uygulamaları tarafından haritanın yanında panel veya liste içeriği görüntülemek için kullanılabilecek yeni MapTemplate (If5826, If44b8)
  • API Seviyesi 5: Ana makinenin mikrofonu aracılığıyla ses girişi kaydetmeye olanak tanıyan yeni CarAudioRecord API (I5e71a)
  • API düzeyi 5: Uygulamaların ana makineye öneriler sunmasına olanak tanıyan yeni SuggestionManager API (I5c103)
  • API düzeyi 5: NavigationTemplate'daki bağlam bildirimlerinde gösterilecek yeni Alert API (I163a7, I5ad70)
  • API düzeyi 5: Şablonlar arasında yeniden kullanımı kolaylaştırmak için yeni Header ve MapController bileşenleri (If5826)
  • ÖY uygulamalarını etkinleştirmek için androidx.car.app.category.POI kategorisi eklendi (androidx.car.app.category.PARKING ve androidx.car.app.category.CHARGING için destek sonlandırıldı) (I59da1)

API Değişiklikleri

  • API Seviyesi 5: Haritaya dokunarak etkileşime izin vermek için SurfaceCallback arayüzünde yeni onClick yöntemi (Ia9777)
  • API düzeyi 5: Action'leri tanımlamak 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 sunulacak barındırıcı desteği) (Id8a09)
  • API düzeyi 5: Mevcut setTitle ve setHeaderAction yöntemlerini kullanımdan kaldırarak PlaceListNavigationTemplate.Builder ve RoutePreviewNavigationTemplate.Builder'te setHeader aracılığıyla yeni Header bileşenini tercih edin (I30e6a)
  • API Seviyesi 5: Yeni OnContentRefreshListner arayüzünün uygulamalarında kullanılmak üzere PlaceListMapTemplate.Builder ve PlaceListNavigationTemplate.Builder üzerinde 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ığında CarIconSpan için destek ekleme (Ia1ee0)
  • Row başlığında ve metninde CarIconSpan desteği ekleme (Ic1e3c)
  • Harita ActionStrip'lerinde artık en fazla dört işlem bulunabilir (If3522)
  • Araba Uygulaması API düzeyini 5'e güncelleme (I26b8e)
  • Başlıklar/başlıklar artık PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate ve SignInTemplate (I2078d, Icadde) için isteğe bağlıdır

Hata Düzeltmeleri

  • PaneTemplate resim boyutlandırma kuralları kare bir sınır kutusu olacak şekilde güncellendi (Idd72e)
  • Ekran yığını State.DESTROYED'ten sonra değiştirilirse ortaya çıkan istisna düzeltildi. (I3c8eb)
  • Uygulama simgesini almak için boş değer kontrolü eklendi (I3f710)
  • Car Hardware API'yi varsayılan olarak STATUS_UNAVAILABLE yerine STATUS_UNKNOWN kullanacak şekilde güncelleme (Ic9444)
  • Yüzey oluşturmadan önce ekranın olup olmadığını kontrol etme (Ice027a)
  • STATUS_UNIMPLEMENTED ile ilgili CarValue.equals() hatasını düzeltme (I24451)

Sürüm 1.2

Sürüm 1.2.0

9 Kasım 2022

androidx.car.app:app-*:1.2.0 yayınlanır. 1.2.0 sürümü bu taahhütleri içerir.

  • Bu, kararlı sürümdür ve v1.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ınlanır. 1.2.0-rc01 sürümü bu taahhütleri içerir.

  • Bu, kararlılık sürümüdür ve v1.2.0-beta02 sürümüne kıyasla API'de herhangi bir değişiklik 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'ten sonra değiştirilirse ortaya çıkan istisna düzeltildi. (I3c8eb)
  • CarSensors API'si, AAOS (Idd57b) için uygulanmadığını belirtecek şekilde güncellendi
  • PlaceListMapTempalte.Builder#setCurrentLocationEnabled, özellik için ACCESS_COARSE_LOCATION izninin yeterli olacağını belirtecek şekilde güncellendi (I510c2)
  • Açı içeren kavşak manevrası türleri için çıkış numarasını isteğe bağlı hale getirdi (Ife7d1)

Sürüm 1.2.0-beta02

26 Ocak 2022

androidx.car.app:app-*:1.2.0-beta02 yayınlanır. 1.2.0-beta02 sürümü bu taahhütleri içerir.

Android Automotive OS platformunu hedefleyen bu kitaplık sürümüyle oluşturulan araç uygulamaları artık Play Store açık test kanalında yayınlanabilir. Daha fazla bilgi için geliştirme kılavuzuna bakın.

API seviyesi 4 ve altındaki özellikler hem Android Auto 7.2 ve sonraki sürümler hem de yeni Android Automotive OS platformuyla uyumludur. Dikkat edilmesi gereken noktalar için aşağıdaki Known Issues bölümüne bakın.

API Değişiklikleri

  • Önemli yer şablonlarına deneysel setOnContentRefreshListener API eklendi (I6bf22)

Hata Düzeltmeleri

  • Araç ana makinesinin bağlamayı kaldırması durumunda CarAppService'te yaşanan bellek sızıntısı düzeltildi. (I5c9ca, b/203594731)
  • CarAppActivity javadoc'u, singleTask launchmode ile ilgili şartları içerecek şekilde güncellendi (Id2f95)
  • Devam ettirildiğinde oluşan görsel hatayı azaltır. (Iff7e0)

Bilinen sorunlar

  • PlaceListNavigationTemplate ve RoutePreviewNavigateTemplate'deki harita ActionStrip'leri, 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ınlanır. 1.2.0-alpha02 sürümü bu taahhütleri içerir.

API düzeyi 4 ile ek açıklama eklenmiş özellikler, deneysel sürümden kararlı sürüme geçirildi.Bu özellikler arasında PlaceListNavigationTemplate ve RoutePreviewNavigateTemplate öğelerindeki harita ActionStrip'leri, Pane öğelerindeki CarIcon resmi, QRCodeSignInMethod ve Action öğelerinde oluşturma ipuçlarını (ör. işaretler) ayarlama özelliği yer alıyor.

Yeni Özellikler

  • Android Auto 7.1 ve sonraki sürümlerde Pane için öğe sınırı 2'den 4'e çıkarıldı.

API Değişiklikleri

  • CarUnit'a deneysel bir toString() yöntemi eklendi(I36a3b)

Hata Düzeltmeleri

  • Geri çağırma işlevi devre dışıysa 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ınlanır. 1.2.0-alpha01 sürümü bu taahhütleri içerir.

Yeni v1.2.0 özelliklerinin (API 4 ve üzeri) tümü şu anda gelecekteki Android Auto ve Android Automotive OS sürümlerini hedefleyen deneysel özelliklerdir. Daha fazla bilgi için geliştirme kılavuzuna bakın.

API Değişiklikleri

  • AutomotiveCarInfo API deneysel olarak kullanıma sunuldu. (Ia13e5)
  • Car App Library API düzeyi 4 (I2a2e7) eklendi
  • API düzeyi 4: Pane içinde CarIcon ayarlama desteği eklendi (Ifcc12)
  • API 4. Seviye: QR kodu oturum açma yöntemi eklendi (Ib623e)
  • API düzeyi 4: Action (Ic03ab) için set/getFlags eklendi
  • API düzeyi 4: PlaceListNavigationTemplate ve RoutePreviewNavigationTemplate'te kaydırma ve yakınlaştırma desteği eklendi (I9d8a3)

Hata Düzeltmeleri

  • API Düzeyi 4: Uygulamaların araç ana makinesine konum güncellemeleri göndermesine izin veren bir mekanizma ekleyin (I3bad3)
  • Ana makine doğrulama mantığının TEMPLATE_RENDERER iznini düzgün şekilde bulamadığı sorun düzeltildi (I62618)

1.1.0 sürümü

1.1.0 sürümü

15 Aralık 2021

androidx.car.app:app-*:1.1.0 yayınlanır. 1.1.0 sürümü bu taahhütleri içerir.

Bu, kararlılıkla ilgili bir sürümdür ve v1.1.0-rc01 sürümüne kıyasla herhangi bir değişiklik yoktur. Araba uygulaması kitaplığındaki yeni özellikler hakkında daha fazla bilgi için v1.2.0-alpha02 sürüm notlarına da göz atın.

1.0.0 sürümünden bu yana yapılan önemli değişiklikler

  • API 2. Seviye: Araç park halindeyken oturum açma akışları için kullanılabilen SignInTemplate ve LongMessageTemplate
  • API düzeyi 2: NavigationTemplate içinde harita etkileşimi desteği
  • API Seviyesi 2: Uygulamaların, araç ekranı boyutlarına bağlı olarak görüntülemek için dizenin birden fazla sürümünü sağlamasına olanak tanıyan çok uzunluklu metin desteği.
  • API 3. Seviye: CarHardwareManagerAracın donanım verilerini (ör. model ve marka, yakıt seviyeleri ve diğer sensörler) 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ınlanır. 1.1.0-rc01 sürümü bu taahhütleri içerir.

Bu, kararlılık sürümüdür ve v1.1.0-beta01 sürümüne kıyasla API'de herhangi bir değişiklik 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ınlanır. 1.1.0-beta01 sürümü bu taahhütleri içerir.

Tüm v1.1.0 özellikleri (API 2 ve üzeri), Android Auto 6.7 ve sonraki sürümlerle tam uyumludur. Daha fazla bilgi 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
  • TestCarContext alanını açıkça alan ScreenController kurucusu kaldırıldı (Iefebc)

Hata Düzeltmeleri

  • CarHardwareManager oluşturulurken API düzeyi kontrolü eklendi (I48f9b)
  • API'de geçersiz CarSpan kullanımı için kontroller eklendi (I65ae6)
  • Oluşturulması sırasında Screen'ün tamamlandı olarak işaretlenmesi durumunda yığının bozuk durumda kalmasına neden olan sorun düzeltildi (I81b13)
  • CarAppExtender'da simge içeren işlemler varsa CarNotificationManager.notify'ün AutomotiveOS için hata günlüğe kaydetmesi sorunu düzeltildi (I3633d)
  • Uygulama ve ana makinenin API sürümü oluşturması için bir 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ınlanır. 1.1.0-alpha02 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • API Seviyesi 3: Aracın donanım verilerini (ör. model ve marka, yakıt seviyeleri ve diğer sensörler) 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. Bu özelliği masaüstü ortamında test etmek için ayrı olarak yayınlanacak yeni bir Desktop Head Unit sürümü gerekir. 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ç ana makinelerinde 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ı inceleyin.

API Değişiklikleri

  • SessionController ve ScreenController yaşam döngüsü yöntemlerini tek bir moveToState yönteminde birleştirdi (I1ed00)
  • CarContext#getHostInfo() (I8977e) eklendi
  • Desteği sonlandırılmış alanlar kaldırıldı. (I67168)
  • SessionController ve ScreenController, doğrudan kurucuları göstermek için güncellendi (Iabf22)
  • PinSignInMethod.Builder ve ProviderSignInMethod.Builder (I9f0cb) kaldırıldı
  • AAOS'te "sonuç için" şablonlu uygulamaların kullanılabilmesini sağlamak üzere "setCarAppResult()" eklendi (I37741)
  • CarHardware arayüzleri @MainThread ile ek açıklama eklendi. (Ib2f85)
  • OnCarDataListener, OnCarDataAvailableListener olarak yeniden adlandırıldı (I518ca)
  • CarInfo, Speed, Mileage yöntem adları ve javadoc güncellendi. (I86672)
  • Toll, TollCard olarak yeniden adlandırıldı. (I3e7c8)
  • Desteği sonlandırılan PinSignInMethod.getPin kaldırıldı ve yerine PinSignInMethod.getPinCode eklendi (I996ce)
  • OnInputCompletedListener kaldırıldı (InputCallback ile değiştirildi). (Ib5be1)
  • PinSignInMethod, String yerine CharSequence değerini alacak şekilde değiştirildi (I275d5)

Hata Düzeltmeleri

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

Harici Katkı

Bilinen Sorunlar

  • SignInTemplate'te InputSignInMethod kullanılması, araç ana makinesinde NullPointerException'ye neden olabilir. Bu sorun, kitaplığın sonraki sürümünde giderilecektir. Sorunu gidermek 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ı. 1.1.0-alpha01 sürümü bu taahhütleri içerir.

Yeni Özellikler

  • API 2. Seviye: Araç park halindeyken oturum açma akışları için kullanılabilecek yeni SignInTemplate ve LongMessageTemplate.
  • API 2. Seviye: NavigationTemplate içinde yeni harita etkileşimi desteği
  • API Seviyesi 2: Uygulamaların, araç ekranı boyutlarına bağlı olarak görüntülemek üzere dizenin birden fazla sürümünü sağlamasına olanak tanıyan yeni çoklu uzunluktaki metin desteği.
  • API düzeyi 2 ile uyumlu araç ana makinelerinde bu özelliklerin nasıl kullanılacağıyla ilgili ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzunu ve kitaplık Javadoc'ını inceleyin.

API Değişiklikleri

  • Tüm *Callback arayüz yöntemlerini varsayılan olarak ayarladık ve OnRequestPermissionsCallback -> OnRequestPermissionsListener olarak yeniden adlandırdık (Ib3ec9)
  • Gereksiz oluşturucuları 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 araca özgü verilere erişmek için androidx.car.app.hardware sınıfları eklendi. (Iff3c9)
  • MessageTemplate tarihinde ActionStrip desteği eklendi (Ida657)
  • MessageTemplate listesine setLoading eklendi. (I2a4b5)
  • ConnectionToCar, CarConnection olarak yeniden adlandırıldı (Ife9bd)
  • NavigationTemplate, açık bir PanModeDelegate döndürecek şekilde değiştirildi (I13877)
  • CarContext.requestPermissions (Ib890a) için parametre sırası güncellendi
  • Meta veri anahtarı, minimum araç API düzeyini androidx.car.api.minCarApiLevel (Ib0d41) olarak tanımlayacak şekilde güncellendi
  • Araç bağlantı durumunu gözlemlemeye 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
  • Araçta 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 (I77aa6) sürümünde kaydırma modu ve harita işlem şerit API'si eklendi
  • Navigasyon uygulamaları için SurfaceCallback'e kaydırma ve yakınlaştırma API'si eklendi (Id5e9d)
  • CarAppApiLevel 2 olarak güncellendi (Ic1540)
  • CarAppService'den izin isteme özelliği eklendi (I5421e)
  • Çok metinli API'ye RequiresCarApi(2) ek açıklama eklendi (Iacb62)
  • Yarım liste şablon başlığında birden fazla metin varyantına izin verildi (Ib8df7)
  • Yeni LongMessageTemplate eklendi (Car API düzeyi 2 gerektirir) (Ic5cee)

Hata Düzeltmeleri

  • Daha büyük araç ekranlarını hesaba katmak için resim boyutu koşulları güncellendi (I116dc)
  • Şablon gövdelerine 2'den fazla işlem eklemeye izin verilmez (I32157)
  • Araba uygulaması kitaplığındaki tüm PendingIntent'lerin oluşturulmasının işaretlerini ayarladı. (If84fe, b/186394900)
  • Row'ün metninin yenilenirken değişmesine 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'ün gövdesinde yalnızca park edilmiş durumdayken yapılacak işlemleri zorunlu kıldık ve dokümanları, yalnızca araç park edildiğinde gösterileceklerini belirtecek şekilde güncelledik (Iddaa9)
  • Başlangıç sırasında Screen gösterilirken oluşan bir istisna düzeltildi (Ifcf40, b/184664896)
  • ForegroundCarColorSpan'te özel metin rengine izin verildi (I69e59)
  • Screen'nin ON_DESTROY işleminden sonra Session'da ON_DESTROY gözlemlenmesi sorunu düzeltildi (I52e01, b/183696617)
  • TravelEstimate'nin kalan süresinin bilinmeyen bir zamana ayarlanmasına ne zaman izin verildiğiyle ilgili javadoc güncellendi. (I99610, b/183632456)
  • Action, başlıkta ForegroundColorSpan ve özel arka plan rengini (I578e4) destekleyecek şekilde güncellendi
  • Geri çağırma, yürütücü çalıştırılmadan önce temizlenirse NavigationManagerCallback#onStopNavigation yürütülmesin (I7fc5e, b/181143772)
  • Uygulamanın lifecycle-common-java8 (I8b8c8) bağımlılıklarını açıkça almasını gerektiren bir sorun düzeltildi

Bilinen Sorunlar

  • SignInTemplate'te, kullanıcı girişi onaylamak istediğinde ekran klavyesinde "enter" simgesi yerine "arama" simgesi gösterilir. Kullanıcılar, geçici çözüm olarak giriş alanı odaktayken etkinleşen telefon klavyesine erişebilir.
  • Android Auto 6.5 sürümünde, SurfaceCallback içindeki kaydırma ve yakınlaştırma geri çağırma işlevleri bazı dokunma hareketleri için yanlış şekilde çağrılabilir.

Car App Testing Version 1.0.0

Sürüm 1.0.0-alpha01

24 Mart 2021

androidx.car.app:app-testing:1.0.0-alpha01 yayınlanır. 1.0.0-alpha01 sürümü bu taahhütleri içerir.

Bu, daha önce kapalı kaynaklı olan test kitaplığının ilk Jetpack sürümüdür. Bu kitaplığın testlerinizde 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 oluşturucularda ayarlanan değerlerin doğrulanmasına olanak tanıyan herkese açık API yüzeyinin bir parçasıdır.
  • Önceki CarAppServiceController, sıcak noktalara olan bağlantının ömrü ile ilgili mantığı test etmek 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ınlanır. 1.0.0 sürümü bu taahhütleri içerir.

1.0.0 sürümünün önemli özellikleri

  • Nisan ayının başlarında, uygulamaların androidx.car.app:app:1.0.0-rc01 kullanarak üretim kanalında yayınlamaya başlayabileceğini duyurmuştuk. Araç Uygulama Kitaplığı 1.0.0 sürümü artık kararlı ve Android Auto 6.1 ve sonraki sürümlerle tam uyumludur.
  • Kitaplığı kullanarak Android Auto için navigasyon, park etme ve şarj uygulamaları oluşturma hakkında ayrıntılı bilgi için geliştirme kılavuzunu inceleyin.

Hata Düzeltmeleri

  • Başlangıç sırasında Screen gösterilirken oluşan bir istisna düzeltildi (70aae1, b/184664896)
  • Bir Screen'nin ON_DESTROY'sinden sonra bir Session'ta ON_DESTROY'nin gözlemlenmesi sorunu düzeltildi (0ceecb, b/183696617)

Sürüm 1.0.0-rc01

24 Mart 2021

androidx.car.app:app:1.0.0-rc01 yayınlanır. 1.0.0-rc01 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Geri çağırma işlevi temizlendikten sonra NavigationManagerCallback#onStopNavigation işlevinin çağrılmasına neden olan yarış koşulu hatası düzeltildi. Bu durum, geri çağırma işleyici gerçekten çalıştırılmadan önce geri çağırma işleminin temizlenmesi durumunda (I7fc5e, b/181143772) ortaya çıkar.
  • Uygulamanın lifecycle-common-java8 (I8b8c8) için açıkça bağımlı olması gereken bir sorun düzeltildi
  • Uygulama, geri aramayı kaldırmışken stopNavigation araması aldığında NullPointerException hatası düzeltildi (Ib8b89, b/181143772)
  • Yaşam döngüsü en azından CREATED durumunda değilse uygulamaya çağrı göndermemeyi sağlayan iyileştirmeler (I86965, b/179800224, b/177921120)
  • Uygulamanın manifest dosyasında belirtilen geçersiz bir minimum API'nin, ana makinede ANR'ye neden olduğu sorun düzeltildi. (Iffedd, b/174231592)

Sürüm 1.0.0-beta01

24 Şubat 2021

androidx.car.app:app:1.0.0-beta01 yayınlanır. 1.0.0-beta01 sürümü bu taahhütleri içerir.

Bu, daha önce kapalı kaynaklı olan kitaplığın ilk Jetpack sürümü olup 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ılavuzunu inceleyin.

Yeni Özellikler

Hata Düzeltmeleri

  • Ekranlar sırayla açılırken yanlış Screen'ün devam ettirildiği sorun düzeltildi. (b/177590791)