Catatan Rilis Driver SDK untuk Android

Bagian ini berisi catatan rilis untuk Driver SDK for Android.

v5.0.0 (12 September 2023)

Perubahan dependensi dan konfigurasi

  • Mengupdate Navigation SDK ke v5.x.
  • minSdkVersion telah diupgrade ke API 23.
  • Mengupgrade versi Kotlin ke 1.9.0.
  • Menambahkan dependensi pada Room.
  • Aplikasi yang menggunakan Driver SDK kini harus memiliki targetSdkVersion API 31 atau yang lebih tinggi.
  • Aplikasi yang menggunakan Driver SDK kini harus mengaktifkan dukungan library Java 8. Lihat https://developer.android.com/studio/write/java8-support untuk mendapatkan petunjuk tentang cara mengupdate.
  • Aplikasi yang menggunakan Proguard atau Dexguard harus dimigrasikan ke R8. Lihat https://developer.android.com/build/shrink-code untuk mengetahui informasi selengkapnya.
  • Aplikasi yang menggunakan Driver SDK harus mengaktifkan desugaring. Lihat https://developer.android.com/studio/write/java8-support#library-desugaring untuk mengetahui petunjuknya.

Perbaikan bug

  • Memperbaiki masalah sinkronisasi penonaktifan LocationTracking.
  • Memperkenalkan antarmuka DriverStatusListener baru yang melaporkan penyebab dalam pembaruan status pengecualian.
  • Memperbaiki masalah untuk driver yang tetap tidak bergerak (tersedia mulai v4.99.0).

v4.99.0 (9 Agustus 2023)

  • Mendukung berbagai versi untuk dependensi NavSDK. ** Mendukung v4.5.0 hingga (tetapi tidak termasuk) v5.0.0.
  • Mencegah PWT menurun dengan sendirinya saat kendaraan berhenti. Perubahan ini diluncurkan secara bertahap sebagai eksperimen, sehingga tidak semua aplikasi akan melihat perubahan ini secara bersamaan.

v4.5.0 (12 Mei 2023)

  • Mengupdate dependensi Navigation SDK ke v4.5. Perhatikan bahwa ID grup dan artefak untuk Navigation SDK telah berubah.

v4.4.3 (20 Maret 2023)

Perubahan dependensi

  • Mengupgrade dependensi Navigation SDK ke v4.4.1.

v4.4.2 (15 Februari 2023)

Perbaikan bug

  • Meningkatkan waktu pemulihan jaringan saat SDK mengalami masalah koneksi sementara. Fitur ini sedang diluncurkan sebagai eksperimen.

  • Hapus permintaan UpdateVehicle yang hanya berisi permintaan "Raw" lokasi HTTP/HTTPS.

  • Memperbaiki kondisi race di "Route Overview" API ALFA.

v4.4.1 (18 November 2022)

Perbaikan bug

  • Perbaikan bug dalam logika upload traffic.

Perubahan lainnya

  • Peningkatan internal dalam pelaporan header permintaan dan kode status.

v4.4.0 (21 September 2022)

Perbaikan bug

  • Memperbaiki bug yang mencegah opsi "Mengemudi dengan Google Maps" notifikasi agar tidak dihapus jika instance API tidak dihapus.

Perubahan dependensi

  • Mengupgrade dependensi Navigation SDK ke v4.2.2.

v4.3.0 (24 Agustus 2022)

Peningkatan internal.

Pengumuman: Membekukan dukungan untuk Android 5 (21 Juli 2022)

Untuk versi SDK terbaru (v4.2.0), kami memberikan dukungan tambahan selama satu tahun untuk aplikasi yang berjalan di Android 5, baik untuk API level 21 dan 22.

Langkah selanjutnya:

  • Navigation SDK dan Driver SDK yang berjalan di aplikasi Android Anda akan mendukung minimum Android 5 (level API 21) hingga 30 Juni 2023.
  • Setelah 30 Juni 2023, kami hanya akan mendukung Android API level 23 dan yang lebih baru. Dengan kata lain, kami akan berhenti mendukung Android API level 21 dan 22 di semua versi SDK setelah tanggal tersebut. Ini berarti bahwa bug yang terkait dengan Android 21 atau 22 di versi SDK mana pun (termasuk 4.x) tidak akan diperbaiki, dan kami tidak melakukannya menjamin bahwa SDK akan berperilaku dengan benar.

Pemberitahuan ini menggantikan pemberitahuan pembekuan dukungan Android 21 dan 22 mulai bulan Juni 21, 2021, serta Android 23, 24, dan 25 mendukung pembekuan mulai 18 Oktober 2021.

v4.2.0 (8 Juni 2022)

Perubahan dependensi

  • Mengupgrade dependensi Nav SDK ke v4.1.3.
  • Mendowngrade Android API level minimum yang didukung ke versi 21.

v4.1.0 (28 April 2022)

Update API

  • Mengganti nama properti parentId objek Task menjadi trackingId. Yang lama saat ini properti masih ada, tetapi tidak digunakan lagi.

  • Mengubah beberapa jenis nilai yang ditampilkan dari Future menjadi yang lebih spesifik ListenableFuture dan dari List ke ImmutableList yang lebih spesifik.

v4.0.0 (29 November 2021)

API Level Android minimum yang didukung untuk rilis ini adalah 23.

Update API

Untuk rilis ini, Driver SDK untuk Android telah diupdate dengan perubahan.

Perubahan VehicleStops API

Objek VehicleStop sekarang merujuk pada Daftar TaskInfo objek alih-alih daftar objek Task objek terstruktur dalam jumlah besar. Jika Anda memerlukan status Tugas, sebaiknya lacak di kode aplikasi Anda.

  • Menambahkan kelas baru: TaskInfo

  • Mengganti fungsi getTasks VehicleStop dengan getTaskInfoList fungsi tersebut.

  • Mengganti fungsi setTasks VehicleStop.Builder dengan setTaskInfoList fungsi tersebut.

Pemantauan error

Pemantauan dan pelaporan error telah ditambahkan untuk membantu meningkatkan stabilitas SDK. Fitur ini diaktifkan secara {i>default<i}, tetapi Anda dapat menonaktifkannya jika Anda memanggil setAbnormalTerminationReportingEnabled() dan teruskan nilai false sebelum melakukan inisialisasi SDK.

Async getRemainingVehicleStops

Autentikasi

Menghapus properti yang tidak diperlukan dari antarmuka AuthTokenContext. ServiceType tidak digunakan lagi. Kini Anda hanya perlu mendapatkan klaim untuk menyertakan ID kendaraan dan ID tugas, bukan mengandalkan ServiceType.

18 Oktober 2021 - Membekukan dukungan untuk API Level 23, 24, dan 25

Baca pengumuman 18 Oktober

Sebagai respons terhadap perubahan pada dependensi internal kami, Android API Level 23, 24, dan 25 (Android 6, 7.0, dan 7.1) tidak akan didukung di versi baru dari Navigation SDK dan Driver SDK untuk Android, dimulai pada kuartal 2022.

Navigation SDK dan Driver SDK untuk versi Android yang dirilis mulai bulan ketiga kuartal 2022 hanya akan mendukung perangkat yang menjalankan minimum Level API Android 26.

Versi aplikasi yang dibuat dengan Navigation SDK dan Driver SDK v4.x atau yang lebih rendah untuk Android akan terus berfungsi di perangkat yang menjalankan Android API Level 25 dan di bawahnya.

v3.0.4 (28 Juli 2021)

Fitur

Dengan rilis ini, Driver SDK resmi terpisah dari Navigation SDK. Lihat panduan migrasi untuk mengetahui detailnya.

Update API

Menambahkan metode berikut:

DeliveryDriverApi.getDriverSdkVersion()

Perbaikan bug dan stabilitas

Melaporkan error PERMISSION_DENIED, bukan mengklasifikasikannya sebagai error koneksi.

Pengumuman penghentian penggunaan (21 Juni 2021)

Pengumuman ini menjelaskan penghentian penggunaan Driver SDK untuk Android dan Navigation SDK for Android pada tanggal yang tercantum di atas. Pengumuman ini juga dikirim sebagai Pengumuman Layanan Wajib (MSA) kepada pelanggan yang terpengaruh.

Menyederhanakan integrasi pelanggan dan mempercepat kemampuan kami dalam memberikan kami memisahkan Navigation SDK untuk Android dan Driver SDK untuk Android menjadi dua biner yang berbeda:

  • Navigation SDK untuk Android, yang akan menyediakan navigasi/pemilihan rute fungsionalitas untuk {i>driver<i} Anda.
  • Driver SDK untuk Android, yang akan memungkinkan Anda memanfaatkan Fleet Layanan web stateful mesin untuk progres dan alokasi perjalanan atau tugas.

Perhatikan bahwa Driver SDK untuk Android memiliki dependensi yang diperlukan pada Navigation SDK for Android untuk fungsi pemilihan rute inti.

Apa saja perubahannya?

Perubahan utama di v3 adalah:

  • Dua biner, bukan satu.
  • Definisi paket yang lebih jelas untuk Driver SDK untuk class Android.
  • Navigation SDK for Android menyertakan Maps SDK for Android sebagai bagian dari paket (mulai Navigation SDK for Android v2).
    • Hal ini memungkinkan fitur peta dan navigasi berdampingan di peta yang sama (seperti menggambar polyline di NavigationView) dan mengurangi penggunaan memori karena satu peta digunakan alih-alih dua.
    • Navigation SDK untuk Android 3.0 tidak memiliki fitur lengkap yang setara dengan Navigation SDK untuk Android, tetapi v3.2 akan menyelesaikan sebagian besar masalah di sini. Lihat Apa yang dapat saya lakukan & kapan? untuk mengetahui detail selengkapnya.
  • Logging yang akan memudahkan kami men-debug masalah yang mungkin Anda temui.

Metode berikut juga telah dihapus di v3, setelah sebelumnya ditandai sebagai tidak digunakan lagi dan yang solusi alternatifnya sudah ada:

  • Metode Nav/Driver SDK berikut tidak digunakan lagi dalam v1.16, dirilis pada 10 Agustus 2020, dan telah dihapus di v3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Agar lebih lengkap dan jelas, perhatikan bahwa sejumlah metode telah dihapus dalam transisi v1 ke v2. Sebagian besar laporan tersebut adalah konsolidasi duplikat antara Navigation SDK untuk Android dan Maps SDK for Android. Lihat panduan migrasi untuk lebih memahami perubahan ini.

Penghentian Driver SDK untuk Android dan Navigation SDK for Android v1.x

Nav/Driver SDK v1 dirilis pada tahun 2018, dan akan segera hadir dalam versi v3 dirilis, saatnya untuk menghentikan penggunaan v1 guna menghindari keberlanjutan mendukung banyak versi utama.

Waktu yang dihemat dengan tidak perlu mendukung versi tambahan ini akan untuk lebih mendukung versi utama terbaru dan membangun lebih banyak fitur yang sangatlah penting bagi pelanggan kami.

Dengan demikian, Nav/Driver SDK v1.x kini tidak digunakan lagi dan tidak akan dikelola lagi setelah 21 Juni 2022.

Luangkan waktu sejenak untuk melihat cara kerja penghentian penggunaan dalam versi SDK.

Baca pengumuman yang dicabut

Navigation SDK v4.0 untuk Android dan Driver SDK untuk Android akan mendukung minimum [Android 6.0 (level API 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. Versi minimum yang didukung saat ini adalah Android 5.0 (API level 21). Kami memperkirakan akan merilis versi v4.0 pada Q4 2021. Artinya:

  • Versi aplikasi yang dibuat dengan versi sebelum v4.x akan terus berfungsi Perangkat Android 21 dan 22. Aplikasi driver Anda yang telah mengintegrasikan SDK saat ini akan terus berfungsi di perangkat yang menjalankan Android 21+. Ini sama seperti sebelumnya.
  • Versi aplikasi yang dibuat dengan Driver SDK untuk Android dan Navigation SDK untuk Android v4.x (ditargetkan untuk Kuartal 4 2021, dapat berubah sewaktu-waktu) dan setelahnya tidak akan dapat diinstal di perangkat yang menjalankan Android 21 dan 22. v4.x akan berjalan pada Android minimum 6.0 (API level 23), jadi versi aplikasi yang dibuat dengan v4.x mendatang hanya dapat diterima oleh pengemudi dengan perangkat yang memiliki Android 23+. Untuk mengingatkan lagi, ini berarti perubahan terkait SDK dan perubahan aplikasi apa pun yang Anda yang dibuat tidak akan dapat menjangkau {i>driver<i} dengan perangkat yang menjalankan Android 21 dan 22.

Versi Navigation SDK untuk Android v3 dan Driver SDK untuk Android v3 yang ingin Anda upgrade akan dijelaskan dalam tabel berikut beserta kapan fitur tersebut akan tersedia.

Fitur platform Driver mana yang Anda gunakan? Apakah Anda menggunakan kemampuan ini? Kemudian, versi pertama yang tersedia dan harus Anda upgrade adalah... Ketersediaan yang Diharapkan
(dapat berubah sewaktu-waktu)
Link Migrasi
Khusus navigasi
(metode NavSDK)
Tidak NavSDK v3.0.1 Sekarang Panduan
Ya NavSDK v3.5 (proyeksi) Sep 2021
Navigasi dan Pelacakan Fleet Engine (metode NavSDK dan DriverSDK) Tidak Nav SDK v3.0 dan Driver SDK v3.0 Panduan migrasi Driver v3.0 tersedia saat dirilis
Ya NavSDK v3.x dan DriverSDK v3.0

Untuk terus menggunakan metode yang dihapus, Anda dapat tetap menggunakan v1.x, tetapi tanpa perkiraan dukungan atau pemeliharaan setelah 21 Juni 2022 (lihat bagian berikutnya).

Sebaiknya Anda bermigrasi ke v3.x. Artinya:

* Rilis terakhir v1.x akan terjadi pada Q4 2021 (sehingga v1 adalah “fitur dihentikan” sejak saat itu).

* Rilis terakhir ini dapat di-patch selama 6 bulan setelahnya, hingga 21 Juni 2022. Setelah tanggal tersebut, kami tidak akan dapat merespons bug atau permintaan fitur untuk v1.x.

Luangkan waktu untuk meninjau tabel berikut dan [panduan migrasi](/maps/documentation/navigation-sdk-android/v2/migration) di untuk membantu Anda mengatasi perubahan ini.

Kapan saya dapat melakukannya?

Jika saat ini Anda menggunakan... Apakah Anda menggunakan kemampuan ini? Untuk mengupgrade sekarang Untuk melakukan upgrade pada September 2021 Link Migrasi
v1.x
(tidak menggunakan fungsi FleetEngine.java / Driver)
Tidak NavSDK v3.0 Panduan
Ya Tidak ada opsi NavSDK 3.x
v1.x
(menggunakan fungsi FleetEngine.java / Driver)
Tidak Tidak ada opsi NavSDK 3.x +
DriverSDK 3.x
Panduan di atas, ditambah panduan migrasi Driver v3.0 yang tersedia saat dirilis.
Ya

Sebaiknya beri tahu pengemudi yang menggunakan perangkat yang menjalankan Android 21 dan 22 untuk mengupgrade ke versi Android yang lebih baru (minimum Android 6.0) sebelum Anda mengintegrasikan Driver SDK untuk Android dan Navigation SDK untuk Android versi v4.x dan yang lebih baru ke dalam aplikasi {i>driver<i} Anda.

v1.15.3 (9 Oktober 2020)

Update API

  • Driver SDK kini berlangganan Navigation SDK untuk mendapatkan info terbaru traffic, yang dikirim ke Fleet Engine API.

Perbaikan bug dan stabilitas

  • Memperbaiki error runtime gRPC.

v1.15.2

Fitur

Menambahkan kemampuan untuk menghentikan notifikasi persisten. Jika pelaporan lokasi dihentikan di instance Fleet Engine, panduan dihentikan dalam Navigator, semua pemroses navigasi tidak terdaftar, dan NavigationFragment atau NavigationView dijeda.

Perbaikan bug dan stabilitas

  • Memperbaiki bug yang menyebabkan ditampilkannya pengecualian jika instance Fleet Engine dihapus.

v1.15.1 (12 Mei 2020)

Fitur

Analisis awal data 1.15.0 menunjukkan peningkatan yang signifikan dalam pelaporan lokasi yang stabil (pengurangan lokasi yang "terhenti"). Perbaikan patch ini memungkinkan peningkatan pelaporan lokasi untuk dilanjutkan. Masalah ANR tidak terkait pada perbaikan ini.

Perbaikan bug dan stabilitas

  • Memperbaiki bug yang terkadang menyebabkan garis lurus di awal rute yang akan ditampilkan di aplikasi konsumen.
  • Memperbaiki bug yang dapat mengakibatkan ANR saat lokasi dilaporkan oleh SDK. Hasil ini dihasilkan dari onArrival() perbaikan yang rentan terhadap pertentangan kunci. Kami dapat mereproduksi ANR dengan andal dalam situasi tertentu dan dapat memverifikasi bahwa perbaikan telah diselesaikan menyelesaikan masalah. Aplikasi pengujian yang dimodifikasi untuk menghasilkan ANR selama delapan jam tanpa ANR setelah perbaikan.

v1.15.0 (23 Maret 2019)

Fitur

  • Memperkenalkan status panduan navigasi saat peristiwa awal, luar rute, kedatangan untuk meningkatkan pelacakan lokasi kendaraan.
  • Menambahkan kemampuan untuk terus mendapatkan lokasi yang diikat jalan secara independen negara bagian navigasi.
  • Menambahkan informasi tambahan tentang lokasi yang diambil sebelum jalan seperti akurasi.

Perbaikan Bug dan Stabilitas

  • Meningkatkan minSdkVersion untuk navsdk menjadi 19.
  • Memperbaiki bug yang menyebabkan nama Waypoint lat/lng tidak diikuti saat geocoding terbalik sisi-server gagal.

Rilis v1.14.2 (2 Feb 2019)

Fitur

  • Mencegah DriverSDK mengirim 0,0 lokasi ke Fleet Engine (lebih baik berbagi perjalanan, dan input lokasi alokasi).
  • Pencatatan log tambahan untuk memperbaiki masalah lokasi yang macet dan mengurangi fallback untuk berbagi perjalanan.
  • Abaikan panggilan berulang ke setLocationReportingInterval() kecuali jika intervalnya berubah.
  • Memperbarui javadocs untuk metode setReportingInterval() dengan tujuan mencegah pemanggilan berulang metode ini dengan kecepatan tinggi relatif dengan interval yang digunakan.
  • Keandalan lokasi API 29 ditingkatkan.

v1.13.0

Perbaikan bug dan stabilitas

  • Menambahkan dependensi pada okhttp yang harus ditambahkan klien ke build gradle mereka.

v1.11.7 (18 Oktober 2019)

Perbaikan bug dan stabilitas

  • Pembaruan lokasi sekarang berlanjut setelah onArrival() diaktifkan selama tujuan tertentu.
  • Notifikasi default (string konstan dalam mode Free Nav) cocok dengan skema warna yang disetel untuk notifikasi navigasi. Untuk informasi selengkapnya, lihat Notifikasi Persisten yang Dibagikan.
  • Mengatasi masalah saat peristiwa pembaruan lokasi yang tertunda dapat menyebabkan pembaruan lokasi palsu, yang menyebabkan artefak seperti garis lurus di awal rute.

v1.11.6 (4 Oktober 2019)

Update API

  • Memperkenalkan serangkaian perubahan yang memastikan Driver SDK dilanjutkan pembaruan lokasi dengan cepat setelah kegagalan jaringan. Setelah koneksi jaringan telah dipulihkan, pembaruan lokasi dimulai lagi pada lokasi terjadwal berikutnya memperbarui.

Perbaikan bug dan stabilitas

  • setVehicleState() sekarang kembali dengan segera. Pembaruan FleetEngine sekarang terjadi di latar belakang . Mengatasi masalah Aplikasi Tidak Merespons (ANR).
  • Memperbaiki masalah yang menyebabkan rute berbagi perjalanan ditampilkan sebagai garis lurus menggunakan versi lama Consumer SDK. Memastikan bahwa tidak titik jalan satu kali ditambahkan ke rute oleh Driver SDK.