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.99.0 (11 Kasım 2026)

Hata düzeltmeleri

• Bağlantı kurulumu sırasında bir ara operatör proxy'si durduğunda Fleet Engine'e güvenli bağlantı girişimlerinin süresiz olarak beklemede kalmasına neden olan ve belirli mobil ağlarda seyahat durumu ile araç takibi güncellemelerinin yenilenmesini engelleyen bir sorun düzeltildi. Driver SDK'sı artık bağlantı zaman aşımı uygular ve yeni bir bağlantıda otomatik olarak kurtarılır.

• DriverApi.clearInstance() çağrılırken oluşan iş parçacığı ve yürütücü sızıntıları (FleetEngineEventHandler, FusedLocationWriter ve DriverApi yürütücüleri) düzeltildi.

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

• Jetpack DataStore bağımlılıkları (androidx.datastore:datastore-core ve androidx.datastore:datastore-guava) 1.2.1 sürümüne yükseltildi.

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

• Desteklenen Gezinme SDK'sı sürüm aralığı [7.9.0, 8.0.0) olarak güncellendi.

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ık sürümü 2.3.0 sürümüne 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ığı sürümü 2.1.5'e yükseltildi.

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

7.0.0 sürümü (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.

• Navigasyon SDK'sının desteklenen sürüm aralığı, v7.0.0 ve sonraki sürümleri kapsayacak şekilde güncellendi.

6.99.0 sürümü (5 Aralık 2025)

• Dahili iyileştirmeler

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

Mobil OS sürümü destek politikası uyarınca, Android için Sürücü SDK'sının gelecek ana sürümlerinde Android 6 ve 7 (API düzeyi 23, 24 ve 25) için desteği donduruyoruz.

Android için Driver SDK, 7.0.0 sürümünden itibaren en az 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ız bir sürüm numarası belirtmiyorsa 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 OS'yi ne zaman yükselteceğinizi kontrol etmek amacıyla 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 Driver SDK'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 itibaren desteklenen sürümleri kapsar.

6.1.0 sürümü (10 Mart 2025)

Hata düzeltmeleri

• Dahili günlüğe kaydetme ile ilgili geliş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ı gösteriliyor.

6.0.0 sürümü (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. Sürüm entegre edildikten sonra bu özellik kademeli olarak (%0'dan başlayarak) kullanıma sunulacak.`

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ındaki glide:cronet-integration bağımlılığını kaldırın.
• Navigation SDK'nın desteklenen sürüm aralığı 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 sunulacaktır.
• Özellikle cihaz ağ değiştirdiğinde konum güncelleme bağlantı hatalarını azaltmak için dahili iyileştirme. Sürüm entegre edildikten sonra bu özellik kademeli olarak (%0'dan başlayarak) kullanıma sunulacak.`

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

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

5.0.0 sürümü (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'a bağımlılık eklendi. * Sürücü SDK'sını kullanan uygulamaların artık API 31 veya daha yeni bir sürümün targetSdkVersion değerine sahip olması gerekir.
• Driver SDK'yı kullanan uygulamaların artık Java 8 kitaplık desteğini etkinleştirmesi gerekir. Güncelleme talimatları için https://developer.android.com/studio/write/java8-support adresine bakın.
• Proguard veya Dexguard kullanan uygulamalar R8'e geçmelidir. 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 adresini ziyaret edin.

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 hareketsiz kalmasıyla ilgili sorun düzeltildi (4.99.0 sürümünden itibaren kullanılabilir).

v4.99.0 (9 Ağustos 2023)

• NavSDK bağımlılığı için çeşitli sürümleri destekleyin. ** 4.5.0 sürümünden 5.0.0 sürümüne kadar (5.0.0 hariç) desteklenir.
• Araç hareketsizken TVS'nin kendi kendine azalmasını önleyin. Bu değişiklik, deneme olarak kademeli şekilde kullanıma sunulacağından tüm uygulamalarda aynı anda görünmeyebilir.

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

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

v4.4.3 (20 Mart 2023)

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

• Navigation SDK bağımlılığını 4.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ştirme Bu, deneysel bir düzeltmedir.

• Yalnızca "Ham" konum içeren UpdateVehicle isteği silin.

• "Rotaya Genel Bakış" ALPHA API'sindeki yarışma 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

• Navigation SDK 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 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 bir yıl daha destek sunuyoruz.

Bu ne anlama geliyor?

• Android uygulamalarınızda çalışan Navigasyon SDK'sı ve Sürücü SDK'sı, 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. Başka 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, 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ğinin dondurulması bildiriminin ve 18 Ekim 2021 tarihli Android 23, 24 ve 25 desteğinin dondurulması bildiriminin yerine geçer.

v4.2.0 (8 Haziran 2022)

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

• Nav SDK bağımlılığını 4.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

Bu sürümde, Android için Driver SDK'da aşağıdaki değişiklikler yapılmıştır.

VehicleStops API değişikliği

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

• Yeni bir sınıf eklendi: TaskInfo

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

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

Kilitlenme izleme

SDK kararlılığını artırmaya yardımcı olmak için kilitlenme izleme ve raporlama özelliği eklendi. Bu özellik varsayılan olarak etkindir ancak SDK'yı ilk kullanıma hazırlamadan önce setAbnormalTerminationReportingEnabled() yöntemini çağırıp false değerini ileterek devre dışı bırakabilirsiniz.

• DriverApi için setAbnormalTerminationReportingEnabled işlevi eklendi.

Eşzamansız getRemainingVehicleStops

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

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 talepleri almanız gerekir.

• 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 geçiş 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 raporlayın.

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 yapılan kullanımdan kaldırma işlemleri 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ı özellikleri daha hızlı sunabilmek için Android için Navigasyon SDK'sı ve Android için Sürücü SDK'sını iki farklı ikili program olarak ayırıyoruz:

• Sürücüleriniz için navigasyon/rota izleme işlevi sağlayan Android için Navigasyon SDK'sı.
• Gezi veya görev ilerleme durumu ve tahsisi için Fleet Engine durum bilgisi olan web hizmetlerinden yararlanmanıza olanak tanıyan Android için Driver SDK.

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

Değişiklikler neler?

3. sürümdeki önemli 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ı, Android için Haritalar SDK'sını paketin bir parçası olarak içerir (Android için Navigasyon SDK'sı 2. sürümden itibaren).
  • Bu sayede haritalar ve navigasyon özellikleri aynı haritada bir arada bulunabilir (ör. NavigationView'da çoklu çizgi çizme) ve iki harita yerine tek bir harita kullanıldığı için bellek kullanımı azalır.
  • Android için Navigasyon SDK'sı 3.0, Android için Navigasyon SDK'sı ile tam özellik eşdeğerliğine sahip değildir ancak 3.2 sürümü buradaki sorunların çoğunu çözecektir. Daha fazla bilgi için Ne zaman ne yapabilirim? başlıklı makaleyi inceleyin.
• Karşılaşabileceğiniz sorunlarda hata ayıklamamızı kolaylaştıracak günlük kaydı.

Aşağıdaki yöntemler de daha önce desteği sonlandırılmış olarak işaretlendiği ve alternatif bir çözüm zaten mevcut olduğu için 3. sürümde 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(*)
• Eksiksiz ve net olması için, v1'den v2'ye geçişte bir dizi yöntemin 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ştirilmesiydi. 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ı 1.x sürümünün 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 birkaç dakikanızı ayırarak SDK sürümlerinde desteğin sonlandırılmasının nasıl işlediğini inceleyin.

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

v1.15.3 (9 Ekim 2020)

API güncellemeleri

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

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 raporlama durdurulursa Navigator uygulamasında rehberlik durdurulur, tüm navigasyon dinleyicilerinin kaydı silinir ve NavigationFragment ya da 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 verilerinin ön analizi, kararlı konum raporlamasında önemli iyileştirmeler olduğunu gösterdi ("takılı" konumların azalması). Bu yama düzeltmesi, iyileştirilmiş konum raporlamasının devam etmesini sağlar. 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 hata düzeltildi.
• SDK tarafından konumlar bildirilirken ANR'ye neden olabilecek bir hata düzeltildi. Bu durum, kilit çekişmesine duyarlı onArrival() iyileştirmeden kaynaklanıyordu. Bazı durumlarda ANR'leri güvenilir bir şekilde yeniden oluşturabildik ve düzeltmelerin sorunu çözdüğünü doğrulayabildik. ANR'leri oluşturmak için değiştirilen test uygulaması, düzeltmeden sonra ANR olmadan sekiz saat boyunca ç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 kullanıma sunuldu.
• Navigasyon durumundan bağımsız olarak yola sabitlenmiş konumları almaya devam etme özelliği eklendi.
• Yola sabitlenmiş konumlarla ilgili doğruluk gibi ek bilgiler eklendi.

Kararlılık ve hata düzeltmeleri

• navsdk için minSdkVersion 19'a yükseltildi.
• Sunucu tarafı tersine 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'e 0,0 konum göndermesini engeller (daha iyi yolculuk paylaşımı ve tahsis konumu girişleri).
• Konumun takılı kalmasıyla ilgili sorunları iyileştirmek ve yolculuk paylaşımı için yedekleri azaltmak amacıyla ek günlük kaydı.
• Aralık değişmediği sürece setLocationReportingInterval() için tekrarlanan çağrıları yoksay.
• 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ı önlemek amacıyla güncellendi.
• API 29 konum güvenilirliği iyileştirildi.

v1.13.0

Kararlılık ve hata düzeltmeleri

• İstemcilerin 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 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

• 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, 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. FleetEngine 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ümlerinde yolculuk paylaşımı rotalarının düz çizgi olarak gösterilmesine neden olan sorun düzeltildi. Sürücü SDK'sı tarafından rotaya tek seferlik ara nokta eklenmemesini sağlar.