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

Bu bölümde, Android için Sürücü SDK'sına ilişkin sürüm notları yer almaktadır.

Sürüm 5.0.0 (12 Eylül 2023)

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

  • Gezinme SDK'sı v5.x olarak güncellendi.
  • minSdkVersion, API 23 sürümüne geçirildi.
  • Kotlin sürümü 1.9.0'a yükseltildi.
  • Oda'ya bağımlılık eklendi.
  • Driver SDK'sını kullanan uygulamalarda artık targetSdkVersion API 31 veya sonraki sürümleri bulunmalıdır.
  • Sürücü SDK'sını kullanan uygulamaların artık Java 8 kitaplığı desteğini etkinleştirmesi gerekiyor. Güncelleme talimatları için https://developer.android.com/studio/write/java8-support adresini ziyaret edin.
  • ProGuard veya DexGuard kullanan uygulamalar R8'e taşınmalıdır. Daha fazla bilgi için https://developer.android.com/build/shrink-code sayfasını inceleyin.
  • Driver SDK'sını kullanan uygulamalar şeker giderme özelliğini etkinleştirmelidir. Talimatlar için https://developer.android.com/studio/write/java8-support#library-desugaring sayfasını inceleyin.

Hata düzeltmeleri

  • DisableLocationTracking senkronizasyonuyla ilgili sorun düzeltildi.
  • İstisna durumu güncellemelerinde bir nedeni bildiren yeni DriverStatusListener arayüzü kullanıma sunuldu.
  • Sürücülerin hareketsiz kalmasına ilişkin 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 bir sürüm aralığını destekleyin. ** 4.5.0 ile 5.0.0 arasındaki sürümler desteklenir.
  • Araç hareketsizken TVS'nin kendiliğinden azalmasını önler. Bu değişiklik deneme aşamasında kademeli olarak kullanıma sunulduğundan tüm uygulamalar bu değişikliği aynı anda görmeyecektir.

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

  • Gezinme SDK'sı bağımlılığını v4.5'e güncelleyin. Gezinme SDK'sı için grup ve yapı kimliklerinin değiştiğini unutmayın.

sürüm 4.4.3 (20 Mart 2023)

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

  • Gezinme SDK'sı bağımlılığını v4.4.1'e yükseltin.

Sürüm 4.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 özellik şu anda deneme olarak kullanıma sunulmaktadır.

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

  • Yarış durumunu "Rotaya Genel Bakış" ALFA API'sinde düzeltin.

Sürüm 4.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.

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

Hata düzeltmeleri

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

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

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

Sürüm 4.3.0 (24 Ağustos 2022)

Dahili iyileştirmeler.

Duyuru: Android 5 için dondurma desteği (21 Temmuz 2022)

En son SDK sürümümüz (4.2.0) ile ilgili olarak, Android 5'te çalışan uygulamalar için API düzeyi 21 ve 22 olmak üzere ek bir yıl 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ü destekleyecek.
  • 30 Haziran 2023'ten sonra yalnızca Android API düzeyi 23 ve üzerini destekleyeceğiz. Başka bir deyişle, bu tarihten sonra tüm SDK sürümlerinde Android API 21 ve 22 düzeylerini desteklemeyi bırakacağız. Bu, SDK sürümlerindeki (4.x dahil) Android 21 veya 22 ile ilgili hataların düzeltilmeyeceği anlamına gelir ve SDK'ların doğru davranacağını garanti etmez.

Bu bildirim, 21 Haziran 2021'den itibaren geçerli olan Android 21 ve 22 desteği dondurma bildirimini, 18 Ekim 2021'den itibaren ise Android 23, 24 ve 25 sürümlerindeki donma desteğini geçersiz kılar.

sürüm 4.2.0 (8 Haziran 2022)

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

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

sürüm 4.1.0 (28 Nisan 2022)

API güncellemeleri

  • Task nesnesinin parentId özelliği trackingId olarak yeniden adlandırıldı. Eski mülk şimdilik hâlâ mevcuttur ancak kullanımdan kaldırılmıştır.

  • Future olan bazı döndürme türleri, daha spesifik olan ListenableFuture ve List olan bazı döndürme türleri ImmutableList olarak değiştirildi.

Sürüm 4.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üncellenmiştir.

VehicleStops API değişikliği

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

  • Yeni bir sınıf eklendi: TaskInfo

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

  • VehicleStop.Builder'in 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 eklendi. Bu özellik varsayılan olarak etkindir ancak SDK'yı başlatmadan önce setAbnormalTerminationReportingEnabled() yöntemini çağırıp false değerini geçirirseniz özelliği devre dışı bırakabilirsiniz.

Eş zamansız getRemainingVehicleStops

Kimlik doğrulama

AuthTokenContext arayüzünden gereksiz özellikler kaldırıldı. ServiceType desteği sonlandırıldı. ServiceType hizmetini kullanmak yerine artık yalnızca dahil edilen araç kimliği ve görev kimliği için hak talepleri almanız gerekir.

18 Ekim 2021 - API Düzeyi 23, 24 ve 25 için dondurma desteği

18 Ekim duyurusunu okuyun

İç bağımlılıklarımızdaki değişikliklere göre, Android API Seviye 23, 24 ve 25 (Android 6, 7.0 ve 7.1), 2022'nin üçüncü çeyreğinden itibaren Android için Gezinme ve Sürücü SDK'larının yeni sürümlerinde desteklenmeyecektir.

2022'nin üçüncü çeyreğinden itibaren yayınlanan Android sürümleri için Navigasyon ve Sürücü SDK'ları, yalnızca en az Android API Seviyesi 26 çalıştıran cihazları destekleyecektir.

Android için Gezinme ve Sürücü SDK'larının v4.x veya önceki sürümleri ile oluşturulan uygulama sürümleri, Android API Seviye 25 ve önceki sürümleri çalıştıran cihazlarda çalışmaya devam edecektir.

Sürüm 3.0.4 (28 Temmuz 2021)

Özellikler

Bu sürümle birlikte Sürücü SDK'sı, Gezinme SDK'sından resmi olarak ayrıldı. Ayrıntılar için taşıma rehberine göz atın.

API güncellemeleri

Aşağıdaki yöntemler eklendi:

DeliveryDriverApi.getDriverSdkVersion()

Kararlılık ve hata düzeltmeleri

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

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

Bu duyuruda, yukarıda listelenen tarih itibarıyla Android için Sürücü SDK'sının ve Android için Navigasyon SDK'sının kullanımdan kaldırılması açıklanmaktadır. Bu duyuru, durumdan etkilenen müşterilere Zorunlu Hizmet Duyurusu (MSA) olarak da gönderilmiştir.

Müşteri entegrasyonunu basitleştirmek ve faydalı özellikler sunma becerimizi hızlandırmak amacıyla Android için Navigasyon SDK'sını ve Android için Driver SDK'sını iki farklı ikili programa ayırıyoruz:

  • Sürücülerinize navigasyon/yönlendirme işlevi sağlayacak Android için Navigasyon SDK'sı.
  • Android için Sürücü SDK'sı. Bu SDK, gezi veya görev ilerlemesi ve tahsisi için Fleet Engine durum bilgili web hizmetlerinden yararlanmanıza olanak tanır.

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

Değişiklikler nelerdir?

v3'teki önemli değişiklikler:

  • Bir yerine iki ikili program.
  • Android sınıfları için Sürücü SDK'sına ilişkin daha açık paket tanımları.
  • Android için Gezinme SDK'si, paketin bir parçası olarak Android için Haritalar SDK'sını içerir (Android sürüm 2 için Gezinme SDK'sı itibarıyla).
    • Bu, haritaların ve gezinme özelliklerinin aynı harita üzerinde birlikte var olmasını sağlar (örneğin, NavigationView'da çoklu çizgi çizme) ve iki yerine tek bir harita kullanıldığından bellek kullanımını azaltır.
    • Android 3.0 için Gezinme SDK'sı, Android için Navigasyon SDK'sı ile tam özellik denkliğine sahip değildir ancak 3.2 sürümü çoğu sorunu burada çözer. Daha ayrıntılı bilgi için Neleri, ne zaman yapabilirim? bölümüne bakın.
  • Karşılaşabileceğiniz sorunlarda hata ayıklamamızı kolaylaştıracak günlük kaydı.

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

  • Aşağıdaki Nav/Driver SDK yöntemleri 10 Ağustos 2020 tarihinde yayınlanan 1.16 v1.0 ve 3.0 sürümünde kullanımdan kaldırılmıştır:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Bütünlük ve netlik için v1'den v2'ye geçişte bazı yöntemlerin kaldırıldığını unutmayın. Bunların çoğu, Android için Gezinme SDK'sı ile Android için Haritalar SDK'sı arasındaki yinelenen sınıfların konsolidasyonuydu. Bu değişiklikleri daha iyi anlamak için lütfen taşıma rehberini inceleyin.

Android için Sürücü SDK'sı ve Android v1.x için Navigasyon SDK'sının kullanımdan kaldırılması

Nav/Driver SDK v1 sürümü 2018'de kullanıma sunuldu. v3 sürümlerimiz de yakında yayınlanacak. Bu süreçte, birçok ana sürümün desteklenmesinin sürdürülebilirlik tehlikesini önlemek için v1'i kullanımdan kaldırma zamanı geldi.

Bu ek sürümü desteklemek zorunda kalmamamız nedeniyle kazanılan zaman, en son ana sürümü daha iyi desteklememize ve müşterilerimiz için önemli olan daha fazla özellik oluşturmamıza olanak tanır.

Bu nedenle, Nav/Driver SDK v1.x sürümü artık kullanımdan kaldırılmıştır ve 21 Haziran 2022'den sonra artık kullanılmayacaktır.

Lütfen biraz zaman ayırıp SDK sürümlerindeki kullanımdan kaldırma işlemlerinin nasıl yapıldığını öğrenin.

İptal edilen duyuruyu okuyun

Android için Navigasyon SDK'sının yakında kullanıma sunulacak 4.0 sürümü ve Android için Sürücü SDK'sı minimum [Android 6.0 (API düzeyi 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external} sürümünü destekleyecektir. Şu anda desteklenen minimum sürüm Android 5.0'dır (API düzeyi 21). 4.0 sürümünü 2021'in 4. çeyreğinde kullanıma sunmayı planlıyoruz. Bunun anlamı şudur:

  • v4.x'ten önceki sürümlerle oluşturulan uygulama sürümleri, Android 21 ve 22 cihazlarda çalışmaya devam edecektir. Mevcut SDK'larımızı entegre eden sürücü uygulamalarınız Android 21 ve sonraki sürümleri çalıştıran cihazlarda çalışmaya devam edecek. Bu durum eskiden olduğu gibi devam edecek.
  • Android için Sürücü SDK'sı ve Android v4.x için Navigasyon SDK'sı ile oluşturulan uygulama sürümleri (2021'in 4. çeyreğine yönelik olarak değiştirilebilir) ve sonrasındaki değişiklikler Android 21 ve 22 çalıştıran cihazlara yüklenemez.v4.x minimum Android 6.0 (API düzeyi 23) ile çalıştırılacaktır. Bu nedenle, uygulamanızın hem Android v4 ve üzeri sürümdeki değişiklikleri alan sürücüler hem de Android 2 ve sonraki sürümlere sahip sürücüler, Android ile ilgili değişiklikleri alacaktır.

Yükseltmek istediğiniz Android v3 için Gezinme SDK'sı ve Android v3 için Sürücü SDK'sı sürümleri, ne zaman kullanıma sunulacakları ile birlikte aşağıdaki tabloda açıklanmıştır.

Hangi Sürücü platformu özelliklerini kullanıyorsunuz? Bu özelliklerden yararlanıyor musunuz? Yeni sürüme geçmeniz gereken ilk sürümler şunlardır: Beklenen stok durumu
(değişebilir)		 Taşıma Bağlantıları
Yalnızca gezinme
(NavSDK yöntemleri)		 Hayır NavSDK 3.0.1 sürümü Şimdi Kılavuz
Evet NavSDK 3.5 sürümü (öngörülen) Eylül 2021
Navigasyon ve Fleet Engine İzleme (NavSDK ve DriverSDK yöntemleri) Hayır Nav SDK v3.0 ve Driver SDK v3.0 Sürücü 3.0 sürümü taşıma kılavuzu, şu sürümde kullanılabilir:
Evet NavSDK v3.x ve DriverSDK v3.0

Kaldırılan yöntemleri kullanmaya devam etmek için v1.x sürümünde kalabilirsiniz ancak 21 Haziran 2022'den sonra destek veya bakım hizmeti almanız gerekmez (Sonraki bölüme bakın).

v3.x sürümüne geçmenizi öneririz. Bunun anlamı şudur:

* v1.x'in son sürümü 2021'in 4. çeyreğinde kullanıma sunulacaktır (yani v1, o tarihten itibaren "özellik dondurulmuştur" olacaktır).

* Bu son sürüme, 21 Haziran 2022 tarihine kadar 6 ay boyunca yama uygulanabilir. Bu tarihten sonra v1.x sürümüyle ilgili hata veya özellik isteklerine yanıt veremeyeceğiz.

Bu değişikliklere uyum sağlamanıza yardımcı olması için birkaç dakikanızı ayırarak aşağıdaki tabloyu ve [taşıma rehberini](/maps/documentation/navigation-sdk-android/v2/migration) inceleyebilirsiniz.

Ne zamana kadar ne yapabilirim?

Şu anda seçiliyseniz: Bu özelliklerden yararlanıyor musunuz? Şimdi yükseltmek için Eylül 2021'de yeni sürüme geçmek için Taşıma Bağlantıları
v1.x
(FleetEngine.java / Sürücü işlevini kullanmıyor) 		Hayır NavSDK 3.0 sürümü Kılavuz
Evet Eşdeğer seçenek yok. NavSDK 3.x
v1.x
(FleetEngine.java / Sürücü işlevini kullanarak)		 Hayır Eşdeğer seçenek yok. NavSDK 3.x +
DriverSDK 3.x		 Yukarıdaki kılavuza ek olarak bu sürümde sunulan Driver 3.0 sürümü taşıma kılavuzu.
Evet

Android için Sürücü SDK'sını ve Android v4.x ve sonraki sürümlerini Navigasyon SDK'sını sürücü uygulamanıza entegre etmeden önce, cihazları Android 21 ve 22'ye sahip olan sürücülerinizi daha yeni bir Android sürümüne (minimum Android 6.0) yükseltmeleri konusunda bilgilendirmenizi öneririz.

Sürüm 1.15.3 (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

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

v1.15.2

Özellikler

Kalıcı bildirimi durdurma özelliği eklendi. Fleet Engine örneğinde konum bildirme durdurulursa yönlendirme Navigator içinde 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 bir istisnanın atılmasına neden olan bir hata düzeltildi.

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

Özellikler

1.15.0 verilerinin ön analizi, kararlı konum raporlamasında ("takılı" konumların azaltılması) önemli iyileştirmeler olduğunu göstermiştir. Bu yama düzeltmesi, iyileştirilmiş konum raporlamasının devam etmesini sağlar. ANR sorununun bu iyileştirmelerle bir ilgisi yoktu.

Kararlılık ve hata düzeltmeleri

  • Tüketici uygulamasında bazen rotanın başında düz bir çizginin gösterilmesine neden olan bir hata düzeltildi.
  • SDK tarafından konum bildirildiğinde ANR'ye neden olabilen bir hata düzeltildi. Bunun nedeni, anlaşmazlığı kilitleyebileceği onArrival() iyileştirmenin sonucudur. Bazı durumlarda ANR'leri güvenilir bir şekilde yeniden oluşturabildik ve düzeltmelerin sorunu çözdüğünü doğrulayabildik. ANR'leri oluşturmaya yönelik değiştirilmiş test uygulaması, düzeltmeden sonra ANR olmadan sekiz saat çalıştı.

sürüm 1.15.0 (23 Mart 2019)

Özellikler

  • Araç konum izleme özelliğini iyileştirmek için başlangıç, rota dışı ve varış etkinliklerinde navigasyon yardımı durumu kullanıma sunuldu.
  • Gezinme durumundan bağımsız olarak trafiğe kapalı konumları almaya devam etme olanağı eklendi.
  • Yoldan önce kaydedilen konumlar hakkında 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 enl/lng Ara Noktası adlarının dikkate alınmamasına neden olan bir hata düzeltildi.

sürüm 1.14.2 Sürüm (2 Şubat 2019)

Özellikler

  • DriverSDK'nın Fleet Engine'e 0,0 konum göndermesini önler (daha iyi yolculuk paylaşımı ve konum bilgisi girişleri).
  • Takılı kalan konum sorunlarını iyileştirmek ve yolculuk paylaşımında yedekleri azaltmak için ek günlük kaydı.
  • Aralık değişmediği sürece setLocationReportingInterval() işlevine yapılan tekrarlanan çağrıları yoksayın.
  • Kullanılan aralıklara göre yüksek bir hızda bu yöntemin yinelenen şekilde çağrılmasından vazgeçirme amacıyla setReportingInterval() yöntemi için Javadocs güncellendi.
  • Api 29'un konum güvenilirliği iyileştirildi.

v1.13.0

Kararlılık ve hata düzeltmeleri

  • İstemcilerin gradle derlemelerine eklemesi gereken okhttp'ye bir bağımlılık ekler.

sürüm 1.11.7 (18 Ekim 2019)

Kararlılık ve hata düzeltmeleri

  • Belirli bir hedef için onArrival() etkinleştikten sonra artık konum güncellemeleri devam ediyor.
  • Varsayılan bildirim (Serbest Gezinme modunda sabit bir dize), gezinme bildirimleri için ayarlanan renk şemasıyla eşleşir. Daha fazla bilgi için Paylaşılan Kalıcı Bildirimler bölümüne bakın.
  • Geciken bir konum güncellemesi etkinliğinin sahte bir konum güncellemesine neden olarak rotanın başında düz bir çizgi gibi hatalara yol açabilmesine neden olan sorun giderildi.

sürüm 1.11.6 (4 Ekim 2019)

API güncellemeleri

  • Sürücü SDK'sının bir ağ arızasından hemen sonra konum güncellemelerini devam ettirmesini sağlayan bir dizi değişiklik uygulamaya kondu. Ağ bağlantısı tekrar kurulduğunda konum güncellemeleri bir sonraki planlanmış konum güncellemesinde tekrar başlar.

Kararlılık ve hata düzeltmeleri

  • setVehicleState() artık hemen geri dönüyor. FleetEngine'i güncelleme işlemi artık bir arka plan iş parçacığında gerçekleşiyor. Uygulama Yanıt Vermiyor (ANR) sorununu giderir.
  • Tüketici SDK'sının eski sürümlerini kullanarak yolculuk paylaşımı rotalarının düz bir çizgi olarak görüntülenmesine neden olan bir sorun düzeltildi. Sürücü SDK'sı tarafından rotaya tek seferlik ara nokta eklenmemesini sağlar.