Araba Uygulaması
Son Güncelleme | Kararlı Sürüm | Serbest Bırakma Adayı | Beta Sürümü | Alfa Sürümü |
---|---|---|---|---|
1 Kasım 2023 | 1.2.0 | 1.4.0-rc01 | - | - |
Bağımlılıkları bildirme
Araba Uygulama Kitaplığı'na bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanız veya modülünüz için build.gradle
dosyasına ihtiyaç duyduğunuz yapıların bağımlılıklarını ekleyin:
Modern
dependencies { implementation "androidx.car.app:app:1.2.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.2.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.2.0" // For testing testImplementation "androidx.car.app:app-testing:1.2.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.2.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.2.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.2.0") // For testing testImplementation("androidx.car.app:app-testing:1.2.0") }
Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme bölümüne bakın.
Geri bildirim
Geri bildirimleriniz Jetpack'i iyileştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı geliştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni hesap oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici belgelerine bakın.
Sürüm 1.4
Sürüm 1.4.0-rc01
1 Kasım 2023
androidx.car.app:app-*:1.4.0-rc01
önemli bir değişiklik olmadan yayınlandı. Sürüm 1.4.0-rc01 bu kayıtları içerir.
Sürüm 1.4.0-beta02
20 Eylül 2023
androidx.car.app:app-*:1.4.0-beta02
yayınlandı. Sürüm 1.4.0-beta02 bu kayıtları içerir. Bu değer beta01 ile neredeyse aynıdır, ancak compileSdk
şartını 33'e düşürür.
Hata Düzeltmeleri
- Sekmelerdeki yükleme ekranlarının düzgün görüntülenmemesine neden olan hata düzeltildi. (cae860)
Sürüm 1.4.0-beta01
9 Ağustos 2023
androidx.car.app:app-*:1.4.0-beta01
yayınlandı. Sürüm 1.4.0-beta01 bu kayıtları içerir.
Not: 1.4-beta01 için, hâlâ geliştirme durumunda olan derSdk34 gerekir. 1.4-beta02 sürümü bu sorunu düzeltecektir. Alternatif olarak, uyarıyı güvenli bir şekilde geçici olarak kapatmak için projenizin
settings.gradle
dosyasınaandroid.suppressUnsupportedCompileSdk=34
ekleyebilirsiniz.
Yeni Özellikler
- Navigasyon uygulamaları için gösterge küme haritası oluşturma
- Geliştirilmiş uygulama düzeni / kullanılabilirliği için yeni Sekme Şablonu
- Uyarlanabilir görev sınırları desteği
- Liste öğelerindeki ikincil işlemler
API Değişiklikleri
- Alfa02'yi göster
Sürüm 1.4.0-alpha02
26 Temmuz 2023
androidx.car.app:app-*:1.4.0-alpha02
yayınlandı. Sürüm 1.4.0-alpha02 bu kayıtları içerir.
- Alfa02 sürümü, yakında çıkacak Beta01 sürümüne hazırlık amacıyla tasarlanmıştır.
Yeni Özellikler
- Navigasyon uygulamaları için Gösterge Kümesi desteğinde harita oluşturma
- Düzen deneyimini iyileştirmek için uygulamalar için Sekmeler eklendi
- Eklenen Liste / Izgara şablonu oluşturma seçenekleri
- Hava Durumu ve İletişimler için yeni kategoriler eklendi
- Birkaç API'yi bir sonraki CarApi 7 sürümüne taşıma
API Değişiklikleri
CarMessage
ürününe multimedya alanları ekleyin (I5aaf6)- Araba Uygulama Kitaplığı'nda (Ie5ed6)
ConversationItem
öğesine özel işlemler ekler - Bir medya öğesinin sürükleyici ses biçiminde oynatıldığını belirtmek ve içerik biçimi logosunu göstermek için ekstra özellikler ekleyin (Icb5bb)
- Oluşturma düğmesini desteklemek için yeni işlem türü olan
ActionsConstraints
API eklendi. (I31661) set/getTemplate
,set/get ContentTemplate
olarak yapıldı (Ica036)- Şablon parametresi artık
@NonNull
olacaktır.MapWithContentTemplate
API dokümanları güncellendi (I0f8ed) - CAL 1.4'te (I2cfcb) kullanıma sunmak üzere
ListTemplate
içindeki İşlemler için@ExperimentalCarApi
etiketini kaldırır TabTemplate
(Ifcb82) için@ExperimentalCarApi
etiketini kaldırır- Satır ikincil işlemlerinden ve süslemelerden
@ExperimentalCarApi
ek açıklamayı kaldır (I8487e) TabTemplate
öğesine etkin sekme içerik kimliğini ekler ve sekmelerdeki etkin durumunu kullanımdan kaldırır (I96932)GridTemplate
alanına (Ibf431)ItemImageShape
mülkü ekleyinGridTemplate
öğesineItemSize
özelliğini ekleyin. Bu özellik, göreli küçük, orta ve büyük gruplara göre ızgara öğesi boyutunu kontrol eder. (Icdb3b)- Geçerli ekran yığınının bir kopyasını almak için geliştiriciler için API erişimini açın. (I48107)
- Araba Uygulama Kitaplığı'na hava durumu uygulamaları için kategori ekler (I2be44)
- Araba Uygulama Kitaplığı'na (Icab33) uygulama aramak için kategori ekler.
GridItem.Builder#setBadge()
, aşırı yüklenmişsetImage()
yöntemleriyle değiştirildi (Id2000)- Rozete simge özelliği ekle (I629b2)
- Nokta rozeti arka plan rengini ayarlama yöntemi ekleyin (I6411c)
GridItem
resmine rozet özelliği ekleyerekGridItem
resminin üzerinde rozetin görüntülenmesini sağlayın. (I95de7)- Bir resmin üzerinde görüntülenecek rozeti temsil edecek deneysel bir Rozet nesnesi eklendi. (I9878d)
Sürüm 1.4.0-alpha01
22 Şubat 2023
androidx.car.app:app-*:1.4.0-alpha01
yayınlandı. Sürüm 1.4.0-alpha01 bu kayıtları içerir.
API Değişiklikleri
- Araba Uygulama Kitaplığı'nda
GridTemplate
öğesine üst düzey işlemler ekler (Id0191) - Araba Uygulama Kitaplığı'nda (I9efab)
ListTemplate
öğesine üst düzey işlemler ekler - Bir medya öğesinin alt başlığını veya açıklamasını diğer medya öğelerine bağlamak için ekstra özellikler ekleyin (Ic84bf)
- Satır işlemlerinin API düzeyini 6. düzeye güncelleyin. (Ie0a69)
- A4C'ye mesajlaşma geri çağırmaları ekleme (Ie3986)
Hata Düzeltmeleri
CarMessage
için eksik Java dokümanı referanslarını ekleyin. (I5db1c)ConversationItem
veCarMessage
içinequals()
vehashCode()
değerlerini geçersiz kıl (I6fd10)ConversationItem.mMessages
doğrulamasını iyileştirin (null olmayan, boş olmayan öğeleri zorunlu kılın (Iafc51)ConversationItem
alana (I5d250)@Keep
ek açıklaması ekleyin- Satır süslemesi ve ikincil işlemler için Java dokümanlarını güncelleyin. (I000b6)
Sürüm 1.3
Sürüm 1.3.0-rc01
7 Aralık 2022
androidx.car.app:app-*:1.3.0-rc01
yayınlandı. Sürüm 1.3.0-rc01 bu kayıtları içerir.
- Beta01 sürümünden küçük hata düzeltmeleri. Önemli Değişiklik Yok.
Sürüm 1.3.0-beta01
7 Eylül 2022
androidx.car.app:app:1.3.0-beta01
, androidx.car.app:app-projected:1.3.0-beta01
, androidx.car.app:app-automotive:1.3.0-beta01
ve androidx.car.app:app-testing:1.3.0-beta01
yayınlandı. 1.3.0-beta01 sürümü bu kayıtları içerir.
- Bu kitaplık kullanılarak oluşturulan araba uygulamaları artık API Düzeyi 5 kullanılarak Play Store'a gidebilir (geliştirme kılavuzumuzu inceleyin). API düzeyi 5 ve altı ile ek açıklama eklenen özellikler hem Android Auto 8.1 ve sonraki sürümler hem de Google Automotive App Host 1.4 ve sonraki sürümler ile uyumludur.
Yeni Özellikler
Araba Uygulama Kitaplığı 1.3.0-alpha01 sürümlerindeki özelliklere ek olarak, beta01 kapsamında aşağıdaki özellikler de eklenmiştir (Buradaki tüm özellikler yalnızca herhangi bir API değişikliği olmadan ana makine tarafında yapılan değişiklikleri içerir):
- Kayan gezinme çubuğu, kullanıcı
PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
veMapTemplate
ülkelerinde harita tabanlı bir seçim ekranında olsa bile gösterilmeye devam eder. Bunun için navigasyon bilgileriniNavigationManager.updateTrip()
üzerinden güncelleyebilirsiniz. - Zaman aşımı animasyonu için
FLAG_DEFAULT
ile işlem düğmesini etkinleştirin. Bu düğme, zaman aşımından sonra varsayılan olarak tıklanacaktır. ([API 5 - All Templates]
) Row
alt metni, araba park edildiğinde 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 destek devre dışı bırakıldı
API Değişiklikleri
- Seçilebilir listeleri desteklemek için
MapTemplate
listesindeki kısıtlamaları gevşetin (I961ed) - Özel simgelere izin vermek için Başlık İşlemleri kısıtlamasını kaldırın. (Iad28f)
ActionsConstraints
öğesinesetOnClickListenerAllowed()
kısıtlaması ekleyin. Standart simge türleri hariç olmak üzere,Action
ürünününOnClickDelegate()
işlemini ayarlamasına izin verdiği yerler. (TYPE_APP_ICON
,TYPE_BACK
veTYPE_PAN
) (I3c745)
Hata Düzeltmeleri
- Kavisli ekranlarla Android Automotive Template Host 1.4+ ve sonraki sürümler (
[Host change]
) uyumluluğu 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ı. Sürüm 1.3.0-alpha01 bu kayıtları içerir.
API düzeyi 5 ek açıklamasına sahip özellikler, Android Auto 7.9 ve sonraki sürümlerle uyumludur.
Yeni Özellikler
- API Seviyesi 5: Gezinme uygulamaları tarafından, haritayla birlikte bölme veya içerik listelemek için kullanılabilen yeni
MapTemplate
(If5826, If44b8) - API Seviye 5: Ana aracın mikrofonundan ses girişi kaydetmeye izin veren yeni
CarAudioRecord
API'si (I5e71a) - API Level 5: Uygulamaların ana makineye öneri sağlamasına izin veren yeni
SuggestionManager
API'si (I5c103) - API Düzeyi 5:
NavigationTemplate
üzerinde bağlam bildirimlerinde gösterilecek yeniAlert
API'si (I163a7, I5ad70) - API Düzeyi 5: Şablonlar arasında yeniden kullanımı kolaylaştırmak için yeni
Header
veMapController
bileşenleri (If5826) - ÖY uygulamalarını etkinleştirmek için
androidx.car.app.category.POI
kategorisi eklendi (veandroidx.car.app.category.PARKING
ileandroidx.car.app.category.CHARGING
desteği sonlandırıldı) (I59da1)
API Değişiklikleri
- API Düzeyi 5:
SurfaceCallback
arayüzünde, harita etkileşimine dokunmaya olanak tanıyan yenionClick
yöntemi (Ia9777) - API Düzeyi 5:
Action
'leri (I96318, I5ad70) tanımlamak için yeniAction.FLAG_IS_PERSISTENT
veAction.FLAG_DEFAULT
işaretleri - API Düzeyi 5:
Action
,Row
veToggle
bileşenleri için yeni etkin/devre dışı durumu (barındırıcı desteği, kitaplığın 1.3.0-beta01 sürümünden itibaren kullanıma sunulacaktır) (Id8a09) - API Düzeyi 5: Mevcut
setTitle
vesetHeaderAction
yöntemlerini (I30e6a) kullanımdan kaldırarakPlaceListNavigationTemplate.Builder
veRoutePreviewNavigationTemplate.Builder
'dasetHeader
aracılığıyla yeniHeader
bileşenini tercih edin. - API Düzeyi 5: Yeni
OnContentRefreshListner
arayüzünün uygulamalarıyla kullanım içinPlaceListMapTemplate.Builder
vePlaceListNavigationTemplate.Builder
sayfalarında yenisetOnContentRefreshListner
yöntemi. - API Seviyesi 5: Seyahat tahmini kartını özelleştirmek için
TravelEstimate.Builder
'da yenisetTripText
vesetTripIcon
(Idcc6d, Ic620d) PaneTemplate
başlığındaCarIconSpan
için destek ekleyin (Ia1ee0)Row
başlığı ve metnineCarIconSpan
için destek ekleyin (Ic1e3c)- Harita
ActionStrip
öğeleri artık en fazla dört işlem içerebilir (If3522) - Car App API düzeyini 5 olarak güncelleyin (I26b8e)
PlaceListMapTemplate
,PlaceListNavigationTemplate
,RoutePreviewNavigationTemplate
,GridTemplate
,ListTemplate
,LongMessageTemplate
,MessageTemplate
,PaneTemplate
veSignInTemplate
(I2078d, Icadde) için başlıklar/başlıklar artık isteğe bağlı
Hata Düzeltmeleri
PaneTemplate
resim boyutlandırma kuralı, kare sınırlayıcı kutu olarak güncellendi (Idd72e)- Ekran yığını,
State.DESTROYED
tarihinden sonra değiştirilirse oluşan bir istisna düzeltildi. (I3c8eb) - Uygulama simgesini almak için null denetim eklendi (I3f710)
- Araba Donanımı API'sini varsayılan olarak
STATUS_UNAVAILABLE
yerineSTATUS_UNKNOWN
kullanacak şekilde güncelleyin (Ic9444) - Yüzey oluşturmadan önce ekranın mevcut olup olmadığını kontrol edin (Ice027a)
STATUS_UNIMPLEMENTED
ile ilgiliCarValue.equals()
hatasını düzeltin (I24451)
Sürüm 1.2
Sürüm 1.2.0
9 Kasım 2022
androidx.car.app:app-*:1.2.0
yayınlandı. 1.2.0 sürümü bu kayıtları içerir.
- Bu bir sabitleme sürümü olup 1.2.0-rc01 sürümüne kıyasla herhangi bir değişiklik yapılmamıştır.
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 kayıtları içerir.
- Bu bir sabitleme sürümüdür ve
v1.2.0-beta02
ile karşılaştırıldığında herhangi bir API değişikliği yoktur. Gelecekteki Android Auto ve Android Automotive sürümlerine yönelik olarak tasarlanan yeni deneysel özellikler (API düzeyi 5) eklenmiştir.
Hata Düzeltmeleri
- Ekran yığını,
State.DESTROYED
tarihinden sonra değiştirilirse oluşan bir istisna düzeltildi. (I3c8eb) CarSensors
API'si, AAOS için uygulanmadıklarını belirtecek şekilde güncellendi (Idd57b)- Bu özellik için ACCESS_COARSE_LOCATION değerinin yeterli olacağını belirtmek üzere
PlaceListMapTempalte.Builder#setCurrentLocationEnabled
güncellendi (I510c2) - Açılı döner manevra türleri için çıkış numarası isteğe bağlı hale getirildi (Ife7d1)
Sürüm 1.2.0-beta02
26 Ocak 2022
androidx.car.app:app-*:1.2.0-beta02
yayınlandı. Sürüm 1.2.0-beta02 bu kayıtları içerir.
Android Automotive OS
platformunu hedefleyen bu kitaplık sürümüyle oluşturulan araba uygulamaları artık Play Store açık test kanalında yayınlanabilir. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API düzeyi 4 ve önceki sürümleriyle belirtilen ek açıklamalar 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'si eklendi (I6bf22)
Hata Düzeltmeleri
- Araba ana makinesinin bağlantısını kestiğinde
CarAppService
içinde oluşan bellek sızıntısı düzeltildi. (I5c9ca, b/203594731) CarAppActivity
javadoc, singleTask launchmode (Id2f95) gereksinimlerini içerecek şekilde güncellendi- Öz geçmiş verilerde yaşanan görsel aksaklıkları azaltır. (Iff7e0)
Bilinen Sorunlar
PlaceListNavigationTemplate
veRoutePreviewNavigateTemplate
içindekiActionStrip
haritaları sonrakiAndroid Auto
veAndroid Automotive OS
sürümlerinde kullanılabilir hale gelecek.
Sürüm 1.2.0-alpha02
15 Aralık 2021
androidx.car.app:app-*:1.2.0-alpha02
yayınlandı. Sürüm 1.2.0-alpha02 bu kaydetmeleri içerir.
PlaceListNavigationTemplate
ve RoutePreviewNavigateTemplate
haritalarındaki ActionStrip
öğeleri, Pane
saniyelerindeki CarIcon
resmi, QRCodeSignInMethod
ve Action
saniyelerinde oluşturma ipuçları (ör. bayraklar) ayarlama özelliği dahil olmak üzere, API düzeyi 4 ek açıklaması bulunan özellikler deneme aşamasından mevcut ürün sürümüne geçirildi.
Yeni Özellikler
- Android Auto 7.1 ve sonraki sürümlerde
Pane
için öğe sınırı 2'den 4'e çıkarılmıştır.
API Değişiklikleri
CarUnit
öğesine deneysel birtoString()
yöntemi eklendi(I36a3b)
Hata Düzeltmeleri
- Geri çağırma sona erdiğinde
CarAppPermissionActivity
içinde meydana gelen 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 kayıtları içerir.
Tüm yeni v1.2.0
özellikleri (API 4+) şu anda gelecekteki Android Auto ve Android Automotive OS sürümlerini hedeflemektedir. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API Değişiklikleri
AutomotiveCarInfo
API deneysel hale getirildi. (Ia13e5)- Car App Library API seviye 4 eklendi (I2a2e7)
- API Düzeyi 4:
Pane
öğesindeCarIcon
ayarlama desteği (Ifcc12) - API Düzeyi 4: QR kodu oturum açma yöntemi eklendi (Ib623e)
- API Düzeyi 4:
Action
öğesine set/getFlags eklendi (Ic03ab) - API Düzeyi 4:
PlaceListNavigationTemplate
veRoutePreviewNavigationTemplate
ürünlerinde kaydırma ve yakınlaştırma desteği eklendi (I9d8a3)
Hata Düzeltmeleri
- API Düzeyi 4: Uygulamaların, araba ana makinesine konum güncellemeleri göndermesine izin veren 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ı. Sürüm 1.1.0 bu kayıtları içerir.
Bu bir sabitleme sürümü olup v1.1.0-rc01
ile karşılaştırıldığında hiçbir değişiklik yapılmamıştır. Araba uygulama kitaplığındaki yeni özelliklerle ilgili daha fazla ayrıntı için v1.2.0-alpha02
sürüm notlarına da bakın.
1.0.0 sürümünden sonraki önemli değişiklikler
- API Düzeyi 2: Araç park edildiğinde oturum açma akışları için kullanılabilecek
SignInTemplate
veLongMessageTemplate
- API Düzeyi 2:
NavigationTemplate
içindeki harita etkileşimi desteği - API Seviyesi 2: Uygulamaların, araba ekranı boyutlarına göre görüntülemek üzere birden fazla dize sürümü sağlamasına izin veren birden fazla uzunlukta metin desteği.
- 3. API Düzeyi:
CarHardwareManager
Model, 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 kayıtları içerir.
Bu bir sabitleme sürümüdür ve v1.1.0-beta01
ile karşılaştırıldığında herhangi bir API değişikliği yoktur. Gelecekteki Android Auto sürümleri için tasarlanmış yeni deneysel özellikler (API düzeyi 4) eklenmiştir. Deneysel API'ler hakkında daha ayrıntılı bilgi edinmek 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 kayıtları içerir.
Tüm v1.1.0
özellikleri (API 2+), Android Auto 6.7 ve sonraki sürümlerle tamamen uyumludur. Daha fazla ayrıntı için geliştirme kılavuzuna bakın.
API Değişiklikleri
Manager
, herkese açık arayüz olarak kaldırıldı (Ie381b)- İzin isteği için markalı arka plan ayarlama özelliği eklendi (I74b76)
ScreenManager.getStackSize
eklendi (I0b16a)- Açıkça
TestCarContext
değerini alanScreenController
oluşturucu kaldırıldı (Iefebc)
Hata Düzeltmeleri
CarHardwareManager
oluşturulurken API düzeyi kontrolü eklendi (I48f9b)- API'de geçersiz
CarSpan
kullanımıyla ilgili kontroller eklendi (I65ae6) - Bir
Screen
öğesi, oluşturma sırasında tamamlandı olarak işaretlenirse yığını bozuk bir durumda bırakır (I81b13) CarAppExtender
(I3633d) içinde simge içeren işlemler varsaCarNotificationManager.notify
aracının AutomotiveOS için hata kaydetmesine neden olan sorunu düzeltin- API sürümü oluşturmak üzere uygulama ve ana makine için el sıkışma yöntemi eklendi (I7d6f8)
Sürüm 1.1.0-alpha02
21 Temmuz 2021
androidx.car.app:app-*:1.1.0-alpha02
yayınlandı. Sürüm 1.1.0-alpha02 bu kaydetmeleri içerir.
Yeni Özellikler
- API Düzeyi 3: Model ve marka, yakıt seviyeleri ve diğer sensörler gibi aracın donanım verilerini sorgulamak için kullanılabilecek bir
CarHardwareManager
eklendi. Şu anda bu özellik yalnızca açık test kanalındaki Android Auto 6.7 ve sonraki sürümlerde kullanılabilir. Bunu masaüstü ortamında test etmek için ayrı olarak yayınlanacak yeni birDesktop Head Unit
sürümü gerekiyor. Yeni sürümün ne zaman kullanıma sunulacağıyla ilgili ayrıntılar için Arabalar için Android uygulamalarını test etme sayfasından takip etmeye devam edin. - Bu özelliklerin API düzeyi 3 ile uyumlu araç barındırıcılarında nasıl kullanılacağıyla ilgili ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzunu ve kitaplık referansını takip edin.
API Değişiklikleri
SessionController
veScreenController
yaşam döngüsü yöntemleri tek birmoveToState
yönteminde (I1ed00) birleştirildiCarContext#getHostInfo()
eklendi (I8977e)- Kullanımdan kaldırılan alanlar kaldırıldı. (I67168)
- Oluşturucuları doğrudan kullanıma sunmak için
SessionController
veScreenController
güncellendi (Iabf22) PinSignInMethod.Builder
veProviderSignInMethod.Builder
(I9f0cb) kaldırıldı- AAOS'de "sonuç için" şablonlu uygulamaları kullanmayı etkinleştirmek üzere "setCarAppResult()" eklendi (I37741)
@MainThread
ile ek açıklamalıCarHardware
arayüzleri. (Ib2f85)OnCarDataListener
adlı dosyaOnCarDataAvailableListener
(I518ca) olarak yeniden adlandırıldıCarInfo
,Speed
,Mileage
yöntem adları ve javadoc güncellendi. (I86672)Toll
adlı dosyaTollCard
olarak yeniden adlandırıldı. (I3e7c8)- Kullanımdan kaldırılan
PinSignInMethod.getPin
kaldırıldı ve yeriniPinSignInMethod.getPinCode
aldı (I996ce) OnInputCompletedListener
kaldırıldı (InputCallback
ile değiştirildi). (Ib5be1)PinSignInMethod
,String
yerineCharSequence
olarak değiştirildi (I275d5)
Hata Düzeltmeleri
- Araba donanımı için Javadoc düzeltmeleri. (I2abbc)
Harici Katkı
Bilinen Sorunlar
SignInTemplate
içindeInputSignInMethod
kullanılması, araba ana makinesindeNullPointerException
gönderilmesine neden olabilir. Bu sorun, kitaplığın bir sonraki sürümünde ele alınacaktır. Sorunu geçici olarak çözmek için uygulamanızın ProGuard yapılandırmasına şu satırı ekleyin:-keep class androidx.car.app.model.signin.InputSignInMethod { *; }
Sürüm 1.1.0-alpha01
16 Haziran 2021
androidx.car.app:app:1.1.0-alpha01
, androidx.car.app:app-automotive:1.1.0-alpha01
ve androidx.car.app:app-testing:1.1.0-alpha01
yayınlandı. Sürüm 1.1.0-alpha01 bu kayıtları içerir.
Yeni Özellikler
- API Düzeyi 2: Araç park edildiğinde oturum açma akışları için kullanılabilecek yeni
SignInTemplate
veLongMessageTemplate
. - API Düzeyi 2:
NavigationTemplate
içinde yeni harita etkileşimi desteği - API Seviyesi 2: Uygulamaların, araba ekranı boyutlarına göre görüntülemek üzere birden fazla dize sürümü sağlamasına izin veren, birden çok uzunlukta yeni metin desteği.
- Bu özelliklerin API düzeyi 2 ile uyumlu araç barındırıcılarında nasıl kullanılacağıyla ilgili ek ayrıntılar ve tasarım yönergeleri için geliştirme kılavuzuna ve kitaplık Javadoc'a göz atın.
API Değişiklikleri
*Callback
arayüz yöntemlerinin tümü varsayılan yapıldı veOnRequestPermissionsCallback
->OnRequestPermissionsListener
(Ib3ec9) olarak yeniden adlandırıldı- Gereksiz derleyicileri ve parametre sınıflarını kaldırmak için
androidx.car.app.hardware
sınıfları güncellendi. (I67beb) - Yakıt, pil ve hız gibi araca özel verilere erişim için
androidx.car.app.hardware
sınıfı eklendi. (Iff3c9) MessageTemplate
cihazınaActionStrip
desteği eklendi (Ida657)setLoading
,MessageTemplate
koleksiyonuna eklendi. (I2a4b5)ConnectionToCar
adlı dosyaCarConnection
olarak yeniden adlandırıldı (Ife9bd)NavigationTemplate
, açık birPanModeDelegate
döndürecek şekilde değiştirildi (I13877)CarContext.requestPermissions
(Ib890a) için parametre sırası güncellendi- Meta veri anahtarı, minimum araba API'si seviyesini
androidx.car.api.minCarApiLevel
olarak tanımlamak için güncellendi (Ib0d41) - 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 ve kaydırma moduAction
türü (Ica6af) eklendi- Arabada bildirim göndermeyi desteklemek için
CarNotificationManager
oluşturuldu (I10d7a) - Ana makineden (I8690e) liste sınırları sağlanması için
ConstraintManager
eklendi NavigationTemplate
uygulamasına kaydırma modu ve harita işlem şeridi API'si eklendi (I77aa6)- Gezinme uygulamaları için
SurfaceCallback
uygulamasına kaydırma ve yakınlaştırma API'si eklendi (Id5e9d) CarAppApiLevel
, 2 olarak güncellendi (Ic1540)CarAppService
(I5421e) cihazından izin isteme olanağı eklendi- Çok metinli API'ye (Iacb62)
RequiresCarApi(2)
notu eklendi - Yarım liste şablon başlığında birden çok metin varyantına izin veriliyor (Ib8df7)
- Yeni
LongMessageTemplate
eklendi (Car API düzey 2 gerekir) (Ic5cee)
Hata Düzeltmeleri
- Resim boyutu şartları, daha büyük araba ekranlarını dikkate alacak şekilde güncellendi (I116dc)
- Şablon gövdelerine 2'den fazla işlem eklenmesine izin verilmiyor (I32157)
- Araba uygulama kitaplığında oluşturulan tüm
PendingIntent
öğelerinin bayrakların ayarlanmasını sağladık. (If84fe, b/186394900) - Javadoc güncellendi,
Row
metninin yenilemelerde değiştirilmesine izin verin (If3f9c) androidx.activity:activity:1.2.0
artık bir API bağımlılığı (Id1cb9)SignInTemplate
veLongMessageTemplate
, gövdelerinde yalnızca park halindeyken işlem yapılmasını zorunlu kılacak şekilde oluşturuldu ve bunların yalnızca araba park edildiğinde (Iddaa9) gösterileceğini belirten dokümanları güncelle- Başlatılırken
Screen
açılırken oluşan istisna düzeltildi (Ifcf40, b/184664896) ForegroundCarColorSpan
içinde izin verilen özel metin rengi (I69e59)Screen
öğesininON_DESTROY
öğesinden sonraSession
üzerindeON_DESTROY
gözlemlenmesiyle ilgili sorun düzeltildi (I52e01, b/183696617)TravelEstimate
için kalan süre bilinmeyen bir zamana ayarlandığında javadoc'un güncellenmesine izin veriliyor. (I99610, b/183632456)Action
, başlıkta ve herhangi bir özel arka plan rengindeForegroundColorSpan
özelliğini destekleyecek şekilde güncellendi (I578e4)- Yürütücü yürütülmeden önce geri çağırma temizlenirse
NavigationManagerCallback#onStopNavigation
kodunu çalıştırmayın (I7fc5e, b/181143772) - Uygulamanın,lifecycle-common-java8 (I8b8c8) bağımsız değişkenine açık bir şekilde bağımlı olmasını gerektiren bir sorun düzeltildi.
Bilinen Sorunlar
- Kullanıcı, girişi onaylamak istediğinde
SignInTemplate
dokunmatik klavyede "enter" simgesi yerine "arama" simgesi gösterilir. Geçici bir çözüm olarak kullanıcılar, giriş alanı odaktayken etkinleştirilen telefon klavyesine erişebilir. - Android Auto sürüm 6.5'te,
SurfaceCallback
ürünündeki kaydırma ve yakınlaştırma geri çağırmaları bazı dokunma hareketleri için yanlış bir şekilde çağrılabilir.
Araba Uygulaması Test Sürümü 1.0.0
Sürüm 1.0.0-alpha01
24 Mart 2021
androidx.car.app:app-testing:1.0.0-alpha01
yayınlandı. Sürüm 1.0.0-alpha01 bu kayıtları içerir.
Bu, daha önce kapalı kaynak test kitaplığının ilk Jetpack sürümüdür. Bu kitaplığı testlerinizde nasıl kullanacağınızla 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ını sağlayan herkese açık API yüzeyinin bir parçasıdır.
- Önceki
CarAppServiceController
, hotspot bağlantısının ömrü ile ilgili mantığı test etmek için yeniSessionController
ile değiştirildi.
Sürüm 1.0.0
Sürüm 1.0.0
21 Nisan 2021
androidx.car.app:app:1.0.0
yayınlandı. 1.0.0 sürümü bu kayıtları 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
kullanarak üretim kanalında yayınlanmaya 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 etme ve şarj uygulamaları oluşturma hakkında ayrıntılı bilgi edinmek üzere geliştirme kılavuzundaki talimatları uygulayın.
Hata Düzeltmeleri
- Başlangıç sırasında
Screen
açılırken oluşan istisna düzeltildi (70aae1, b/184664896) Screen
öğesininON_DESTROY
öğesinden sonraSession
üzerindeON_DESTROY
gözlemlenmesiyle ilgili sorun düzeltildi (0ceecb, b/183696617)
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 kayıtları içerir.
Hata Düzeltmeleri
- Geri çağırma temizlendikten sonra
NavigationManagerCallback#onStopNavigation
çağrısının yapılmasına neden olan bir yarış durumu hatası düzeltildi. Bu durum, geri çağırma yürütücüsü gerçekten çalıştırılmadan önce geri çağırmanın temizlenmesi durumunda gerçekleşti (I7fc5e, b/181143772) - Uygulamanın açıkça
lifecycle-common-java8
(I8b8c8) ürününe bağımlı olmasını gerektiren bir sorun düzeltildi - Uygulama bir geri çağırmayı (Ib8b89, b/181143772) kaldırmışken bir
stopNavigation
çağrısı aldığında oluşanNullPointerException
sorunu düzeltildi - Kullanım ömrü en az
CREATED
durumunda değilse çağrıları uygulamaya göndermemeyle ilgili iyileştirmeler (I86965, b/179800224, b/177921120) - Uygulamanın manifest dosyasında belirtilen geçersiz bir minimum API'nin bildirim göndererek ana makinede ANR'ye neden olması 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ı. 1.0.0-beta01 sürümü bu kayıtları içerir.
Bu sürüm, daha önce kapalı olan 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ı derlemeyle ilgili ayrıntılar için geliştirme kılavuzundaki adımları uygulayın.
Yeni Özellikler
- Uygulamanızın, kullanıcı arayüzü öğelerinin listesini ızgara düzeninde göstermek için kullanabileceği bir
GridTemplate
kullanıma sunuldu. - Ana makine bağlantısının güvenilir bir kaynaktan (örneğin, 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
öğesinin devam ettirilmesine neden olan sorun düzeltildi. (b/177590791)