Android için Sürücü SDK'sı Sürüm Notları

Bu bölümde, Android için Driver SDK'sı sürüm notları yer almaktadır.

Duyuru: API düzeyi 23, 24 ve 25 için destek durduruluyor

Mobil OS sürümü destek politikası uyarınca, Android için Driver SDK'sının gelecekteki büyük sürümlerinde Android 6 ve 7 (API düzeyi 23, 24 ve 25) için desteği askıya alıyoruz.

2025'in dördüncü çeyreğinden itibaren kullanıma sunulan Android için Sürücü SDK'sı sürümleri en az Android 8'i (API düzeyi 26) destekleyecektir. Önceki SDK sürümleri Android 6 ve 7'yi desteklemeye devam edecektir.

Bağımlılıklarınızda bir sürüm numarası belirtilmezse IDE'niz en yeni SDK sürümünü yükler ve uygulamanızın yeni derlemeleri Android 6 ve 7'yi desteklemez.

Uygulamanızın yeni sürümleri için desteklenen minimum işletim sistemini ne zaman yükselteceğinizi kontrol etmek amacıyla, uygulamanızın derleme bağımlılıklarına Android için Sürücü SDK'sının bir sürümünü belirtin.

v6.0.0 (25 Kasım 2024)

Hata düzeltmeleri

• Sürücülerin "INTERNAL" kodu ve "Panic! Bu bir hata!" açıklaması.
• Özellikle cihaz ağ değiştirirken konum güncelleme bağlantı hatalarını azaltmak için yapılan dahili iyileştirme. Bu özellik, sürüm entegre edildikten sonra kademeli olarak kullanıma sunulacaktır (%0'dan başlayarak).

API güncellemeleri

• Desteği sonlandırılan StatusListener arayüzü kaldırıldı.

Bağımlılık ve yapılandırma değişiklikleri

• POM.xml dosyasından glide:cronet-integration bağımlılığını kaldırın
• Navigasyon SDK'sı desteklenen aralıktaki sürümler v5.x olarak güncellendi.
• Android için Sürücü SDK'sının 6.0.0 sürümünden itibaren uygulamaların Kotlin 2.0'a yükseltilmesi gerekir.
• targetSdk artık API düzeyi 34'tür. Bu, Ağustos 2024'ten itibaren Google Play Store'da dağıtılan tüm uygulamalar için zorunludur. Google Play'in hedef API düzeyi şartını karşılama başlıklı makaleyi inceleyin.

5.99.0 sürümü (20 Eylül 2024)

Hata düzeltmeleri

• Sürücülerin "INTERNAL" kodu ve "Panic! Bu bir hata!" açıklaması. Bu özellik, sürüm entegre edildikten sonra kademeli olarak (%0'dan başlayarak) kullanıma sunulacaktır.
• Özellikle cihaz ağ değiştirirken konum güncelleme bağlantı hatalarını azaltmak için yapılan dahili iyileştirme. Bu özellik, sürüm entegre edildikten sonra kademeli olarak kullanıma sunulacaktır (%0'dan başlayarak).

Bağımlılık ve yapılandırma değişiklikleri

• POM.xml dosyasından glide:cronet-integration bağımlılığını kaldırın

v5.0.0 (12 Eylül 2023)

Bağımlılık ve yapılandırma değişiklikleri

• Navigasyon SDK'sı 5.x sürümüne güncellendi.
• minSdkVersion API 23'e yükseltildi.
• Kotlin sürümü 1.9.0'a yükseltildi.
• Room bağımlığı eklendi. * Sürücü SDK'sını kullanan uygulamalar artık API 31 veya targetSdkVersionüstü sürümlere sahip olmalıdır.
• Driver SDK'sını kullanan uygulamalar artık Java 8 kitaplık desteğini etkinleştirmelidir. Güncelleme talimatları için https://developer.android.com/studio/write/java8-support adresine bakın.
• ProGuard veya Dexguard kullanan uygulamalar R8'e taşınmalıdır. Daha fazla bilgi için https://developer.android.com/build/shrink-code adresini ziyaret edin.
• Driver SDK'sını kullanan uygulamalarda şeker azaltma işlemi etkinleştirilmelidir. Talimatlar için https://developer.android.com/studio/write/java8-support#library-desugaring adresine bakın.

Hata düzeltmeleri

• disableLocationTracking senkronizasyonuyla ilgili sorun düzeltildi.
• İstisna durum güncellemelerinde nedeni bildiren yeni DriverStatusListener arayüzü kullanıma sunuldu.
• Sabit duran sürücülerle ilgili sorun düzeltildi (4.99.0 sürümünden itibaren kullanılabilir).

4.99.0 sürümü (9 Ağustos 2023)

• NavSDK bağımlılığı için çeşitli sürümleri destekleyin. ** 4.5.0 ile 5.0.0 (dahil değil) arasındaki sürümleri destekler.
• Araç hareketsizken tahmini varış süresinin kendi kendine azalmasını önleyin. Bu değişiklik, deneme olarak kademeli olarak kullanıma sunulur. Bu nedenle, tüm uygulamalarda aynı anda görülmez.

4.5.0 sürümü (12 Mayıs 2023)

• Navigasyon SDK'sı bağımlılığını 4.5 sürümüne güncelleyin. Navigasyon SDK'sı için grup ve yapı kimliklerinin değiştiğini unutmayın.

4.4.3 sürümü (20 Mart 2023)

Bağımlılık değişikliği

• Navigasyon SDK'sı bağımlılığını v4.4.1 sürümüne yükseltin.

v4.4.2 (15 Şubat 2023)

Hata düzeltmeleri

• SDK geçici bir bağlantı sorunuyla karşılaştığında ağ kurtarma süresini iyileştirin. Bu deneysel bir düzeltmedir.

• Yalnızca "Ham" konum içeren UpdateVehicle isteklerini yok sayma.

• "Rota Özetine Genel Bakış" ALPHA API'sinde yarış koşulu düzeltildi.

v4.4.1 (18 Kasım 2022)

Hata düzeltmeleri

• Trafik yükleme mantıkındaki bir hata düzeltildi.

Ek değişiklikler

• İstek üst bilgilerinde ve durum kodu raporlamasında dahili iyileştirmeler.

4.4.0 sürümü (21 Eylül 2022)

Hata düzeltmeleri

• API örneği temizlenmemişse "Google Haritalar ile sürüş" bildiriminin kaldırılmasını engelleyen bir hata düzeltildi.

Bağımlılık değişikliği

• Navigasyon SDK'sı bağımlılığını 4.2.2 sürümüne yükseltin.

v4.3.0 (24 Ağustos 2022)

Dahili iyileştirmeler.

Duyuru: Android 5 için destek sonlandırılıyor (21 Temmuz 2022)

En son SDK sürümümüz (4.2.0) için Android 5'te çalışan uygulamalara hem API düzeyi 21 hem de 22 için ek bir yıl destek sunuyoruz.

Bu ne anlama geliyor?

• Android uygulamalarınızda çalışan Navigation SDK ve Driver SDK, 30 Haziran 2023'e kadar minimum Android 5 (API düzeyi 21) sürümünü destekleyecektir.
• 30 Haziran 2023'ten sonra yalnızca Android API düzeyi 23 ve sonraki sürümler desteklenecektir. Diğer bir deyişle, bu tarihten sonra tüm SDK sürümlerinde Android API düzeyi 21 ve 22'yi desteklemeyi bırakacağız. Bu, 4.x dahil olmak üzere herhangi bir SDK sürümünde Android 21 veya 22 ile ilgili hataların düzeltilmeyeceği anlamına gelir ve SDK'ların doğru şekilde çalışacağını garanti edemeyiz.

Bu bildirim, 21 Haziran 2021 tarihli Android 21 ve 22 destek dondurma bildirimini ve 18 Ekim 2021 tarihli Android 23, 24 ve 25 destek dondurma bildirimini geçersiz kılar.

v4.2.0 (8 Haziran 2022)

Bağımlılık değişikliği

• Nav SDK'sının bağımlılığını v4.1.3'e yükseltin.
• Desteklenen minimum Android API düzeyini 21'e düşürür.

4.1.0 sürümü (28 Nisan 2022)

API güncellemeleri

• Task nesnesinin parentId özelliğinin adı trackingId olarak değiştirildi. Eski mülk şu anda hâlâ mevcut olsa da desteği sonlandırılmıştır.

v4.0.0 (29 Kasım 2021)

Bu sürüm için desteklenen minimum Android API düzeyi 23'tür.

API güncellemeleri

Bu sürümde Android için Sürücü SDK'sı aşağıdaki değişikliklerle güncellendi.

VehicleStops API değişikliği

VehicleStop nesneleri artık Task nesnelerinin listesi yerine TaskInfo nesnelerinin listesine referans veriyor. Görev durumuna ihtiyacınız varsa bunu uygulama kodunuzda izlemeniz önerilir.

• Yeni bir sınıf eklendi: TaskInfo

• VehicleStop'nin getTasks işlevi, getTaskInfoList işleviyle değiştirildi.

• VehicleStop.Builder'nin setTasks işlevi, setTaskInfoList işleviyle değiştirildi.

Kilitlenme izleme

SDK kararlılığını iyileştirmeye yardımcı olmak için kilitlenme izleme ve raporlama özelliği eklendi. Bu özellik varsayılan olarak etkindir ancak SDK'yı başlatmadan önce setAbnormalTerminationReportingEnabled() işlevini çağırıp işleve false değerini iletirseniz devre dışı bırakabilirsiniz.

• DriverApi'a setAbnormalTerminationReportingEnabled işlevi eklendi.

Async getRemainingVehicleStops

• DeliveryVehicleReporter'un getRemainingVehicleStops işlevi, List<VehicleStop> yerine Future<List<VehicleStop>> döndürecek şekilde değiştirildi.

Kimlik doğrulama

Gereksiz mülkler AuthTokenContext arayüzünden kaldırıldı. ServiceType desteği sonlandırıldı. Artık ServiceType yerine yalnızca dahil edilen araç kimliği ve görev kimliği için hak talebinde bulunmanız yeterlidir.

• ServiceType, AuthTokenContext'den kaldırıldı.

• getServiceType(), AuthTokenContext'den kaldırıldı.

• setServiceType, AuthTokenContext.Builder'den kaldırıldı.

18 Ekim 2021 - API düzeyi 23, 24 ve 25 için desteğin durdurulması

3.0.4 sürümü (28 Temmuz 2021)

Özellikler

Bu sürümle birlikte Sürücü SDK'sı, Navigasyon SDK'sından resmen ayrıldı. Ayrıntılar için taşıma kılavuzuna bakın.

API güncellemeleri

Aşağıdaki yöntemler eklendi:

`RidesharingDriverApi.getDriverSdkVersion()`

Kararlılık ve hata düzeltmeleri

PERMISSION_DENIED hatalarını bağlantı hatası olarak sınıflandırmak yerine bildirin.

Kullanımdan kaldırma duyurusu (21 Haziran 2021)

Bu duyuruda, yukarıda belirtilen tarihten itibaren Android için Sürücü SDK'sı ve Android için Navigasyon SDK'sı'nın desteğinin sonlandırılması açıklanmaktadır. Bu duyuru, etkilenen müşterilere zorunlu hizmet duyurusu (MSA) olarak da gönderildi.

Android için Nav/Driver SDK'sı, Android için Navigation SDK'sı v3.x ve Android için Driver SDK'sı v3.x (bölünmüş ikili dosyalar) olacak

Müşteri entegrasyonunu basitleştirmek ve faydalı özellikler sunma hızımızı artırmak için Android için Navigasyon SDK'sını ve Android için Sürücü SDK'sını iki farklı ikili dosyaya ayırıyoruz:

• Sürücülerinize navigasyon/rota oluşturma işlevi sunan Android için Navigasyon SDK'sı.
• Android için sürücü SDK'sı: Gezi veya görev ilerleme durumu ve tahsisi için Fleet Engine durum bilgisine sahip web hizmetlerinden yararlanmanıza olanak tanır.

Android için Sürücü SDK'sının, temel rota oluşturma işlevleri için Android için Navigasyon SDK'sına bağımlı olduğunu lütfen unutmayın.

Değişiklikler nelerdir?

3. sürümdeki önemli değişiklikler şunlardır:

• Bir yerine iki ikili dosya.
• Android için Sürücü SDK'sı sınıfları için daha net paket tanımları.
• Android için Navigasyon SDK'sı, Android için Haritalar SDK'sını paketin bir parçası olarak içerir (Android için Navigasyon SDK'sı 2 sürümü itibarıyla).
  • Bu, harita ve navigasyon özelliklerinin aynı haritada birlikte var olmasını sağlar (ör. NavigationView'da çoklu çizgi çizme) ve iki harita yerine tek bir harita kullanıldığından bellek kullanımını azaltır.
  • Android için Navigasyon SDK'sı 3.0, Android için Navigasyon SDK'sıyla tam özellik eşleşmesine sahip değildir ancak 3.2 sürümü bu sorunların çoğunu çözecektir. Ayrıntılı bilgi için Ne yapabilirim ve ne zaman yapabilirim? başlıklı makaleyi inceleyin.
• Karşılaşabileceğiniz sorunları daha kolay hata ayıklayabilmemiz için günlük kaydı.

Aşağıdaki yöntemler de daha önce kullanımdan kaldırıldı olarak işaretlenmiş ve alternatif bir çözümü olan v3'ten kaldırılmıştır:

• Aşağıdaki Nav/Driver SDK yöntemlerinin desteği 10 Ağustos 2020'de yayınlanan 1.16 sürümünde sonlandırıldı ve 3.0 sürümünde kaldırıldı:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Tamlık ve netlik açısından, 1. sürümden 2. sürüme geçişte bazı yöntemlerin kaldırıldığını unutmayın. Bunların çoğu, Android için Navigasyon SDK'sı ile Android için Haritalar SDK'sı arasındaki yinelenen sınıfların birleştirilmesinden oluşuyordu. Bu değişiklikleri daha iyi anlamak için lütfen taşıma kılavuzuna bakın.

Android için Sürücü SDK'sı ve Android için Navigasyon SDK'sı v1.x desteğinin sonlandırılması

Nav/Driver SDK'sının 1. sürümü 2018'de yayınlandı. 3. sürümlerimiz yakında kullanıma sunulacak. Bu nedenle, birçok ana sürümü desteklemenin sürdürülebilir olmaması nedeniyle 1. sürümün desteğini sonlandırmanın zamanı geldi.

Bu ek sürümü desteklemek zorunda kalmadığımız için kazandığımız zaman sayesinde en son büyük sürümü daha iyi destekleyebilecek ve müşterilerimiz için önemli olan daha fazla özellik geliştirebileceğiz.

Bu nedenle, Nav/Driver SDK v1.x'in desteği sonlandırıldı ve 21 Haziran 2022'den sonra SDK'nın bakımı yapılmayacak.

SDK sürümlerinde desteğin sonlandırılmasının nasıl işlediğini öğrenmek için lütfen bir dakikanızı ayırın.

Navigasyon ve Sürücü SDK'sı Android 21 ve 22 için destek sonu

1.15.3 sürümü (9 Ekim 2020)

API güncellemeleri

• Sürücü SDK'sı artık Fleet Engine API'ye gönderilen trafik güncellemeleri için Navigasyon SDK'sına abone oluyor.

Kararlılık ve hata düzeltmeleri

• gRPC çalışma zamanı kilitlenmesi düzeltildi.

v1.15.2

Özellikler

Kalıcı bildirimi durdurma özelliği eklendi. Fleet Engine örneğinde konum raporlaması durdurulursa Navigator'te rehberlik durdurulur, tüm navigasyon dinleyicileri kaydedilmez ve NavigationFragment veya NavigationView duraklatılır.

Kararlılık ve hata düzeltmeleri

• Fleet Engine örneği temizlendiğinde istisna atılmasına neden olan bir hata düzeltildi.

1.15.1 sürümü (12 Mayıs 2020)

Özellikler

1.15.0 verilerinin ön analizi, kararlı konum raporlamasında önemli iyileştirmeler olduğunu ("takılı" konumların azalması) gösterdi. Bu düzeltme yaması, geliştirilmiş konum raporlamasının devam etmesine olanak tanır. ANR sorunu bu iyileştirmelerle ilgili değildi.

Kararlılık ve hata düzeltmeleri

• Tüketici uygulamasında bazen rotanın başında düz bir çizgi gösterilmesine neden olan bir hata düzeltildi.
• SDK tarafından konumlar raporlanırken ANR'ye neden olabilecek bir hata düzeltildi. Bu durum, kilit anlaşmazlığına yol açabilecek onArrival() iyileştirmelerinden kaynaklanıyordu. Bazı durumlarda ANR'leri güvenilir bir şekilde yeniden oluşturabildik ve düzeltmelerin sorunu çözdüğünü doğrulayabildik. ANR'ler oluşturmak için değiştirilen test uygulaması, düzeltme yapıldıktan sonra ANR olmadan sekiz saat boyunca çalıştı.

v1.15.0 (23 Mart 2019)

Özellikler

• Araç konumu takibini iyileştirmek için başlangıç, rota dışı ve varış etkinliklerinde navigasyon kılavuzu durumu eklendi.
• Navigasyon durumundan bağımsız olarak yoldan yakalanan konumları almaya devam etme özelliği eklendi.
• Yoldan önce yakalanan konumlarla ilgili doğruluk gibi ek bilgiler eklendi.

Kararlılık ve hata düzeltmeleri

• navsdk için minSdkVersion değeri 19'a yükseltildi.
• Sunucu tarafı ters coğrafi kodlama başarısız olduğunda enlem/boylam yol noktası adlarının dikkate alınmamasına neden olan bir hata düzeltildi.

v1.14.2 Sürümü (2 Şubat 2019)

Özellikler

• DriverSDK'nın Fleet Engine'a 0,0 konum göndermesini engeller (daha iyi yolculuk paylaşımı ve tahsis konumu girişleri).
• Takılı kalan konum sorunlarını iyileştirmek ve yolculuk paylaşımı için yedek seçenekleri azaltmak amacıyla ek günlük kaydı.
• Aralık değişmedikçe setLocationReportingInterval() için tekrarlanan çağrılar yoksayılır.
• setReportingInterval() yönteminin javadoc'ları, bu yöntemin kullanılan aralıklara göre yüksek bir hızda tekrar tekrar çağrılmasını engellemek amacıyla güncellendi.
• Api 29 konum güvenilirliği artırıldı.

v1.13.0

Kararlılık ve hata düzeltmeleri

• Müşterilerin gradle derlemelerine eklemesi gereken bir okhttp bağımlılığı ekler.

v1.11.7 (18 Ekim 2019)

Kararlılık ve hata düzeltmeleri

• Konum güncellemeleri artık belirli bir hedef için onArrival() tetiklendikten sonra devam ediyor.
• Varsayılan bildirim (Serbest Navigasyon modunda sabit bir dize), navigasyon bildirimleri için ayarlanan renk şemasıyla eşleşir. Daha fazla bilgi için Ortak Kalıcı Bildirimler başlıklı makaleyi inceleyin.
• Gecikmeli konum güncelleme etkinliğinin, sahte bir konum güncellemesine neden olarak rotanın başında düz bir çizgi gibi kusurlara yol açtığı bir sorun giderildi.

1.11.6 sürümü (4 Ekim 2019)

API güncellemeleri

• Sürücü SDK'sının, ağ hatasından sonra konum güncellemelerini hızlı bir şekilde devam ettirmesini sağlayan bir dizi değişiklik yapıldı. Ağ bağlantısı yeniden kurulduktan sonra, planlanan bir sonraki konum güncellemesinde konum güncellemeleri tekrar başlar.

Kararlılık ve hata düzeltmeleri

• setVehicleState() şimdi hemen döndürülür. FleetEngine güncellemesi artık arka planda bir iş parçacığında gerçekleşiyor. Uygulama Yanıt Vermiyor (ANR) sorununu giderir.
• Tüketici SDK'sının eski sürümleri kullanıldığında yolculuk paylaşımı rotalarının düz çizgi olarak gösterilmesine neden olan bir sorun düzeltildi. Sürücü SDK'sı tarafından yola tek seferlik yol işaretleri eklenmediğinden emin olur.