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

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

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 durduracağız.

2025'in dördüncü çeyreğinden itibaren yayınlanan Android için Sürücü SDK'sı sürümleri, minimum Android 8'i (API düzeyi 26) destekleyecektir. Daha önceki SDK sürümleri Android 6 ve 7'yi desteklemeye devam edecektir.

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() aranırken NullPointerException kilitlenmesi sorunu 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 Navigation SDK, 6.1.0 sürümü de dahil olmak üzere desteklenen aralıklı sürümleri içerir.

v6.1.0 (10 Mart 2025)

Hata düzeltmeleri

• Dahili günlük kaydı iyileştirmeleri.

v5.99.1 (10 Ocak 2025)

Hata düzeltmeleri

• Sürücülerin "INTERNAL" kodlu gRPC hataları ve "Panic! Bu bir hata!" açıklaması, uygulama yüklendikten sonra ilk kez başlatıldığında gösterilir.

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.
• Desteklenen Navigation SDK sürüm aralığı v5.x'e 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 dağıtılan tüm uygulamalar için zorunlu bir koşuldur. 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ı. Bu özellik, yayın entegre edildikten sonra kademeli olarak kullanıma sunulacaktır (başlangıçta %0).
• Ö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).

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

• Navigasyon SDK'sı v5.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 artık API 31 veya daha yüksek bir targetSdkVersion'ye sahip olmalıdır.
• Sürücü SDK'sını 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 adresini inceleyin.

Hata düzeltmeleri

• disableLocationTracking senkronizasyonuyla ilgili sorun düzeltildi.
• Hata durum güncellemelerindeki nedeni 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 destekleyin. ** 4.5.0 sürümünden 5.0.0 sürümüne kadar olan (5.0.0 sürümü hariç) sürümleri destekler.
• Araç hareketsizken tahmini varış zamanının kendiliğinden azalmasını önleme. Bu değişiklik, deneme amaçlı olarak kademeli şekilde kullanıma sunulacağından tüm uygulamalarda aynı anda görünmez.

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

• Navigation SDK bağımlılığını v4.5'e güncelleyin. Navigation SDK'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

• Navigation SDK 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ştirir. 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 üst bilgileri ve durum kodu raporlamasında dahili iyileştirmeler.

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

Hata düzeltmeleri

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

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

• Navigation SDK bağımlılığını v4.2.2'ye yükseltin.

v4.3.0 (24 Ağustos 2022)

Dahili iyileştirmeler.

Duyuru: Android 5 desteğinin sonlandırılması (21 Temmuz 2022)

En yeni SDK sürümümüz (v4.2.0) için hem API düzeyi 21 hem de 22'de Android 5'te çalışan uygulamalara bir yıl daha 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ü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 nedenle, herhangi bir SDK sürümünde (4.x dahil) Android 21 veya 22 ile ilgili hatalar düzeltilmeyecek ve SDK'ların doğru şekilde çalışacağını garanti etmiyoruz.

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.

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

API güncellemeleri

• Task nesnesinin parentId özelliği trackingId olarak yeniden adlandırıldı. Eski özellik şu an için hâlâ mevcut ancak kullanımdan kaldı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 Sürücü SDK'sı aşağıdaki değişikliklerle güncellendi.

VehicleStops API'sindeki değişiklik

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 işlevinin 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 işlevini, List<VehicleStop> yerine Future<List<VehicleStop>> döndürecek şekilde değiştirdi.

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 listesinden kaldırıldı.

• getServiceType(), AuthTokenContext listesinden kaldırıldı.

• setServiceType, AuthTokenContext.Builder listesinden kaldırıldı.

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

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.

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 Nav/Driver SDK, Android için Navigasyon SDK'sı v3.x ve Android için Driver SDK'sı v3.x (ikili dosyalar bölünmüş) olarak değişecek.

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ı ikiliye ayırıyoruz:

• Android için Navigasyon SDK'sı, sürücüleriniz için navigasyon/rota işlevleri sağlar.
• Android için Sürücü SDK'sı. Bu SDK, gezi veya görev ilerleme durumu ve tahsis için Fleet Engine 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.

Değişiklikler nelerdir?

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 navigasyon ö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 v3.2, buradaki sorunların çoğunu çözecektir. Daha fazla bilgi için Ne yapabilirim ve ne zaman? başlıklı makaleyi inceleyin.
• Karşılaşabileceğiniz sorunlarda hata ayıklamayı kolaylaştıracak 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 mevcut olduğundan v3'te kaldırılmıştır:

• 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ştirilmesiydi. 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 v1, 2018'de yayınlandı. Yakında v3 sürümlerimiz de yayınlanacak. Birçok ana sürümü desteklemenin sürdürülebilir olmaması nedeniyle v1'in desteğini sonlandırmanın zamanı geldi.

Bu ek sürümü desteklemek zorunda kalmayarak elde 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 artık kullanımdan kaldırıldı ve 21 Haziran 2022'den sonra bakımı yapılmayacak.

Lütfen SDK sürümlerinde desteğin sonlandırılmasının nasıl çalıştığını öğrenmek için 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 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. Fleet Engine örneğinde konum raporlama durdurulursa Navigator içinde 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 hata düzeltildi.

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

Özellikler

1.15.0 verileriyle ilgili ön analiz, kararlı konum raporlamasında önemli iyileştirmeler (takılan konumların azaltılması) olduğunu gösterdi. Bu yama düzeltmesi, gelişmiş konum raporlamanın devam etmesine olanak tanır. ANR sorunu bu iyileştirmelerle ilgili değildi.

Kararlılık ve hata düzeltmeleri

• Bazen rotanın başlangıcında düz bir çizginin gösterilmesine neden olan hata düzeltildi.
• Konumlar SDK tarafından bildirilirken ANR'ye neden olabilen hata düzeltildi. Bu durum, kilit çekişmesine duyarlı onArrival() iyileştirmelerinden kaynaklanmıştır. 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ç konumunun daha iyi takip edilebilmesi için başlangıç, rota dışı ve varış etkinliklerinde gezinme rehberliği durumu özelliği kullanıma sunuldu.
• Yol üzerinde konum sabitleme özelliğini, navigasyon durumundan bağımsız olarak kullanmaya devam etme özelliği eklendi.
• Yola yerleştirilmeden önceki 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 ara nokta 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 amacıyla ek günlük kaydı.
• Aralık değişmediği sürece setLocationReportingInterval() için tekrarlanan aramalar yoksayılır.
• Kullanılan aralıklarla karşılaştırıldığında bu yöntemin yüksek bir hızda tekrar tekrar çağrılmasını önlemek amacıyla setReportingInterval() yöntemi için güncellenmiş Javadoc'lar.
• API 29'da konum güvenilirliği iyileştirildi.

v1.13.0

Kararlılık ve hata düzeltmeleri

• İstemcilerin 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 da devam ediyor.
• Varsayılan bildirim (Ücretsiz 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 konum güncelleme etkinliğinin, sahte bir konum güncellemesine neden olabileceği ve bu nedenle rotanın başında düz bir çizgi gibi yapaylıklar oluşabileceği 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üncellemelerine hızlıca devam etmesini sağlayan bir dizi değişiklik yapıldı. Ağ bağlantısı geri yüklendikten 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ılırken 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.