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

Bu bölümde, Android için Sürücü SDK'sı ile ilgili sürüm notları yer alır.

v7.1.0 (14 Mayıs 2026)

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

• Jetpack DataStore bağımlılıkları eklendi: androidx.datastore:datastore-core 1.1.7 sürümü ve androidx.datastore:datastore-guava 1.2.0 sürümü.

• Kotlin bağımlılığı sürümü v2.3.0'a yükseltildi.

• Android Gradle eklentisi sürümü 8.13.2'ye yükseltildi.

• Gradle sürümü 8.13'e yükseltildi.

• Desugar kitaplık sürümü 2.1.5'e yükseltildi.

• Desteklenen Navigasyon SDK'sı sürüm aralığı [7.0, 7.3)'ten [7.0, 8.0)'a genişletildi.

v7.0.0 (5 Aralık 2025)

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

• minSdkVersion, API 26'ya yükseltildi.

• targetSdkVersion, API 36'ya yükseltildi.

• v7.0.0 sürümü de dahil olmak üzere, desteklenen Navigation SDK aralıklı sürümleri güncellendi.

v6.99.0 (5 Aralık 2025)

• Dahili iyileştirmeler

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

Mobil işletim sistemi sürümü desteği politikası uyarınca, Android için Sürücü SDK'sının gelecek büyük sürümlerinde Android 6 ve 7 (API düzeyi 23, 24 ve 25) desteğini sonlandırıyoruz.

Android için Sürücü SDK'sı, v7.0.0'dan itibaren minimum Android 8'i (API düzeyi 26) destekleyecektir. Önceki SDK sürümleri Android 6 ve 7'yi desteklemeye devam edecek.

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

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

6.2.0 sürümü (18 Haziran 2025)

Hata düzeltmeleri

• DriverStatusListener sağlanmadığında DriverApi.createInstance() çağrılırken oluşan NullPointerException kilitlenmesi düzeltildi.

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

• Android için Sürücü SDK'sının 6.2.0 sürümünden itibaren uygulamaların Kotlin 2.1'e yükseltilmesi gerekir.

• Güncellenen Navigasyon SDK'sı, v6.1.0 dahil olmak üzere bu sürümden sonraki sürümleri destekler.

v6.1.0 (10 Mart 2025)

Hata düzeltmeleri

• Dahili günlüğe kaydetme ile ilgili iyileştirmeler.

v5.99.1 (10 Ocak 2025)

Hata düzeltmeleri

• Sürücülerin "INTERNAL" kodlu gRPC hataları ve "Panic! Bu bir hata!" açıklaması, uygulamanın yüklenmesinden sonraki ilk başlatma işleminde gösteriliyor.

v6.0.0 (25 Kasım 2024)

Hata düzeltmeleri

• Sürücülerin "INTERNAL" kodlu gRPC hataları ve "Panic! Bu bir hata!" açıklaması.
• Özellikle cihaz ağ değiştirdiğinde konum güncelleme bağlantı hatalarını azaltmak için dahili iyileştirme yapıldı. Bu özellik, yayın entegre edildikten sonra kademeli olarak kullanıma sunulacak (başlangıçta %0).`

API güncellemeleri

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

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

• POM.xml dosyasında glide:cronet-integration bağımlılığını kaldırın.
• Navigation SDK'nın desteklenen sürüm aralıkları 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 itibarıyla Google Play Store'da yayınlanan tüm uygulamalar için geçerli bir şarttır. Google Play'in hedef API düzeyi şartını karşılama başlıklı makaleyi inceleyin.

v5.99.0 (20 Eylül 2024)

Hata düzeltmeleri

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

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

• POM.xml dosyasında 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

• Navigation 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ılığı eklendi. * Sürücü SDK'sını kullanan uygulamaların artık API 31 veya sonraki sürümlerin targetSdkVersion değerine sahip olması gerekir.
• Driver SDK'yı kullanan uygulamaların artık Java 8 kitaplık desteğini etkinleştirmesi gerekiyor. 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'yı kullanan uygulamalarda desugaring 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 durumu güncellemelerinde bir neden bildiren yeni DriverStatusListener arayüzü kullanıma sunuldu.
• Sürücülerin sabit kalmasıyla ilgili sorun düzeltildi (v4.99.0'dan itibaren kullanılabilir).

v4.99.0 (9 Ağustos 2023)

• NavSDK bağımlılığı için çeşitli sürümleri destekler. ** v4.5.0'dan v5.0.0'a kadar olan sürümleri destekler (v5.0.0 dahil değildir).
• Araç hareketsizken TVS'nin kendiliğinden azalmasını önleme Bu değişiklik, deneme kapsamında kademeli olarak kullanıma sunulacağından tüm uygulamalarda aynı anda görünmez.

v4.5.0 (12 Mayıs 2023)

• Navigasyon SDK'sı bağımlılığını v4.5'e güncelleyin. Navigasyon SDK'sının grup ve yapay nesne kimliklerinin değiştiğini unutmayın.

v4.4.3 (20 Mart 2023)

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

• Navigasyon SDK'sı bağımlılığını v4.4.1'e 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 silin.

• "Rota Özeti" alfa API'sindeki yarış durumu düzeltildi.

v4.4.1 (18 Kasım 2022)

Hata düzeltmeleri

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

Ek değişiklikler

• İstek başlıkları ve durum kodu raporlamasında dahili iyileştirmeler.

v4.4.0 (21 Eylül 2022)

Hata düzeltmeleri

• API örneği temizlenmediğinde "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ı v4.2.2'ye yükseltin.

v4.3.0 (24 Ağustos 2022)

Dahili iyileştirmeler.

Duyuru: Android 5 için destek donduruluyor (21 Temmuz 2022)

En yeni SDK sürümümüz (v4.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'i (API düzeyi 21) destekleyecektir.
• 30 Haziran 2023'ten sonra yalnızca Android API düzeyleri 23 ve üzeri desteklenecektir. Başka bir deyişle, bu tarihten sonra tüm SDK sürümlerinde Android API düzeyleri 21 ve 22'yi desteklemeyi bırakacağız. Bu, herhangi bir SDK sürümünde (4.x dahil) Android 21 veya 22 ile ilgili hataların düzeltilmeyeceği ve SDK'ların doğru şekilde çalışacağını garanti etmediğimiz anlamına gelir.

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

v4.2.0 (8 Haziran 2022)

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

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

v4.1.0 (28 Nisan 2022)

API güncellemeleri

• Task nesnesinin parentId özelliği, trackingId olarak yeniden adlandırıldı. Eski özellik şimdilik hâlâ mevcut ancak desteği sonlandırıldı.

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

Android için Driver SDK'sı, bu sürümde aşağıdaki değişikliklerle güncellendi.

VehicleStops API'sinde değişiklik

VehicleStop nesneleri artık Task nesne listesi yerine TaskInfo nesne listesine başvuruyor. Görev durumuna ihtiyacınız varsa bunu uygulama kodunuzda izlemeniz önerilir.

• Yeni bir sınıf eklendi: TaskInfo

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

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

Kilitlenme izleme

SDK kararlılığını artırmak 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 false değerini iletirseniz devre dışı bırakabilirsiniz.

• DriverApi'e setAbnormalTerminationReportingEnabled işlevi eklendi.

Async getRemainingVehicleStops

• Changed DeliveryVehicleReporter's getRemainingVehicleStops function to return a Future<List<VehicleStop>> instead of a List<VehicleStop>.

Kimlik doğrulama

AuthTokenContext arayüzünden gereksiz özellikler 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 adlı alandan kaldırıldı.

• getServiceType(), AuthTokenContext adlı alandan kaldırıldı.

• setServiceType, AuthTokenContext.Builder adlı alandan kaldırıldı.

18 Ekim 2021 - API düzeyi 23, 24 ve 25 için destek donduruluyor

v3.0.4 (28 Temmuz 2021)

Özellikler

Bu sürümle birlikte Driver SDK, Navigation SDK'dan resmi olarak ayrılmıştır. Ayrıntılar için taşıma rehberine 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.

Desteğin sonlandırılmasıyla ilgili duyuru (21 Haziran 2021)

Bu duyuruda, yukarıda belirtilen tarih itibarıyla Android için Sürücü SDK'sı ve Android için Navigasyon SDK'sında desteği sonlandırılan özellikler açıklanmaktadır. Bu duyuru, etkilenen müşterilere Zorunlu Hizmet Duyurusu (MSA) olarak da gönderildi.

Android için Navigasyon/Sürücü SDK'sı, Android için Navigasyon SDK'sı 3.x sürümü ve Android için Sürücü SDK'sı 3.x sürümü (ayrı ikili programlar) olarak ikiye ayrılacak.

Müşteri entegrasyonunu basitleştirmek ve faydalı özellikler sunma becerimizi hızlandı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üleriniz için navigasyon/rota işlevselliği sağlayacak Android için Navigasyon SDK'sı.
• Android için Driver SDK. Bu SDK, seyahat veya görev ilerleme durumu ve tahsis için Fleet Engine'in durum bilgisi olan web hizmetlerinden yararlanmanıza olanak tanır.

Android için Sürücü SDK'sının temel yönlendirme işlevleri için Android için Navigasyon SDK'sına bağımlı olduğunu lütfen unutmayın.

Neler değişiyor?

3. sürümdeki başlıca değişiklikler şunlardır:

• Tek bir ikili yerine iki ikili.
• Android için Sürücü SDK'sı sınıfları için daha net paket tanımları.
• Android için Navigasyon SDK'sı, paketlemenin bir parçası olarak Android için Haritalar SDK'sını içerir (Android için Navigasyon SDK'sı v2'den itibaren).
  • Bu sayede haritalar ve gezinme özellikleri aynı haritada birlikte kullanılabilir (ör. NavigationView'da çoklu çizgiler çizme) ve iki harita yerine tek bir harita kullanıldığından bellek kullanımı azalır.
  • Android için Navigasyon SDK'sı 3.0, Android için Navigasyon SDK'sı ile tam özellik eşliğine sahip değildir ancak 3.2 sürümü bu konudaki çoğu sorunu çözecektir. Daha fazla bilgi için Ne yapabilirim ve ne zaman? başlıklı makaleyi inceleyin.
• Karşılaşabileceğiniz sorunları ayıklamamızı kolaylaştıracak günlük kaydı.

Aşağıdaki yöntemler de 3. sürümde kaldırılmıştır. Bu yöntemler daha önce desteği sonlandırılmış olarak işaretlenmişti ve alternatif bir çözüm zaten mevcuttu:

• Aşağıdaki Nav/Driver SDK yöntemlerinin desteği 10 Ağustos 2020'de yayınlanan v1.16'da sonlandırıldı ve bu yöntemler v3.0'da kaldırıldı:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Eksiksiz ve net olması için, v1'den v2'ye geçişte bazı yöntemlerin kaldırıldığını belirtmek isteriz. 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ştirilmesiyle ilgiliydi. Bu değişiklikleri daha iyi anlamak için lütfen geçiş rehberini inceleyin.

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 v1, 2018'de yayınlandı. Yakında v3 sürümlerimiz yayınlanacak. Bu nedenle, birçok ana sürümü desteklemenin sürdürülebilir olmaması nedeniyle v1'i kullanımdan kaldırmanın zamanı geldi.

Bu ek sürümü desteklemek zorunda kalmayarak tasarruf ettiğimiz zaman, en son ana sürümü daha iyi desteklememize ve müşterilerimiz için önemli olan daha fazla özellik geliştirmemize olanak tanıyacak.

Bu nedenle, Nav/Driver SDK v1.x'in desteği sonlandırılmıştır ve 21 Haziran 2022'den sonra bu sürüm için bakım yapılmayacaktır.

Lütfen SDK sürümlerinde desteğin sonlandırılmasının nasıl çalıştığını inceleyin.

Navigation ve Driver SDK Android 21 ve 22 için desteğin sonu

v1.15.3 (9 Ekim 2020)

API güncellemeleri

• Driver SDK artık trafik güncellemeleri için Navigation SDK'sına abone oluyor. Bu güncellemeler Fleet Engine API'ye gönderiliyor.

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. Filo Motoru örneğinde konum raporlama durdurulursa Navigator'da yol tarifi durdurulur, tüm gezinme dinleyicilerinin kaydı silinir ve NavigationFragment veya NavigationView duraklatılır.

Kararlılık ve hata düzeltmeleri

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

v1.15.1 (12 Mayıs 2020)

Özellikler

1.15.0 verileriyle ilgili ön analiz, kararlı konum raporlamasında önemli iyileşmeler olduğunu (konumların "takılma" durumunda azalma) gösterdi. Bu yama düzeltmesi, geliştirilmiş konum raporlamanın devam etmesine olanak tanır. ANR sorunu bu iyileştirmelerle ilgili değildi.

Kararlılık ve hata düzeltmeleri

• Rotanın başlangıcında bazen tüketici uygulamasında düz bir çizginin gösterilmesine neden olan bir hata düzeltildi.
• SDK tarafından konumlar bildirilirken ANR'ye neden olabilecek bir hata düzeltildi. Bu durum, kilit çekişmesine duyarlı onArrival() iyileştirmesinden kaynaklandı. Bazı durumlarda ANR'leri güvenilir bir şekilde yeniden oluşturabildik ve düzeltmelerin sorunu çözdüğünü doğrulayabildik. ANR'leri üretmek için değiştirilen test uygulaması, düzeltmeden sonra sekiz saat boyunca ANR olmadan çalıştı.

v1.15.0 (23 Mart 2019)

Özellikler

• Araç konum takibini iyileştirmek için başlangıç, rota dışı ve varış etkinliklerinde navigasyon rehberliği durumu eklendi.
• Yol üzerinde hizalanmış konumları, navigasyon durumundan bağımsız olarak almaya devam etme özelliği eklendi.
• Yola yerleştirme öncesi konumlar (ör. doğruluk) hakkında ek bilgiler eklendi.

Kararlılık ve hata düzeltmeleri

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

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

Özellikler

• DriverSDK'nın Fleet Engine'e 0,0 konumları göndermesini engeller (daha iyi yolculuk paylaşımı ve tahsis konumu girişleri).
• Takılan konum sorunlarını iyileştirmek ve yolculuk paylaşımı için geri dönüşleri azaltmak üzere ek günlük kaydı.
• Aralık değişmediği sürece setLocationReportingInterval()'ya yapılan tekrarlanan aramaları yoksay.
• Kullanılan aralıklara göre bu yöntemin yüksek bir hızda tekrar tekrar çağrılmasını önlemek amacıyla setReportingInterval() yöntemi için javadoc'lar güncellendi.
• API 29 konum güvenilirliği iyileştirildi.

v1.13.0

Kararlılık ve hata düzeltmeleri

• Müşterilerin gradle derlemelerine eklemesi gereken 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 Paylaşılan Kalıcı Bildirimler başlıklı makaleyi inceleyin.
• Gecikmeli bir konum güncelleme etkinliğinin sahte bir konum güncellemesine neden olarak rotanın başında düz çizgi gibi yapay öğelere yol açması sorunu giderildi.

v1.11.6 (4 Ekim 2019)

API güncellemeleri

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

Kararlılık ve hata düzeltmeleri

• setVehicleState() artık hemen döndürülüyor. Fleet Engine artık arka plan iş parçacığında güncelleniyor. 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 sorun düzeltildi. Sürücü SDK'sının rotaya tek seferlik yol noktaları eklemesini engeller.