ส่วนนี้ประกอบด้วยบันทึกประจำรุ่นของ Driver SDK สำหรับ Android
v8.0.0 (16 พฤศจิกายน 2026)
การอัปเดต API
- นำเมธอด
onGpsAvailabilityUpdate(boolean)ที่เลิกใช้งานแล้วออกจากRoadSnappedLocationProvider.GpsAvailabilityEnhancedLocationListener
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
อัปเดตกฎ ProGuard ของผู้ใช้เพื่อรองรับโหมดเต็มรูปแบบของ R8 (
android.enableR8.fullMode=true)อัปเกรด
targetSdkVersionเป็น API 37 แล้วอัปเกรดเวอร์ชันปลั๊กอิน Android Gradle เป็น 9.2.0
อัปเกรดเวอร์ชัน Gradle เป็น 9.4.1
เพิ่มทรัพยากร Dependency ของ Cronet:
com.google.android.gms:play-services-cronetเวอร์ชัน 18.0.1 และorg.chromium.net:cronetเวอร์ชัน 500.0.2อัปเดตช่วงเวอร์ชัน Navigation SDK ที่รองรับเป็น v8.0.0 ขึ้นไป
v7.99.0 (11 พฤศจิกายน 2026)
การแก้ไขข้อบกพร่อง
แก้ไขปัญหาที่การพยายามเชื่อมต่ออย่างปลอดภัยกับ Fleet Engine อาจค้างอยู่โดยไม่มีกำหนดหากพร็อกซีของผู้ให้บริการระดับกลางหยุดทำงานระหว่างการตั้งค่าการเชื่อมต่อ ซึ่งทำให้การอัปเดตสถานะการเดินทางและการติดตามยานพาหนะไม่รีเฟรชในเครือข่ายมือถือบางเครือข่าย ตอนนี้ Driver SDK จะบังคับใช้การหมดเวลาการเชื่อมต่อและกู้คืนโดยอัตโนมัติเมื่อมีการเชื่อมต่อใหม่
แก้ไขการรั่วไหลของเทรดและ Executor เมื่อเรียกใช้
DriverApi.clearInstance()(ExecutorFleetEngineEventHandler,FusedLocationWriterและDriverApi)
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
อัปเกรดทรัพยากร Dependency ของ Jetpack DataStore (
androidx.datastore:datastore-coreและandroidx.datastore:datastore-guava) เป็นเวอร์ชัน 1.2.1อัปเกรดเวอร์ชันทรัพยากร Dependency ของ Kotlin เป็น v2.4.0
อัปเดตช่วงเวอร์ชัน Navigation SDK ที่รองรับเป็น [7.9.0, 8.0.0)
v7.1.0 (14 พฤษภาคม 2026)
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
เพิ่มทรัพยากร Dependency ของ Jetpack DataStore:
androidx.datastore:datastore-coreเวอร์ชัน 1.1.7 และandroidx.datastore:datastore-guavaเวอร์ชัน 1.2.0อัปเกรดเวอร์ชันทรัพยากร Dependency ของ Kotlin เป็น v2.3.0
อัปเกรดเวอร์ชันปลั๊กอิน Android Gradle เป็น 8.13.2 แล้ว
อัปเกรดเวอร์ชัน Gradle เป็น 8.13
อัปเกรดเวอร์ชันไลบรารี Desugar เป็น 2.1.5
ขยายช่วงเวอร์ชัน Navigation SDK ที่รองรับจาก [7.0, 7.3) เป็น [7.0, 8.0)
v7.0.0 (5 ธันวาคม 2025)
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
อัปเกรด
minSdkVersionเป็น API 26 แล้วอัปเกรด
targetSdkVersionเป็น API 36 แล้วอัปเดตเวอร์ชันที่รองรับของ Navigation SDK โดยรวมและเริ่มต้นตั้งแต่ v7.0.0
v6.99.0 (5 ธันวาคม 2025)
- การปรับปรุงภายใน
ประกาศ: การหยุดรองรับ API ระดับ 23, 24 และ 25 ชั่วคราว
เพื่อให้เป็นไปตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนมือถือ เราจะหยุดรองรับ Android 6 และ 7 (API ระดับ 23, 24 และ 25) ใน Driver SDK สำหรับ Android เวอร์ชันหลักที่กำลังจะเปิดตัว
ตั้งแต่ v7.0.0 เป็นต้นไป Driver SDK สำหรับ Android จะรองรับ Android 8 (API ระดับ 26) เป็นอย่างน้อย SDK เวอร์ชันก่อนหน้าจะยังคงรองรับ Android 6 และ 7 ต่อไป
หากทรัพยากร Dependency ไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันใหม่ล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ Android 6 และ 7
ระบุเวอร์ชันของ Driver SDK สำหรับ Android ในทรัพยากร Dependency ของบิลด์ของแอปพลิเคชันเพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่
v6.2.0 (18 มิถุนายน 2025)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องของ
NullPointerExceptionขณะเรียกใช้DriverApi.createInstance()เมื่อไม่ได้ระบุDriverStatusListener
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
ตั้งแต่ Driver SDK สำหรับ Android เวอร์ชัน 6.2.0 เป็นต้นไป แอปต้องอัปเกรดเป็น Kotlin 2.1
อัปเดตเวอร์ชันที่รองรับของ Navigation SDK โดยเริ่มตั้งแต่ v6.1.0 เป็นต้นไป
v6.1.0 (10 มีนาคม 2025)
การแก้ไขข้อบกพร่อง
- การปรับปรุงการบันทึกภายใน
v5.99.1 (10 มกราคม 2025)
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC พร้อมรหัส "INTERNAL" และข้อความ "Panic! This is a bug!" description on application first launch after install.
v6.0.0 (25 พฤศจิกายน 2024)
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC พร้อมรหัส "INTERNAL" และข้อความ "Panic! This is a bug!" description.
- การปรับปรุงภายในเพื่อลดข้อผิดพลาดในการเชื่อมต่อการอัปเดตตำแหน่ง โดยเฉพาะเมื่ออุปกรณ์เปลี่ยนเครือข่าย เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว`
การอัปเดต API
- นำอินเทอร์เฟซ
StatusListenerที่เลิกใช้งานแล้วออก
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- นำทรัพยากร Dependency ไปยัง
glide:cronet-integrationใน POM.xml ออก - อัปเดตเวอร์ชันที่รองรับของ Navigation SDK เป็น v5.x
- ตั้งแต่ Driver SDK สำหรับ Android เวอร์ชัน 6.0.0 เป็นต้นไป แอปต้องอัปเกรดเป็น Kotlin 2.0
- ตอนนี้ targetSdk เป็นระดับ API 34 แล้ว ซึ่งเป็นข้อกำหนดสำหรับแอปทั้งหมดที่ติดตั้งใช้งานใน Google Play Store ตั้งแต่เดือนสิงหาคม 2024 เป็นต้นไป ดูปฏิบัติตามข้อกำหนดระดับ API เป้าหมายของ Google Play
v5.99.0 (20 กันยายน 2024)
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC พร้อมรหัส "INTERNAL" และข้อความ "Panic! This is a bug!" description. เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว
- การปรับปรุงภายในเพื่อลดข้อผิดพลาดในการเชื่อมต่อการอัปเดตตำแหน่ง โดยเฉพาะเมื่ออุปกรณ์เปลี่ยนเครือข่าย เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว`
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- นำทรัพยากร Dependency ไปยัง
glide:cronet-integrationใน POM.xml ออก
v5.0.0 (12 กันยายน 2023)
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- อัปเดต Navigation SDK เป็น v5.x
- อัปเกรด
minSdkVersionเป็น API 23 แล้ว - อัปเกรด Kotlin เป็นเวอร์ชัน 1.9.0
- เพิ่มทรัพยากร Dependency ใน Room แล้ว
* ตอนนี้แอปที่ใช้ Driver SDK ต้องมี
targetSdkVersionของ API 31 ขึ้นไป - ตอนนี้แอปที่ใช้ Driver SDK ต้องเปิดใช้การรองรับไลบรารี Java 8 ดูวิธีการอัปเดตได้ที่ https://developer.android.com/studio/write/java8-support
- แอปที่ใช้ Proguard หรือ Dexguard ต้องย้ายข้อมูลไปยัง R8 ดูข้อมูลเพิ่มเติมได้ที่ https://developer.android.com/build/shrink-code
- แอปที่ใช้ Driver SDK ต้องเปิดใช้กระบวนการ Desugaring ดูวิธีการได้ที่ https://developer.android.com/studio/write/java8-support#library-desugaring
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการซิงค์ disableLocationTracking
- เปิดตัวอินเทอร์เฟซ DriverStatusListener ใหม่ที่รายงานสาเหตุในการอัปเดตสถานะข้อยกเว้น
- แก้ไขปัญหาเกี่ยวกับคนขับที่จอดรถอยู่กับที่ (พร้อมใช้งานตั้งแต่ v4.99.0 เป็นต้นไป)
v4.99.0 (9 สิงหาคม 2023)
- รองรับเวอร์ชันต่างๆ สำหรับทรัพยากร Dependency ของ NavSDK ** รองรับ v4.5.0 จนถึง (แต่ไม่รวม) v5.0.0
- ป้องกันไม่ให้ ETA ลดลงเองเมื่อยานพาหนะจอดอยู่กับที่ เราจะทยอยเปิดตัวการเปลี่ยนแปลงนี้เป็นการทดสอบ ดังนั้นผู้สมัครบางรายอาจไม่เห็นการเปลี่ยนแปลงนี้พร้อมกัน
v4.5.0 (12 พฤษภาคม 2023)
- อัปเดตทรัพยากร Dependency ของ Navigation SDK เป็น v4.5 โปรดทราบว่ารหัสกลุ่มและรหัสอาร์ติแฟกต์สำหรับ Navigation SDK มีการเปลี่ยนแปลง
v4.4.3 (20 มีนาคม 2023)
การเปลี่ยนแปลงการขึ้นต่อกัน
- อัปเกรดทรัพยากร Dependency ของ Navigation SDK เป็น v4.4.1
v4.4.2 (15 กุมภาพันธ์ 2023)
การแก้ไขข้อบกพร่อง
ปรับปรุงเวลาการกู้คืนเครือข่ายเมื่อ SDK พบปัญหาการเชื่อมต่อชั่วคราว การแก้ไขนี้เป็นการทดลอง
ทิ้งคำขอ
UpdateVehicleรายการที่มีเฉพาะตำแหน่ง "ดิบ"แก้ไขภาวะแข่งขันใน ALPHA API "ภาพรวมเส้นทาง"
v4.4.1 (18 พฤศจิกายน 2022)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องในตรรกะการอัปโหลดการเข้าชม
การเปลี่ยนแปลงเพิ่มเติม
- การปรับปรุงภายในในส่วนหัวของคำขอและการรายงานรหัสสถานะ
v4.4.0 (21 กันยายน 2022)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้ไม่สามารถนำการแจ้งเตือน "การขับรถด้วย Google Maps" ออกได้หากไม่ได้ล้างอินสแตนซ์ API
การเปลี่ยนแปลงการขึ้นต่อกัน
- อัปเกรดทรัพยากร Dependency ของ Navigation SDK เป็น v4.2.2
v4.3.0 (24 สิงหาคม 2022)
การปรับปรุงภายใน
ประกาศ: การหยุดให้การสนับสนุน Android 5 (21 กรกฎาคม 2022)
สำหรับ SDK เวอร์ชันล่าสุด (v4.2.0) เราจะให้การสนับสนุนเพิ่มเติมอีก 1 ปีสำหรับแอปที่ทำงานบน Android 5 ทั้งระดับ API 21 และ 22
การดำเนินการนี้หมายความว่าอย่างไร
- Navigation SDK และ Driver SDK ที่ทำงานในแอป Android จะรองรับ Android 5 (API ระดับ 21) เป็นอย่างต่ำจนถึงวันที่ 30 มิถุนายน 2023
- หลังจากวันที่ 30 มิถุนายน 2023 เราจะรองรับเฉพาะ Android API ระดับ 23 ขึ้นไปเท่านั้น กล่าวคือ เราจะหยุดรองรับ Android API ระดับ 21 และ 22 ใน SDK ทุกเวอร์ชันหลังจากวันที่ดังกล่าว ซึ่งหมายความว่าข้อบกพร่องที่เกี่ยวข้องกับ Android 21 หรือ 22 ใน SDK เวอร์ชันใดก็ตาม (รวมถึง 4.x) จะไม่ได้รับการแก้ไข และเราไม่รับประกันว่า SDK จะทำงานอย่างถูกต้อง
ประกาศนี้จะลบล้างประกาศการระงับการรองรับ Android 21 และ 22 ตั้งแต่วันที่ 21 มิถุนายน 2021 และการระงับการรองรับ Android 23, 24 และ 25 ตั้งแต่วันที่ 18 ตุลาคม 2021
v4.2.0 (8 มิถุนายน 2022)
การเปลี่ยนแปลงการขึ้นต่อกัน
- อัปเกรดทรัพยากร Dependency ของ Nav SDK เป็น v4.1.3
- ดาวน์เกรดระดับ API ขั้นต่ำของ Android ที่รองรับเป็น 21
v4.1.0 (28 เมษายน 2022)
การอัปเดต API
เปลี่ยนชื่อพร็อพเพอร์ตี้
parentIdของออบเจ็กต์Taskเป็นtrackingIdแล้ว พร็อพเพอร์ตี้เก่าจะยังคงอยู่ แต่เลิกใช้งานแล้ว
v4.0.0 (29 พฤศจิกายน 2021)
ระดับ API ขั้นต่ำของ Android ที่รองรับสำหรับรุ่นนี้คือ 23
การอัปเดต API
สำหรับรุ่นนี้ Driver SDK สำหรับ Android ได้รับการอัปเดตด้วยการเปลี่ยนแปลงต่อไปนี้
การเปลี่ยนแปลง VehicleStops API
ตอนนี้ออบเจ็กต์ VehicleStop จะอ้างอิงรายการออบเจ็กต์ TaskInfo แทนรายการออบเจ็กต์ Task หากต้องการสถานะงาน เราขอแนะนำให้ติดตามสถานะดังกล่าวในโค้ดของแอปพลิเคชัน
เพิ่มชั้นเรียนใหม่:
TaskInfoแทนที่ฟังก์ชัน
getTasksของVehicleStopด้วยฟังก์ชันgetTaskInfoListแล้วแทนที่ฟังก์ชัน
setTasksของVehicleStop.Builderด้วยฟังก์ชันsetTaskInfoListแล้ว
การตรวจสอบข้อขัดข้อง
เราได้เพิ่มการตรวจสอบและการรายงานข้อขัดข้องเพื่อช่วยปรับปรุงความเสถียรของ SDK
ฟีเจอร์นี้เปิดใช้อยู่โดยค่าเริ่มต้น แต่คุณปิดใช้ได้หากเรียกใช้ setAbnormalTerminationReportingEnabled() และส่งค่า false ก่อนเริ่มต้น SDK
- เพิ่มฟังก์ชัน
setAbnormalTerminationReportingEnabledลงในDriverApiแล้ว
Async getRemainingVehicleStops
- เปลี่ยนฟังก์ชัน
getRemainingVehicleStopsของDeliveryVehicleReporterให้แสดงผล Future<List<VehicleStop>> แทน List<VehicleStop>
การตรวจสอบสิทธิ์
นำพร็อพเพอร์ตี้ที่ไม่จำเป็นออกจากอินเทอร์เฟซ AuthTokenContext
ServiceType เลิกใช้งานแล้ว ตอนนี้คุณเพียงแค่ต้องรับการอ้างสิทธิ์สำหรับรหัสยานพาหนะและรหัสงานที่รวมไว้ แทนที่จะต้องใช้ ServiceType
นำ
ServiceTypeออกจากAuthTokenContextแล้วนำ
getServiceType()ออกจากAuthTokenContextแล้วนำ
setServiceTypeออกจากAuthTokenContext.Builderแล้ว
18 ตุลาคม 2021 - ระงับการรองรับ API ระดับ 23, 24 และ 25
อ่านประกาศวันที่ 18 ตุลาคม
เพื่อตอบสนองต่อการเปลี่ยนแปลงในทรัพยากร Dependency ภายในของเรา ระบบจะไม่รองรับ Android API ระดับ 23, 24 และ 25 (Android 6, 7.0 และ 7.1) ใน Navigation SDK และ Driver SDK สำหรับ Android เวอร์ชันใหม่ โดยจะเริ่มตั้งแต่ไตรมาสที่ 3 ของปี 2022
SDK การนำทางและ SDK สำหรับคนขับสำหรับ Android เวอร์ชันที่เปิดตัวตั้งแต่ไตรมาสที่ 3 ของปี 2022 จะรองรับเฉพาะอุปกรณ์ที่ใช้ Android API ระดับ 26 เป็นอย่างน้อย
เวอร์ชันแอปที่สร้างด้วย Navigation SDK และ Driver SDK สำหรับ Android เวอร์ชัน 4.x หรือต่ำกว่าจะยังคงทำงานในอุปกรณ์ที่ใช้ Android API ระดับ 25 และต่ำกว่าต่อไป
v3.0.4 (28 กรกฎาคม 2021)
ฟีเจอร์
ในรุ่นนี้ Driver SDK จะแยกออกจาก Navigation SDK อย่างเป็นทางการ ดูรายละเอียดได้จาก คำแนะนำในการย้ายข้อมูล
การอัปเดต API
เพิ่มวิธีการต่อไปนี้
`RidesharingDriverApi.getDriverSdkVersion()`ความเสถียรและการแก้ไขข้อบกพร่อง
รายงานข้อผิดพลาด PERMISSION_DENIED แทนที่จะจัดประเภทเป็นข้อผิดพลาดในการเชื่อมต่อ
ประกาศการเลิกใช้งาน (21 มิถุนายน 2021)
ประกาศนี้อธิบายการเลิกใช้งาน Driver SDK สำหรับ Android และ Navigation SDK สำหรับ Android ณ วันที่ที่ระบุไว้ข้างต้น นอกจากนี้ เรายังส่งประกาศนี้เป็นประกาศการให้บริการที่คุณจำเป็นต้องได้รับ (MSA) ไปยังลูกค้าที่ได้รับผลกระทบด้วย
Nav/Driver SDK สำหรับ Android จะกลายเป็น Navigation SDK สำหรับ Android v3.x และ Driver SDK สำหรับ Android v3.x สำหรับ Android (ไบนารีแยก)
เราจะแยก Navigation SDK สำหรับ Android และ Driver SDK สำหรับ Android ออกเป็นไบนารี 2 รายการที่แตกต่างกันเพื่อลดความซับซ้อนในการผสานรวมของลูกค้าและเร่งความสามารถในการนำเสนอฟีเจอร์ที่มีประโยชน์ ดังนี้
- Navigation SDK สำหรับ Android ซึ่งจะมอบฟังก์ชันการนำทาง/การกำหนดเส้นทางให้แก่คนขับ
- Driver SDK สำหรับ Android ซึ่งจะช่วยให้คุณใช้ประโยชน์จากเว็บเซอร์วิสแบบเก็บสถานะของ Fleet Engine สำหรับความคืบหน้าและการจัดสรรการเดินทางหรืองานได้
โปรดทราบว่า Driver SDK สำหรับ Android มีทรัพยากร Dependency ที่จำเป็นใน Navigation SDK สำหรับ Android สำหรับฟังก์ชันการกำหนดเส้นทางหลัก
การเปลี่ยนแปลงมีอะไรบ้าง
การเปลี่ยนแปลงที่สำคัญใน v3 มีดังนี้
- ไบนารี 2 รายการแทนที่จะเป็นรายการเดียว
- คำจำกัดความของแพ็กเกจที่ชัดเจนยิ่งขึ้นสำหรับคลาส Driver SDK สำหรับ Android
- Navigation SDK สำหรับ Android มี Maps SDK สำหรับ Android เป็นส่วนหนึ่งของแพ็กเกจ (ตั้งแต่ Navigation SDK สำหรับ Android เวอร์ชัน 2)
- ซึ่งช่วยให้ฟีเจอร์แผนที่และการนำทางอยู่ร่วมกันในแผนที่เดียวกันได้ (เช่น การวาดเส้นประกอบใน NavigationView) และลดการใช้งานหน่วยความจำเนื่องจากใช้แผนที่เดียวแทนที่จะเป็น 2 แผนที่
- Navigation SDK สำหรับ Android 3.0 ไม่มีฟีเจอร์ที่เทียบเท่ากับ Navigation SDK สำหรับ Android แต่เวอร์ชัน 3.2 จะช่วยแก้ปัญหาส่วนใหญ่ได้ ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อฉันจะทำอะไรได้บ้างและเมื่อใด
- การบันทึกจะช่วยให้เราแก้ไขข้อบกพร่องที่คุณอาจพบได้ง่ายขึ้น
นอกจากนี้ เรายังนำเมธอดต่อไปนี้ออกใน v3 เนื่องจากก่อนหน้านี้ได้ทำเครื่องหมายว่าเลิกใช้งานแล้วและมีโซลูชันอื่นอยู่แล้ว
- เมธอด Nav/Driver SDK ต่อไปนี้เลิกใช้งานแล้วใน v1.16 ซึ่งเปิดตัวเมื่อวันที่ 10 สิงหาคม 2020 และถูกนำออกใน v3.0
Waypoint#fromLatLng(*)Waypoint#fromPlaceId(*)Navigator#startGuidance(resumeIntent)NavigationApi#initForegroundServiceManager(*)
- โปรดทราบว่าเราได้นำเมธอดจำนวนหนึ่งออกในการเปลี่ยนจาก v1 เป็น v2 เพื่อความสมบูรณ์และความชัดเจน การเปลี่ยนแปลงส่วนใหญ่เป็นการรวมคลาสที่ซ้ำกันระหว่าง Navigation SDK สำหรับ Android กับ Maps SDK สำหรับ Android โปรดดูคำแนะนำในการย้ายข้อมูลเพื่อทำความเข้าใจการเปลี่ยนแปลงเหล่านี้ให้ดียิ่งขึ้น
การเลิกใช้งาน Driver SDK สำหรับ Android และ Navigation SDK สำหรับ Android v1.x
Nav/Driver SDK v1 เปิดตัวในปี 2018 และเนื่องจากเราจะเปิดตัวเวอร์ชัน v3 ในเร็วๆ นี้ จึงถึงเวลาแล้วที่จะเลิกใช้งาน v1 เพื่อหลีกเลี่ยงความไม่ยั่งยืนในการรองรับเวอร์ชันหลักหลายเวอร์ชัน
เวลาที่ประหยัดได้จากการไม่ต้องรองรับเวอร์ชันเพิ่มเติมนี้จะช่วยให้เราสามารถรองรับเวอร์ชันหลักล่าสุดได้ดียิ่งขึ้น และสร้างฟีเจอร์ที่สำคัญต่อลูกค้าได้มากขึ้น
ดังนั้น Nav/Driver SDK v1.x จึงเลิกใช้งานแล้วและจะไม่มีการดูแลรักษาอีกต่อไปหลังจากวันที่ 21 มิถุนายน 2022
โปรดสละเวลาสักครู่เพื่อดูวิธีการทำงานของการเลิกใช้งานใน SDK เวอร์ชันต่างๆ
การสิ้นสุดการรองรับ Navigation SDK และ Driver SDK สำหรับ Android 21 และ 22
อ่านประกาศที่เพิกถอน
Navigation SDK สำหรับ Android และ Driver SDK สำหรับ Android เวอร์ชัน 4.0 ที่กำลังจะเปิดตัวจะรองรับ [Android 6.0 (API ระดับ 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external} เป็นอย่างน้อย เวอร์ชันขั้นต่ำที่รองรับในปัจจุบันคือ Android 5.0 (ระดับ API 21) เราคาดการณ์ว่าจะเปิดตัว v4.0 ในไตรมาสที่ 4 ปี 2021 ซึ่งหมายความว่า
- แอปเวอร์ชันที่สร้างด้วยเวอร์ชันก่อนหน้า v4.x จะยังคงทำงานในอุปกรณ์ Android 21 และ 22 ต่อไป แอปคนขับที่ผสานรวม SDK ปัจจุบันของเราจะยังคงทำงานบนอุปกรณ์ที่ใช้ Android 21 ขึ้นไปได้เหมือนเดิม
- แอปเวอร์ชันที่สร้างด้วย Driver SDK สำหรับ Android และ Navigation SDK สำหรับ Android v4.x (กำหนดเป้าหมายเป็นไตรมาสที่ 4 ปี 2021 และอาจมีการเปลี่ยนแปลง) และหลังจากนั้นจะไม่สามารถติดตั้งในอุปกรณ์ที่ใช้ Android 21 และ 22 ได้ v4.x จะทำงานบน Android 6.0 (API ระดับ 23) เป็นอย่างน้อย ดังนั้นแอปเวอร์ชันที่สร้างด้วย v4.x ที่กำลังจะเปิดตัวจะใช้งานได้เฉพาะคนขับที่ใช้อุปกรณ์ที่ใช้ Android 23 ขึ้นไปเท่านั้น ขอย้ำอีกครั้งว่าทั้งการเปลี่ยนแปลงที่เกี่ยวข้องกับ SDK และการเปลี่ยนแปลงแอปที่คุณทำจะไม่ส่งผลต่อคนขับที่ใช้อุปกรณ์ที่ใช้ Android 21 และ 22
เวอร์ชันของ Navigation SDK สำหรับ Android v3 และ Driver SDK สำหรับ Android v3 ที่คุณต้องการอัปเกรดจะอธิบายไว้ในตารางต่อไปนี้ พร้อมกับช่วงเวลาที่พร้อมใช้งาน
| คุณใช้ฟีเจอร์ใดของแพลตฟอร์ม Driver | คุณใช้ความสามารถเหล่านี้หรือไม่ | เวอร์ชันแรกที่พร้อมใช้งานซึ่งคุณควรอัปเกรดคือ... | ความพร้อมให้บริการที่คาดไว้ (อาจมีการเปลี่ยนแปลง) |
ลิงก์การย้ายข้อมูล |
|---|---|---|---|---|
| การนำทางเท่านั้น (เมธอด NavSDK) |
ไม่ | NavSDK v3.0.1 | ตอนนี้ | คู่มือ |
| ใช่ | NavSDK v3.5 (คาดการณ์) | ก.ย. 2021 | ||
| การนำทางและการติดตาม Fleet Engine (เมธอด NavSDK และ DriverSDK) | ไม่ | Nav SDK v3.0 และ Driver SDK v3.0 | คำแนะนำในการย้ายข้อมูลไดรเวอร์ v3.0 พร้อมใช้งานเมื่อเปิดตัว | |
| ใช่ | NavSDK v3.x และ DriverSDK v3.0 |
หากต้องการใช้วิธีการที่ถูกนำออกต่อไป คุณสามารถใช้ v1.x ต่อได้ แต่จะไม่ได้รับการสนับสนุนหรือการบำรุงรักษาหลังจากวันที่ 21 มิถุนายน 2022 (ดูส่วนถัดไป)
เราขอแนะนำให้ย้ายข้อมูลไปใช้ v3.x ซึ่งหมายความว่า
* เวอร์ชันสุดท้ายของ v1.x จะเปิดตัวในไตรมาสที่ 4 ปี 2021 (และ v1 จะ "หยุดเพิ่มฟีเจอร์" ตั้งแต่นั้นเป็นต้นไป)
* เวอร์ชันสุดท้ายนี้สามารถแพตช์ได้เป็นเวลา 6 เดือนหลังจากนั้น จนถึงวันที่ 21 มิถุนายน 2022 หลังจากนั้น เราจะไม่สามารถตอบสนองต่อคำขอแก้ไขข้อบกพร่องหรือคำขอฟีเจอร์สำหรับ v1.x ได้
โปรดสละเวลาสักครู่เพื่อดูตารางต่อไปนี้และ[คำแนะนำในการย้ายข้อมูล](/maps/documentation/navigation-sdk-android/v2/migration) เพื่อช่วยให้คุณเข้าใจการเปลี่ยนแปลงเหล่านี้
ฉันต้องทำอะไรบ้างและภายในเมื่อใด
| หากปัจจุบันคุณใช้... | คุณใช้ความสามารถเหล่านี้หรือไม่ | วิธีอัปเกรดตอนนี้ | อัปเกรดในเดือนกันยายน 2021 | ลิงก์การย้ายข้อมูล |
|---|---|---|---|---|
| v1.x (ไม่ได้ใช้ FleetEngine.java / ฟังก์ชันการทำงานของคนขับ) |
ไม่ | NavSDK v3.0 | คู่มือ | |
| ใช่ | ไม่มีตัวเลือก | NavSDK 3.x | ||
| v1.x (ใช้ FleetEngine.java / ฟังก์ชันการทำงานของคนขับ) |
ไม่ | ไม่มีตัวเลือก | NavSDK 3.x + DriverSDK 3.x |
คำแนะนำข้างต้น รวมถึงคำแนะนำในการย้ายข้อมูล Driver v3.0 ที่พร้อมใช้งานเมื่อเปิดตัว |
| ใช่ | ||||
เราขอแนะนำให้คุณแจ้งคนขับที่ใช้อุปกรณ์ Android 21 และ 22 ให้อัปเกรดเป็น Android เวอร์ชันใหม่ (Android 6.0 เป็นอย่างน้อย) ก่อนที่จะผสานรวม Driver SDK สำหรับ Android และ Navigation SDK สำหรับ Android เวอร์ชัน v4.x ขึ้นไปไว้ในแอปคนขับ
v1.15.3 (9 ตุลาคม 2020)
การอัปเดต API
- ตอนนี้ Driver SDK จะสมัครใช้บริการ Navigation SDK เพื่อรับข้อมูลอัปเดตการจราจร ซึ่งจะส่งไปยัง Fleet Engine API
ความเสถียรและการแก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องเกี่ยวกับรันไทม์ gRPC
v1.15.2
ฟีเจอร์
เพิ่มความสามารถในการหยุดการแจ้งเตือนแบบถาวร หากการรายงานตำแหน่งหยุดลงในอินสแตนซ์ Fleet Engine การแนะนำจะหยุดลงใน Navigator ระบบจะยกเลิกการลงทะเบียน Listener การนำทางทั้งหมด และ NavigationFragment หรือ NavigationView จะหยุดชั่วคราว
ความเสถียรและการแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้เกิดข้อยกเว้นหากอินสแตนซ์ Fleet Engine ถูกล้าง
v1.15.1 (12 พฤษภาคม 2020)
ฟีเจอร์
การวิเคราะห์ข้อมูลเบื้องต้นของเวอร์ชัน 1.15.0 บ่งชี้ถึงการปรับปรุงที่สำคัญในการรายงานตำแหน่งที่เสถียร (ลดตำแหน่งที่ "ค้าง") การแก้ไขแพตช์นี้ช่วยให้การรายงานตำแหน่งที่ได้รับการปรับปรุงทำงานต่อไปได้ ปัญหา ANR ไม่เกี่ยวข้องกับการปรับปรุงเหล่านี้
ความเสถียรและการแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่บางครั้งทำให้เส้นตรงที่จุดเริ่มต้นของเส้นทางแสดงในแอปผู้บริโภค
- แก้ไขข้อบกพร่องที่อาจส่งผลให้เกิด ANR เมื่อ SDK รายงานตำแหน่ง ซึ่งเป็นผลมาจากการปรับปรุง
onArrival()รายการที่เสี่ยงต่อการแย่งชิงล็อก เราสามารถจำลอง ANR ได้อย่างน่าเชื่อถือในบางสถานการณ์ และสามารถยืนยันได้ว่าการแก้ไขช่วยแก้ปัญหาได้ แอปทดสอบที่แก้ไขแล้วเพื่อสร้าง ANR ทำงานเป็นเวลา 8 ชั่วโมงโดยไม่มี ANR หลังจากแก้ไข
v1.15.0 (23 มีนาคม 2019)
ฟีเจอร์
- เปิดตัวสถานะคำแนะนำการนำทางเมื่อเริ่มเดินทาง ออกนอกเส้นทาง และเมื่อถึงจุดหมาย เพื่อปรับปรุงการติดตามตำแหน่งของยานพาหนะ
- เพิ่มความสามารถในการรับตำแหน่งที่สแนปกับถนนต่อไปโดยไม่ขึ้นอยู่กับสถานะการนำทาง
- เพิ่มข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งที่ยังไม่ได้ปรับให้เข้ากับถนน เช่น ความแม่นยำ
ความเสถียรและการแก้ไขข้อบกพร่อง
- เพิ่ม minSdkVersion สำหรับ navsdk เป็น 19
- แก้ไขข้อบกพร่องที่ทำให้ระบบไม่ใช้ชื่อจุดอ้างอิงละติจูด/ลองจิจูดเมื่อการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับฝั่งเซิร์ฟเวอร์ไม่สำเร็จ
รุ่น v1.14.2 (2 ก.พ. 2019)
ฟีเจอร์
- ป้องกันไม่ให้ DriverSDK ส่งตำแหน่ง 0,0 ไปยัง Fleet Engine (การแชร์เส้นทางและอินพุตตำแหน่งการจัดสรรที่ดีขึ้น)
- การบันทึกเพิ่มเติมเพื่อปรับปรุงปัญหาตำแหน่งค้างและลดการสำรองสำหรับการแชร์เส้นทาง
- ละเว้นการเรียกใช้
setLocationReportingInterval()ซ้ำๆ เว้นแต่ช่วงเวลาจะเปลี่ยนแปลง - อัปเดต javadocs สำหรับเมธอด
setReportingInterval()โดยมีวัตถุประสงค์เพื่อไม่ให้เรียกใช้เมธอดนี้ซ้ำๆ ในอัตราที่สูงเมื่อเทียบกับช่วงเวลาที่ใช้ - ปรับปรุงความน่าเชื่อถือของตำแหน่ง API 29
v1.13.0
ความเสถียรและการแก้ไขข้อบกพร่อง
- เพิ่มทรัพยากร Dependency ใน okhttp ที่ไคลเอ็นต์จะต้องเพิ่มลงในบิลด์ Gradle
v1.11.7 (18 ตุลาคม 2019)
ความเสถียรและการแก้ไขข้อบกพร่อง
- ตอนนี้การอัปเดตตำแหน่งจะดำเนินต่อไปหลังจากที่
onArrival()เริ่มทำงานสำหรับปลายทางที่ระบุ - การแจ้งเตือนเริ่มต้น (สตริงคงที่ในโหมดการนำทางฟรี) จะตรงกับรูปแบบสีที่ตั้งไว้สำหรับการแจ้งเตือนการนำทาง ดูข้อมูลเพิ่มเติมได้ที่การแจ้งเตือนแบบถาวรที่แชร์
- แก้ไขปัญหาที่เหตุการณ์การอัปเดตตำแหน่งที่ล่าช้าอาจทำให้เกิดการอัปเดตตำแหน่งที่ผิดพลาด ซึ่งทำให้เกิดข้อผิดพลาด เช่น เส้นตรงที่จุดเริ่มต้นของเส้นทาง
v1.11.6 (4 ตุลาคม 2019)
การอัปเดต API
- เปิดตัวการเปลี่ยนแปลงหลายอย่างที่ช่วยให้ Driver SDK กลับมาอัปเดตตำแหน่งได้อย่างรวดเร็วหลังจากเครือข่ายขัดข้อง เมื่อการเชื่อมต่อเครือข่ายกลับมาเป็นปกติแล้ว การอัปเดตตำแหน่งจะเริ่มอีกครั้งในการอัปเดตตำแหน่งตามกำหนดเวลาครั้งถัดไป
ความเสถียรและการแก้ไขข้อบกพร่อง
setVehicleState()จะแสดงผลทันที ตอนนี้การอัปเดต FleetEngine จะเกิดขึ้นในเทรดเบื้องหลัง แก้ไขปัญหาแอปพลิเคชันไม่ตอบสนอง (ANR)- แก้ไขปัญหาที่ทำให้เส้นทางการแชร์เส้นทางแสดงเป็นเส้นตรงเมื่อใช้ Consumer SDK เวอร์ชันเก่า ตรวจสอบว่า Driver SDK ไม่ได้เพิ่มจุดอ้างอิงแบบครั้งเดียวลงในเส้นทาง