บันทึกประจำรุ่นของ Driver SDK สำหรับ Android

ส่วนนี้มีบันทึกประจำรุ่นสำหรับ Driver SDK สำหรับ Android

ประกาศ: หยุดให้บริการ API ระดับ 23, 24 และ 25

ตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เราจะ หยุดการรองรับ Android 6 และ 7 (API ระดับ 23, 24 และ 25) ใน Driver SDK สำหรับ Android เวอร์ชันหลักที่กำลังจะเปิดตัว

Driver SDK สำหรับ Android เวอร์ชันที่เปิดตัวตั้งแต่ไตรมาสที่ 4 ปี 2025 จะรองรับ Android 8 (API ระดับ 26) เป็นอย่างน้อย SDK เวอร์ชันก่อนหน้าจะ ยังคงรองรับ Android 6 และ 7 ต่อไป

หากการขึ้นต่อกันไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ Android 6 และ 7

ระบุเวอร์ชันของ Driver SDK สำหรับ Android ในการอ้างอิงการสร้างของแอปพลิเคชัน เพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่

v6.2.0 (18 มิถุนายน 2025)

การแก้ไขข้อบกพร่อง

  • แก้ไขปัญหา NullPointerException ขัดข้องขณะโทรหา DriverApi.createInstance() เมื่อไม่มี DriverStatusListener

การเปลี่ยนแปลงการกำหนดค่าและการขึ้นต่อกัน

  • ตั้งแต่ Driver SDK สำหรับ Android เวอร์ชัน 6.2.0 เป็นต้นไป แอปจะต้องอัปเกรด เป็น Kotlin 2.1

  • อัปเดต SDK การนำทางที่รองรับเวอร์ชันที่ระบุช่วง รวมถึง ตั้งแต่ v6.1.0 เป็นต้นไป

v6.1.0 (10 มีนาคม 2025)

การแก้ไขข้อบกพร่อง

  • การปรับปรุงการบันทึกภายใน

v5.99.1 (10 มกราคม 2025)

การแก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC ที่มีรหัส "INTERNAL" และ "Panic! นี่เป็นข้อบกพร่อง!" ในการเปิดแอปพลิเคชันครั้งแรกหลังการติดตั้ง

v6.0.0 (25 พฤศจิกายน 2024)

การแก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ไดรเวอร์ได้รับข้อผิดพลาด gRPC ที่มีรหัส "INTERNAL" และ "Panic! This is a bug!" description.
  • การปรับปรุงภายในเพื่อลดข้อผิดพลาดในการเชื่อมต่อการอัปเดตตำแหน่ง โดยเฉพาะอย่างยิ่งเมื่ออุปกรณ์เปลี่ยนเครือข่าย โดยจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมการเปิดตัวแล้ว`

การอัปเดต API

  • นำอินเทอร์เฟซที่เลิกใช้งานแล้ว StatusListener ออกแล้ว

การเปลี่ยนแปลงการกำหนดค่าและการขึ้นต่อกัน

  • นำการอ้างอิงถึง 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%) เมื่อผสานรวมการเปิดตัวแล้ว`

การเปลี่ยนแปลงการกำหนดค่าและการขึ้นต่อกัน

  • นำการอ้างอิงถึง glide:cronet-integration ใน POM.xml ออก

v5.0.0 (12 กันยายน 2023)

การเปลี่ยนแปลงการกำหนดค่าและการขึ้นต่อกัน

  • อัปเดต Navigation SDK เป็น v5.x
  • อัปเกรด minSdkVersion เป็น API 23
  • อัปเกรด Kotlin เป็นเวอร์ชัน 1.9.0
  • เพิ่มการอ้างอิงใน 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 ต้องเปิดใช้การยกเลิกการเพิ่มไวยากรณ์ ดูวิธีการได้ที่ https://developer.android.com/studio/write/java8-support#library-desugaring

การแก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเกี่ยวกับการซิงค์ disableLocationTracking
  • เปิดตัวอินเทอร์เฟซ DriverStatusListener ใหม่ที่รายงานสาเหตุในการอัปเดตสถานะข้อยกเว้น
  • แก้ไขปัญหาสำหรับคนขับที่จอดอยู่กับที่ (พร้อมใช้งานตั้งแต่เวอร์ชัน v4.99.0)

v4.99.0 (9 สิงหาคม 2023)

  • รองรับการอ้างอิง NavSDK ในหลายเวอร์ชัน ** รองรับ v4.5.0 จนถึง (แต่ไม่รวม) v5.0.0
  • ป้องกันไม่ให้เวลาถึงโดยประมาณลดลงเองเมื่อยานพาหนะจอดอยู่ การเปลี่ยนแปลงนี้จะทยอยเปิดตัวในรูปแบบการทดสอบ ดังนั้นแอปพลิเคชันบางรายการอาจไม่เห็นการเปลี่ยนแปลงนี้พร้อมกัน

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 เราจะรองรับเฉพาะ API ระดับ 23 ขึ้นไปของ Android กล่าวคือ เราจะหยุดรองรับ 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 หากต้องการสถานะของ Task เราขอแนะนำให้คุณติดตามสถานะในโค้ดของแอปพลิเคชัน

  • เพิ่มคลาสใหม่: TaskInfo

  • แทนที่ฟังก์ชัน getTasks ของ VehicleStop ด้วยฟังก์ชัน getTaskInfoList

  • แทนที่ฟังก์ชัน setTasks ของ VehicleStop.Builder ด้วยฟังก์ชัน setTaskInfoList

การตรวจสอบข้อขัดข้อง

เราได้เพิ่มการตรวจสอบและการรายงานข้อขัดข้องเพื่อช่วยปรับปรุงความเสถียรของ SDK ฟีเจอร์นี้จะเปิดใช้อยู่โดยค่าเริ่มต้น แต่คุณปิดใช้ได้หากเรียกใช้ setAbnormalTerminationReportingEnabled() และส่งค่า false ก่อน ที่จะเริ่มต้น SDK

Async getRemainingVehicleStops

การตรวจสอบสิทธิ์

นำพร็อพเพอร์ตี้ที่ไม่จำเป็นออกจากอินเทอร์เฟซ AuthTokenContext ServiceType เลิกใช้งานแล้ว ตอนนี้คุณเพียงแค่ต้องรับการอ้างสิทธิ์สำหรับ รหัสยานพาหนะและรหัสงานที่รวมไว้ แทนที่จะต้องพึ่งพาServiceType

18 ตุลาคม 2021 - หยุดการสนับสนุน API ระดับ 23, 24 และ 25

อ่านประกาศวันที่ 18 ตุลาคม

เนื่องจากการเปลี่ยนแปลงใน Dependencies ภายในของเรา ระบบจะไม่รองรับ Android API ระดับ 23, 24 และ 25 (Android 6, 7.0 และ 7.1) ใน SDK การนำทางและ Driver SDK สำหรับ Android เวอร์ชันใหม่ โดยจะเริ่มตั้งแต่ไตรมาสที่ 3 ของปี 2022

SDK การนำทางและ SDK ไดรเวอร์สำหรับ Android เวอร์ชันที่เปิดตัวตั้งแต่ไตรมาสที่ 3 ของปี 2022 จะรองรับเฉพาะอุปกรณ์ที่ใช้ Android API ระดับ 26 ขึ้นไป

แอปเวอร์ชันที่สร้างด้วย SDK การนำทางและ 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) ให้แก่ลูกค้าที่ได้รับผลกระทบ ด้วย

เราจะแยก Navigation SDK สำหรับ Android และ Driver SDK สำหรับ Android ออกเป็นไบนารี 2 รายการที่แตกต่างกันเพื่อลดความซับซ้อนในการผสานรวมของลูกค้าและเพิ่มความสามารถในการให้บริการฟีเจอร์ที่มีประโยชน์

  • Navigation SDK สำหรับ Android ซึ่งจะมอบฟังก์ชันการนำทาง/การกำหนดเส้นทาง สำหรับคนขับ
  • Driver SDK สำหรับ Android ซึ่งจะช่วยให้คุณใช้ประโยชน์จากบริการเว็บแบบมีสถานะของ Fleet Engine สำหรับความคืบหน้าและการจัดสรรการเดินทางหรืองานได้

โปรดทราบว่า Driver SDK สำหรับ Android มีการอ้างอิงที่จำเป็นใน Navigation SDK สำหรับ Android สำหรับฟังก์ชันการกำหนดเส้นทางหลัก

สิ่งที่จะเปลี่ยนแปลงไป

การเปลี่ยนแปลงที่สำคัญใน v3 มีดังนี้

  • ไบนารี 2 รายการแทนที่จะเป็น 1 รายการ
  • คำจำกัดความของแพ็กเกจที่ชัดเจนยิ่งขึ้นสำหรับคลาส Driver SDK สำหรับ Android
  • Navigation SDK สำหรับ Android มี Maps SDK สำหรับ Android เป็น ส่วนหนึ่งของแพ็กเกจ (ตั้งแต่ Navigation SDK สำหรับ Android v2)
    • ซึ่งจะช่วยให้ฟีเจอร์แผนที่และการนำทางอยู่ร่วมกันในแผนที่เดียวกันได้ (เช่น การวาดเส้นหลายเส้นใน NavigationView) และลดการใช้หน่วยความจำเนื่องจากใช้ แผนที่เดียวแทน 2 แผนที่
    • Navigation SDK สำหรับ Android 3.0 ยังไม่มีฟีเจอร์ที่เทียบเท่ากับ Navigation SDK สำหรับ Android แต่ v3.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 สำหรับ 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 ที่คุณต้องการอัปเกรด อธิบายไว้ในตารางต่อไปนี้พร้อมกับเวลาที่พร้อมใช้งาน

คุณใช้ฟีเจอร์ใดของแพลตฟอร์มไดรเวอร์ คุณใช้ความสามารถเหล่านี้ไหม จากนั้นเวอร์ชันแรกที่พร้อมใช้งานซึ่งคุณควรอัปเกรดเป็นคือ... คาดว่าจะพร้อมให้บริการ
(อาจมีการเปลี่ยนแปลง)		 ลิงก์การย้ายข้อมูล
การนำทางเท่านั้น
(เมธอด NavSDK)		 ไม่ NavSDK v3.0.1 ตอนนี้ คู่มือ
ใช่ NavSDK v3.5 (ประมาณการ) ก.ย. 2021
การนำทางและการติดตาม Fleet Engine (วิธีการ NavSDK และ DriverSDK) ไม่ Nav SDK v3.0 และ Driver SDK v3.0 คำแนะนำในการย้ายข้อมูลไดรเวอร์เวอร์ชัน 3.0 พร้อมให้บริการเมื่อเปิดตัว
ใช่ NavSDK v3.x และ DriverSDK v3.0

หากต้องการใช้วิธีการที่นำออกไปแล้วต่อไป คุณอาจใช้ v1.x ต่อไปได้ แต่จะไม่มีการสนับสนุนหรือบำรุงรักษาหลังจากวันที่ 21 มิถุนายน 2022 (ดูส่วนถัดไป)

เราขอแนะนำให้ย้ายข้อมูลไปยังเวอร์ชัน 3.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, ยกเลิกการลงทะเบียนเครื่องมือฟังการนำทางทั้งหมด และหยุด 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() เว้นแต่ ช่วงเวลาจะเปลี่ยนแปลง
  • อัปเดต Javadoc สำหรับเมธอด setReportingInterval() โดยมีวัตถุประสงค์ เพื่อไม่ให้มีการเรียกใช้เมธอดนี้ซ้ำๆ ในอัตราสูงเมื่อเทียบกับ ช่วงเวลาที่ใช้
  • ปรับปรุงความน่าเชื่อถือของตำแหน่งใน API 29

v1.13.0

ความเสถียรและการแก้ไขข้อบกพร่อง

  • เพิ่มการขึ้นต่อกันใน okhttp ที่ไคลเอ็นต์จะต้องเพิ่มลงใน gradle builds

v1.11.7 (18 ตุลาคม 2019)

ความเสถียรและการแก้ไขข้อบกพร่อง

  • ตอนนี้การอัปเดตตำแหน่งจะดำเนินต่อไปหลังจากที่ onArrival() ทริกเกอร์สำหรับ ปลายทางที่ระบุ
  • การแจ้งเตือนเริ่มต้น (สตริงคงที่ในโหมดการนำทางฟรี) จะตรงกับ รูปแบบสีที่ตั้งไว้สำหรับการแจ้งเตือนการนำทาง ดูข้อมูลเพิ่มเติมได้ที่การแจ้งเตือนแบบถาวรที่แชร์
  • แก้ไขปัญหาที่เหตุการณ์การอัปเดตตำแหน่งที่ล่าช้าอาจทำให้เกิด การอัปเดตตำแหน่งที่ไม่ถูกต้อง ซึ่งทำให้เกิดอาร์ติแฟกต์ เช่น เส้นตรงที่ จุดเริ่มต้นของเส้นทาง

v1.11.6 (4 ตุลาคม 2019)

การอัปเดต API

  • เปิดตัวชุดการเปลี่ยนแปลงที่ช่วยให้มั่นใจว่า Driver SDK จะกลับมาอัปเดตตำแหน่งอย่างรวดเร็วหลังจากเครือข่ายล้มเหลว เมื่อการเชื่อมต่อเครือข่ายกลับมาใช้ได้แล้ว การอัปเดตตำแหน่งจะเริ่มอีกครั้งในการอัปเดตตำแหน่งที่กำหนดเวลาไว้ครั้งถัดไป

ความเสถียรและการแก้ไขข้อบกพร่อง

  • setVehicleState() จะแสดงผลทันที ตอนนี้การอัปเดต FleetEngine จะเกิดขึ้นในเธรดเบื้องหลัง แก้ไขปัญหาแอปพลิเคชันไม่ตอบสนอง (ANR)
  • แก้ไขปัญหาที่ทำให้เส้นทางการแชร์การเดินทางแสดงเป็น เส้นตรงเมื่อใช้ SDK สำหรับผู้บริโภคเวอร์ชันเก่า ตรวจสอบว่า Driver SDK ไม่ได้เพิ่มจุดแวะพักแบบครั้งเดียวลงในเส้นทาง