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 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:

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"
}

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-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

• Fazladan KEY_ROOT_HINT_MEDIA_HOST_VERSION ekleyin (I8796b)
• TabContents.Builder sınıfında (I26fbe) TabContents.Api8Builder sınıfını @ExperimentalCarApi oluşturucuyla değiştirin
• 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

• Bu durum, AGP 7.3 veya sonraki bir sürümle R8 kullanılırken (ör. R8 sürüm 3.3) ve AGP 8.1 veya sonraki sürümler kullanılırken tüm derlemeler (ör. D8 sürümü 8.1) için API modellemesi aracılığıyla otomatik olarak gerçekleştirildiğinden, yeni platform API'lerine erişimin manuel olarak özetlenmesi kaldırıldı. 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ınlandı. 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 İçeren Eşleme: Yeni şablon, Harita Tuvali ve içerik şablonu (şimdilik Liste / Izgara / Bölme / İleti 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)
• 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)
• 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ınlandı. Sürüm 1.7.0-alpha02 bu kaydetmeleri 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

• İçerikli Eşleme: Harita içinde İçerik olarak Liste / Izgara / Bölme / İleti özelliğini 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.
• İ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çü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 reklam grubundan (I66db8) kaldırıldı
• 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ına ana kullanıcı arayüzü parametreleri (I85ca2) hakkında bilgi vermek için ekstralar ekleyin
• 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'dan bu yana önemli değişiklikler

• Navigasyon uygulamaları için gösterge grubunda harita oluşturma
• İyileştirilmiş uygulama düzeni / kullanılabilirliği 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ınlandı. 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. Sürüm 1.4.0-beta01 bu kaydetmeleri 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. Dilerseniz uyarıyı geçici olarak bastırmak için projenizin settings.gradle dosyasına android.suppressUnsupportedCompileSdk=34 ekleyebilirsiniz.

Yeni Özellikler

• Navigasyon uygulamaları için küme harita oluşturma aracı
• İyileştirilmiş uygulama düzeni / kullanılabilirliği için yeni Sekme Şablonu
• Uyarlanabilir görev sınırları desteği
• Liste öğeleriyle ilgili ikincil işlemler

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
• Düzen deneyimini iyileştirmek için uygulamalara Sekmeler eklendi
• Liste / Izgara ş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 Uygulaması Kitaplığı'nda (Ie5ed6) ConversationItem için özel işlemler ekler
• 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 özelliğini GridTemplate (Ibf431) için ekleyin
• 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)
• Araba Uygulama Kitaplığı'na (I2be44) hava durumu uygulamaları için kategori ekler
• 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

• Araba Uygulaması Kitaplığı'nda (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ğırması ekleme (Ie3986)

Hata Düzeltmeleri

• CarMessage için eksik JavaDoc 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, null olmayan bir değer gerektirir (Iafc51))
• ConversationItem alanlarına @Keep ek açıklamaları ekleyin (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. 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 yayınlandı. Sürüm 1.3.0-beta01 bu kaydetmeleri içerir.

• Bu kitaplık kullanılarak oluşturulan araç uygulamaları artık API düzeyi 5'i kullanarak Play Store'a yüklenebilir (geliştirme kılavuzumuza bakın). API düzeyi 5 ve altındaki ek açıklamalı özellikler, hem Android Auto 8.1 ve sonraki sürümler hem de Google Automotive App Host 1.4 ve sonraki sürümler ile uyumludur.

Yeni Özellikler

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):

• Kullanıcı PlaceListNavigationTemplate, RoutePreviewNavigationTemplate ve MapTemplate alanlarındaki harita tabanlı seçim ekranında olsa bile kayan gezinme çubuğu gösterilmeye devam edecek. 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 İşlemleri kısıtlamasını 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

• Android Automotive Template Host 1.4 ve sonraki sürümler ile kavisli ekranlar ([Host change]) için uyumluluk eklendi

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 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 ö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)
• 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 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)
• Car App API düzeyini 5 olarak güncelleyin (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 görüntü boyutlandırma kuralı, kare sınırlayıcı kutu (Idd72e) olacak şekilde güncellendi
• 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 kaydetmeleri 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ınlandı. 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

• ÖY ş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 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ınlanır. 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 çı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ınlandı. 1.2.0-alpha01 sürümü bu taahhütleri 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 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ınlandı. 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 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ı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+), Android Auto 6.7 ve sonraki sürümleriyle tamamen 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 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ınlanır. 1.1.0-alpha02 sürümü bu kaydetmeleri 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, oluşturucuları doğrudan kullanıma sunacak şekilde güncellendi (Iabf22)
• PinSignInMethod.Builder ve ProviderSignInMethod.Builder (I9f0cb) kaldırıldı
• AAOS'de (I37741) "sonuç için" şablonlu uygulamaların kullanımını etkinleştirmek için "setCarAppResult()" eklendi
• 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 serbest bırakıldı. 1.1.0-alpha01 sürümü bu taahhütleri 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 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.
• 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 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 (Ida657) sürümüne ActionStrip desteği eklendi
• MessageTemplate listesine setLoading eklendi. (I2a4b5)
• ConnectionToCar adlı dosya CarConnection (Ife9bd) olarak yeniden adlandırıldı
• 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 cihazından (I5421e) izin isteme özelliği eklendi
• Çok metinli API'ye RequiresCarApi(2) ek açıklama eklendi (Iacb62)
• Yarı liste şablon başlığında (Ib8df7) birden çok metin varyantına izin veriliyor
• 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 uygulama kitaplığı grup işaretlerinde her PendingIntent öğesinin oluşturulmasını sağlayın. (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 kaydetmeleri 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ınlandı. 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 ve şarj uygulamaları oluşturma hakkında ayrıntılı bilgi edinmek üzere geliştirme kılavuzuna başvurun.

Hata Düzeltmeleri

• Başlangıç sırasında Screen gösterilirken oluşan bir 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ınlanır. Sürüm 1.0.0-rc01 bu kaydetmeleri 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ınlandı. 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

• Uygulamanızın, kullanıcı arayüzü öğelerinin listesini ızgara düzeninde göstermek için kullanabileceği bir GridTemplate kullanıma sunuldu.
• Ana makine bağlantısının güvenilir bir kaynaktan (ör. Android Auto) olduğunu doğrulamak için bir CarAppService.createHostValidator yöntemi kullanıma sunuldu.
• CarAppExtender.Builder.setColor API'si eklendi. (b/174231592)

Hata Düzeltmeleri

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