บันทึกประจำรุ่น SDK สำหรับผู้บริโภคของ Android

ส่วนนี้ประกอบด้วยบันทึกประจำรุ่นของ Consumer SDK สำหรับ Android

ประกาศ: การหยุดรองรับ API ระดับ 23, 24 และ 25 ชั่วคราว

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

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

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

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

5.0.0 (9 พฤศจิกายน 2026)

  • เพิ่มการรองรับโหมดเต็มรูปแบบ R8 ตอนนี้กฎ ProGuard ของ SDK จะเก็บคลาสผู้ให้บริการ gRPC ที่โหลดโดยการสะท้อนไว้ ดังนั้นแอปที่เปิดใช้โหมดเต็มรูปแบบ R8 จะไม่ล้มเหลวเมื่อเริ่มต้นระบบด้วย Unable to load OkHttpChannelProvider อีกต่อไป

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

  • แก้ไขปัญหาที่การพยายามเชื่อมต่ออย่างปลอดภัยกับ Fleet Engine อาจค้างอยู่โดยไม่มีกำหนดหากพร็อกซีของผู้ให้บริการระดับกลางหยุดทำงานระหว่างการตั้งค่าการเชื่อมต่อ ซึ่งทำให้การอัปเดตสถานะการเดินทางและการติดตามยานพาหนะไม่รีเฟรชในเครือข่ายมือถือบางเครือข่าย ตอนนี้ Consumer SDK จะบังคับใช้การหมดเวลาการเชื่อมต่อและกู้คืนโดยอัตโนมัติเมื่อมีการเชื่อมต่อใหม่

การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า

ตั้งแต่ Consumer SDK สำหรับ Android เวอร์ชัน 5.0.0 เป็นต้นไป จะมีข้อกำหนดขั้นต่ำใหม่ดังนี้

  • เวอร์ชัน Android ขั้นต่ำที่รองรับคือ Android 7.0 (API ระดับ 24)
  • แอปต้องอัปเกรดเป็น Kotlin 2.4

ตอนนี้ SDK สร้างขึ้นด้วยเครื่องมือต่อไปนี้

  • อัปเกรดปลั๊กอิน Android Gradle เป็น 9.2.0
  • อัปเกรด Gradle เป็น 9.4.1

4.1.0 (26 พฤษภาคม 2026)

  • การปรับปรุงภายใน: ย้ายข้อมูลพื้นที่เก็บข้อมูลภายในไปยัง Jetpack DataStore

การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า

  • อัปเกรดเวอร์ชันทรัพยากร Dependency ของ Kotlin เป็น v2.3.0
  • อัปเกรดปลั๊กอิน Android Gradle เป็น 8.13.2 แล้ว
  • อัปเกรด Gradle เป็น 8.13
  • อัปเกรดไลบรารี Desugar เป็น 2.1.5
  • อัปเกรด Maps SDK เป็น 20.0.0 และอัปเดตทรัพยากร Dependency ของ GMS Core ต่อไปนี้
    • play-services-location: 21.3.0
    • play-services-tasks: 18.4.1
    • play-services-common: 18.1.0
    • play-services-basement: 18.1.0
  • เพิ่มทรัพยากร Dependency ของ Jetpack Datastore (androidx.datastore:datastore-core:1.2.0, androidx.datastore:datastore-guava:1.2.0)

4.0.0 (3 ตุลาคม 2025)

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

3.2.0 (26 มิถุนายน 2025)

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

การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า

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

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

  • ใช้ความยาวของเส้นประกอบแทนระยะทางในอากาศสำหรับการตัดสินใจเกี่ยวกับภาพเคลื่อนไหวภายใน

3.1.0 (10 มีนาคม 2025)

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

3.0.0 (6 ธันวาคม 2024)

การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า

2.99.0 (25 พฤศจิกายน 2024)

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

  • แก้ไขข้อผิดพลาด ANR ที่เกิดขึ้นเมื่อ ConsumerApi.cleanUp() ใช้เวลานานเกินไปในการดำเนินการ เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว
  • แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC พร้อมรหัส "INTERNAL" และข้อความ "Panic! นี่คือข้อบกพร่อง" เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว

2.3.0 (2 สิงหาคม 2024)

การเปลี่ยนแปลง API

2.2.0 (7 พฤษภาคม 2024)

การเปลี่ยนแปลง API

  • เพิ่ม API การสนับสนุนสำหรับการผสานรวม Jetpack Compose ฟีเจอร์นี้เป็นฟีเจอร์ทดลอง โปรดติดต่อตัวแทนเพื่อสอบถามรายละเอียดเกี่ยวกับการผสานรวมกับ Jetpack Compose

2.1.0 (17 มกราคม 2024)

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

  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อมีการเริ่มต้น SDK มากกว่า 1 ครั้งตลอดวงจรการใช้งานแอปพลิเคชัน

การเปลี่ยนแปลง API

  • เปิดตัวเมธอดเพื่อดึงข้อมูลอินสแตนซ์ GoogleMap ที่สร้างโดย SDK (ConsumerGoogleMap.getGoogleMap())
  • เปิดตัว API เพื่อดึงข้อมูลอินสแตนซ์ Marker ที่ SDK สร้างขึ้นเพื่อแสดงถึงยานพาหนะ (ConsumerController.getConsumerMarker())
  • เปิดตัว API เพื่อรับข้อมูลอัปเดตที่คาดการณ์ไว้ของไคลเอ็นต์เกี่ยวกับเวลาและระยะทางระหว่างการแชร์เส้นทาง (ProjectedRouteEta)

1.99.2 (3 พฤศจิกายน 2023)

  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อ SDK เริ่มต้นจากกระบวนการระยะไกลซึ่งแยกจากแอปพลิเคชัน

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

  • แก้ไขข้อบกพร่องที่ทำให้การเดินทางช่วงแรกของการเดินทางแบบต่อเนื่องถูกตัดออกเมื่อการเดินทางช่วงที่ 2 ผ่านถนนเส้นเดียวกัน

ปัญหา

  • ConsumerApi.initialize() จะแสดงข้อยกเว้นหากมีการเรียกใช้เมื่อมีอินสแตนซ์ API อยู่แล้ว วิธีแก้ปัญหานี้คือให้เรียกใช้ ConsumerApi.getInstance() ก่อน แล้วประเมิน Task ที่แสดงผลเพื่อดูว่ามีอินสแตนซ์ API อยู่แล้วหรือไม่

2.0.0 (15 กันยายน 2023)

ประกาศ: การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

  • ข้อกำหนดระดับ API ขั้นต่ำได้รับการอัปเดตจาก 21 เป็น 23

  • อัปเดตข้อกำหนดเวอร์ชัน Maps SDK จาก v17.0.0 เป็น v18.1.0

  • ข้อกำหนดเวอร์ชันไลบรารีมาตรฐาน Kotlin ขั้นต่ำได้รับการอัปเดตจาก v1.6.10 เป็น v1.9.0

  • อัปเดตเวอร์ชันทรัพยากร Dependency ของบริการ Google Play

    • ข้อกำหนดเวอร์ชันไลบรารี play-services-base ขั้นต่ำได้รับการอัปเดตจาก v18.0.1 เป็น v18.2.0

    • ข้อกำหนดเวอร์ชันขั้นต่ำของไลบรารี play-services-basement ได้รับการอัปเดตจาก v18.0.0 เป็น v18.2.0

    • ข้อกำหนดเวอร์ชันไลบรารี play-services-location ขั้นต่ำได้รับการอัปเดตจาก v17.0.0 เป็น v21.0.1

    • ข้อกำหนดเวอร์ชันขั้นต่ำของไลบรารี play-services-tasks ได้รับการอัปเดตจาก v18.0.1 เป็น v18.0.2

  • เพิ่มไลบรารี androidx.room:room-runtime โดยตั้งค่าข้อกำหนดเวอร์ชันขั้นต่ำเป็น v2.5.2

  • อัปเดตเวอร์ชันทรัพยากร Dependency ต่อไปนี้

    • ข้อกำหนดเวอร์ชันไลบรารี android-maps-utils ขั้นต่ำได้รับการอัปเดตจาก v0.4.2 เป็น v3.5.2

    • ข้อกำหนดเวอร์ชันขั้นต่ำของ com.google.android.datatransport:transport-backend-cct ได้รับการอัปเดตจาก v3.0.0 เป็น v3.1.9

    • ข้อกำหนดเวอร์ชันขั้นต่ำของ com.google.android.datatransport:transport-runtime ได้รับการอัปเดตจาก v3.0.1 เป็น v3.1.9

    • ข้อกำหนดเวอร์ชัน androidx.lifecycle:lifecycle-extensions ขั้นต่ำได้รับการอัปเดตจาก v2.0.0 เป็น v2.2.0

    • ข้อกำหนดเวอร์ชันขั้นต่ำของ androidx.lifecycle:lifecycle-common-java8 ได้รับการอัปเดตจาก v2.0.0 เป็น v2.6.1

    • ข้อกำหนดเวอร์ชัน androidx.appcompat:appcompat ขั้นต่ำได้รับการอัปเดตจาก v1.0.0 เป็น v1.6.1

    • ข้อกำหนดเวอร์ชัน androidx.fragment:fragment ขั้นต่ำได้รับการอัปเดตจาก v1.0.0 เป็น v1.6.1

  • นำ API ที่เลิกใช้งานก่อนหน้านี้ออก ได้แก่ ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions โดยแทนที่ด้วย TripModel, TripModelCallback, TripModelManager และ TripModelOptions

  • ตอนนี้แอปที่ใช้ Consumer SDK ต้องมี targetSdkVersion ของ API 31 ขึ้นไป และ compileSdkVersion ของ API 33 ขึ้นไป

  • ตอนนี้แอปที่ใช้ Consumer SDK ต้องเปิดใช้การรองรับไลบรารี Java 8 ดูวิธีการอัปเดตได้ที่ https://developer.android.com/studio/write/java8-support

  • แอปที่ใช้ Proguard หรือ Dexguard ต้องย้ายข้อมูลไปยัง R8 ดูข้อมูลเพิ่มเติมได้ที่ https://developer.android.com/build/shrink-code

  • แอปที่ใช้ Consumer SDK ต้องเปิดใช้กระบวนการ Desugaring ดูวิธีการได้ที่ https://developer.android.com/studio/write/java8-support#library-desugaring

  • ตอนนี้เมธอด ConsumerApi.initialize() จะแสดงข้อยกเว้นหากมีการเรียกใช้เมื่อมีอินสแตนซ์ API ที่สร้างไว้แล้ว ต้องใช้ Task ที่ ConsumerApi.getInstance() แสดงผลเพื่อระบุว่ามีอินสแตนซ์ API ที่สร้างไว้ก่อนหน้านี้หรือไม่

ประกาศ: การเลิกใช้งาน API

  • เลิกใช้งานคลาสคำอธิบายประกอบ Trip.TripStatus และ Trip.TripType แล้วเพิ่มคลาสคำอธิบายประกอบ TripInfo.TripStatus และ TripInfo.TripType เพื่อแทนที่

    • ในการเปลี่ยนแปลงนี้ เราจะเลิกใช้งาน TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status) และเพิ่ม TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status) เข้ามาแทน

    • การเปลี่ยนแปลงนี้รวมถึงการเลิกใช้งาน TripInfo#getTripStatus() และเพิ่ม TripInfo#getCurrentTripStatus() เข้ามาแทน

    • การเปลี่ยนแปลงนี้รวมถึงการเลิกใช้งาน TripInfo#getTripType() และเพิ่ม TripInfo#getCurrentTripType() เข้ามาแทน

  • เลิกใช้งานคลาส Trip

การเปลี่ยนแปลงอื่นๆ และการแก้ไขข้อบกพร่อง

  • รองรับการขอใช้โปรแกรมแสดงผล Maps SDK เวอร์ชันล่าสุด ดูรายละเอียดได้ที่โปรแกรมแสดงผลแผนที่ใหม่

  • รองรับช่วง Maps SDK ตั้งแต่เวอร์ชัน v18.1.0 (รวม) ถึง v19.0.0 (ไม่รวม)

  • แก้ไขข้อผิดพลาด "เกินกำหนดเวลา" สำหรับการสื่อสารภายในระหว่าง SDK กับแบ็กเอนด์ของ Google

  • แก้ไขปัญหาการแสดงผลสำหรับหน้าจอขนาดเล็กและโหมดการแสดงภาพซ้อนภาพ

คำแนะนำในการย้ายข้อมูล

1.99.1 (31 สิงหาคม 2023)

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

  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อกิจกรรมหรือส่วนย่อยของโฮสต์ SDK ถูกทำลาย

  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อขนาดของ MapView เป็น 0 (ความสูงหรือความกว้าง)

  • แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อฉายภาพตำแหน่งของยานพาหนะบนเส้นประกอบของเส้นทาง

การปรับปรุง

  • ป้องกันไม่ให้ SDK ขัดข้องเมื่อมีการไซด์โหลดแอปพลิเคชันแบบโฮสต์ และไม่มีทรัพยากรภาพเริ่มต้น

1.99.0 (22 มิถุนายน 2023)

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

  • แก้ไขปัญหาการแสดงผลสำหรับหน้าจอขนาดเล็กและโหมดการแสดงภาพซ้อนภาพ

  • แก้ไขปัญหายานพาหนะกะพริบระหว่างการแชร์เส้นทาง

1.2.1 (7 มิถุนายน 2023)

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

  • แก้ไขข้อบกพร่องที่ทำให้ยานพาหนะกะพริบระหว่างการแชร์เส้นทาง

1.2.0 (21 พฤศจิกายน 2022)

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

  • แก้ไขข้อบกพร่องที่ทำให้ระบบรายงานการเข้าชมที่ว่างเปล่าใน Callback onTripActiveRouteTrafficUpdated

ฟีเจอร์ใหม่

  • ตอนนี้ "เส้นประกอบที่คำนึงถึงการจราจร" พร้อมให้บริการในเวอร์ชันสำหรับผู้ใช้ทั่วไปแล้ว

1.1.2 (27 ตุลาคม 2022)

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

  • แก้ไขข้อบกพร่องที่ทำให้เส้นประกอบของเส้นทางหายไปหลังจากเริ่ม JourneySharingSession มากกว่า 1 ครั้งสำหรับ TripModel

ประกาศ: การหยุดให้การสนับสนุน Android 5 (25 กรกฎาคม 2022)

สำหรับ SDK เวอร์ชัน v1.1.1 เราจะให้การสนับสนุนเพิ่มเติมอีก 1 ปีสำหรับแอปที่ทำงานบน Android 5 ทั้งระดับ API 21 และ 22

การดำเนินการนี้หมายความว่าอย่างไร

  • Consumer 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 จะทำงานได้อย่างถูกต้อง

v1.1.1 (25 กรกฎาคม 2022)

การเปลี่ยนแปลงการขึ้นต่อกัน

  • ดาวน์เกรดระดับ API ขั้นต่ำของ Android ที่รองรับเป็น 21

v1.1.0 (28 เมษายน 2022)

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

v1.0.19 (17 มีนาคม 2022)

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

  • แก้ไขหน่วยความจำรั่วไหลในคลาส ConsumerApi

v1.0.14 (30 พฤศจิกายน 2021)

ตอนนี้ระดับ API ขั้นต่ำของ Android ที่รองรับคือ 23

การเปลี่ยนแปลง API

  • การเปลี่ยนแปลงคลาส ConsumerTrip และ ConsumerTripManager

    • ล้างชื่อเมธอดบางชื่อเพื่อให้ความหมายชัดเจนยิ่งขึ้น และเพื่อให้สอดคล้องกับแพลตฟอร์ม iOS
  • การเปลี่ยนแปลงใน ConsumerTripCallback, ConsumerTrip และ TripInfo

    • เปลี่ยนชื่อคลาสบางชื่อเพื่อให้สอดคล้องกับ iOS เปิดตัว TripModel, TirpModelManager และ TripModelOptions เพื่อเลิกใช้งาน ConsumerTrip, ConsumerTripManager และ ConsumerTripOptions

    • ล้างชื่อเมธอดบางชื่อ แก้ไขหรือเพิ่มความคิดเห็น JavaDoc ลงในเมธอดเพื่อสื่อความหมายที่ชัดเจนยิ่งขึ้น

    • ปรับปรุงการจัดการข้อผิดพลาด

การปรับแต่งการจัดรูปแบบ

  • Wrapper เดิมที่เลิกใช้งานแล้ว

    • MarkerStyleOptions และ PolylineStyleOptions เลิกใช้งานแล้วและแทนที่ด้วย MarkerOptions และ PolylineOptions ซึ่งทั้ง 2 รายการแชร์กับ Maps SDK

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

  • เพิ่มการตรวจจับและการบันทึกข้อขัดข้อง

    • เราได้เพิ่มตัวเลือกเพื่อให้คุณเลือกไม่ใช้ฟังก์ชันนี้ได้ ซึ่งเป็นส่วนหนึ่งของความพยายามในวงกว้างด้านภูมิศาสตร์เพื่อตรวจสอบข้อขัดข้อง

การเปลี่ยนแปลงการตรวจสอบสิทธิ์

  • นำเมธอดที่ไม่จำเป็นออกจากอินเทอร์เฟซการตรวจสอบสิทธิ์
    • นำพารามิเตอร์ ServiceType ออกแล้ว

v0.9.28 (18 พฤษภาคม 2021)

การเปลี่ยนแปลง API

  • อัปเดตเมธอด ConsumerTripCallback ทั้งหมดให้ใช้ TripInfo เป็นพารามิเตอร์
  • เพิ่ม ConsumerTrip.isRefreshing() ซึ่งระบุว่า ConsumerTrip กำลังอัปเดตตัวเองด้วยข้อมูลการเดินทางใหม่จาก Fleet Engine หรือไม่
  • เพิ่ม ConsumerTripCallback.onTripRemainingRouteDistanceUpdated() แล้ว
  • เพิ่ม ConsumerTripCallback.onTripRemainingRouteUpdated() แล้ว
  • แทนที่ประเภทการแสดงผล Guava (ImmutableSet, ImmutableList) ด้วยคลาสที่เทียบเท่า java.util
  • การเปลี่ยนแปลงชื่อแพ็กเกจ:

    • com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
    • com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory
    • com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip

                                  ->
                                                                  com.google.android.libraries.ridesharing.consumer.model.Trip
      
                                  -   com.google.android.libraries.ridesharing.common.model.Vehicle
      
                                                          ->
                                      com.google.android.libraries.ridesharing.consumer.model.Vehicle
      

การเปลี่ยนแปลงการติดตั้งใช้งาน

  • แก้ไขภาวะแข่งขันที่ SDK อาจขัดข้องจากการโต้ตอบกับแผนที่ก่อนที่จะพร้อมใช้งาน
  • SDK ไม่มีสำเนา io.grpc ที่ไม่ได้ผ่านการสร้างความสับสนอีกต่อไป
  • แก้ไขข้อบกพร่องเกี่ยวกับเส้นประกอบการจราจรที่กะพริบในอุปกรณ์บางรุ่น ตอนนี้กลุ่มการจราจรจะมีปลายโค้งมน

v0.9.15 (7 ตุลาคม 2020)

การเปลี่ยนแปลง API

  • รุ่นนี้เปิดตัวเส้นประกอบที่รับรู้การจราจร - เพิ่ม TripInfo.getActiveRouteTraffic() และ TripInfo.getRemainingRouteTraffic() แล้ว
    • เพิ่ม ConsumerTripCallback.onTripActiveRouteTrafficUpdated() และ ConsumerTripCallback.onTripRemainingRouteTrafficUpdated() เพื่อระบุเมื่อการเข้าชมมีการเปลี่ยนแปลง
    • เพิ่ม PolylineStyleOptions สำหรับการปรับแต่งการเข้าชม (setTrafficEnabled(), setTrafficColorNoData(), setTrafficColorNormal(), setTrafficColorSlow(), setTrafficColorTrafficJam())
    • เปิดเผย PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION
    • เพิ่ม TripWaypoint.getTrafficData() แล้ว
    • เพิ่มประเภทข้อมูล TrafficData แล้ว
    • เพิ่ม ConsumerController.hideAllSessions() แล้ว ConsumerController.showSession() ไม่ยอมรับค่า Null เป็นอาร์กิวเมนต์อีกต่อไป

v0.9.9 (15 กรกฎาคม 2020)

การเปลี่ยนแปลง API

  • การเปลี่ยนแปลงครั้งสำคัญนี้เป็นการนำสถาปัตยกรรมแบบโมดูลมาใช้ โดยมีความสัมพันธ์ที่ชัดเจนยิ่งขึ้นระหว่างเลเยอร์ข้อมูลเท่านั้น (เช่น ConsumerTripManager) และเลเยอร์อินเทอร์เฟซผู้ใช้ (เช่น JourneySharingSession) ดูข้อมูลเกี่ยวกับการย้ายข้อมูลไปยังสถาปัตยกรรมใหม่ได้ที่คำแนะนำในการย้ายข้อมูลแบบโมดูล - ตอนนี้ออบเจ็กต์ ConsumerTrip ได้มาจาก ConsumerTripManager.getTrip() แล้ว
    • ConsumerTrip.unregisterCallback เปลี่ยนชื่อเป็น ConsumerTrip.unregisterTripCallback แล้ว
    • ConsumerTrip.isCallbackRegistered เปลี่ยนชื่อเป็น ConsumerTrip.isTripCallbackRegistered แล้ว
    • เพิ่ม ConsumerTrip.setConsumerTripOptions() และ ConsumerTrip.getConsumerTripOptions() แล้ว
    • นำ ConsumerTrip.setAutoRefreshInterval() ออกแล้ว
  • นำ API การแชร์ที่ไม่ใช่การเดินทางออก
    • นำแผนที่ความหนาแน่นของยานพาหนะออกแล้ว
    • นำสถานะตัวอย่างการเดินทางออกแล้ว
    • นำสถานะการเลือกการรับสินค้าออกแล้ว
    • นำสถานะการเลือกจุดส่งออกแล้ว
    • นำประเภทเครื่องหมายต่อไปนี้ออก: SELECTED_PICKUP_POINT, SUGGESTED_PICKUP_POINT, HIGHLIGHTED_PICKUP_POINT และ SELECTED_DROPOFF_POINT
  • เปลี่ยน OnConsumerMarkerClickCallback และ ConsumerMapReadyCallback จากอินเทอร์เฟซเป็นคลาสนามธรรม
  • เพิ่ม ConsumerController.getCameraUpdate(), ConsumerController.isAutoCameraEnabled() และ ConsumerController.enableAutoCamera() แล้ว
  • นำ FAB ที่กำหนดเองและเมธอดที่เกี่ยวข้องออก (ConsumerController.isMyLocationFabEnabled และ ConsumerController.setMyLocationFabEnabled)

การเปลี่ยนแปลงการติดตั้งใช้งาน

  • ConsumerTripCallback ไม่ว่าจะลงทะเบียนโดยมีหรือไม่มี LifecycleOwner จะไม่ยกเลิกการลงทะเบียนโดยอัตโนมัติใน TripStatus.COMPLETE หรือ TripStatus.CANCELED อีกต่อไป
  • ตอนนี้ระบบจะเปิดใช้ AutoCamera โดยค่าเริ่มต้น และจะไม่เปิดใช้หรือปิดใช้ตัวเองอีกครั้ง ก่อนหน้านี้ กล้องอัตโนมัติจะเปิดใช้ใหม่โดยอัตโนมัติใน TripStatus.ARRIVED_AT_PICKUP และปิดใช้เองเมื่อผู้ใช้โต้ตอบกับแผนที่ระหว่างการแชร์เส้นทาง
  • เราได้ปรับปรุงภาพเคลื่อนไหวของยานพาหนะในการแชร์เส้นทางดังนี้
    • ตอนนี้ภาพเคลื่อนไหวการแชร์เส้นทางจะจัดการสถานการณ์ที่ยานพาหนะอาจเดินทางกลับตามเส้นทางที่เดินทางไปแล้วอย่างถูกต้องตามกฎหมาย
    • ตอนนี้ยานพาหนะจะเคลื่อนไหวเป็นเส้นตรงแทนที่จะประมาณเส้นทางระหว่างจุดต่างๆ เมื่ออัลกอริทึมพิจารณาว่าเหมาะสม
  • ไม่จำเป็นต้องใช้สิทธิ์ FINE_LOCATION อีกต่อไป

การเปลี่ยนแปลงอื่นๆ

  • อัปเดตเวอร์ชันทรัพยากร Dependency ต่อไปนี้
    • com.google.android.datatransport:transport-api:2.2.0
    • com.google.android.datatransport:transport-backend-cct:2.2.0
    • com.google.android.datatransport:transport-runtime:2.2.0

v0.9.1 (23 มีนาคม 2020)

การเปลี่ยนแปลง API

  • เพิ่ม TripInfo.getVehicleId(), TripInfo.getNumberOfPassengers(), TripInfo.getIntermediateDestinationIndex(), TripInfo.getTripActiveRoute() และ TripInfo.getTripRemainingRoute() แล้ว
  • เพิ่มคลาส options ที่ใช้ระหว่างการเริ่มต้น ConsumerApi ซึ่งช่วยให้ตั้งค่าที่อยู่ FleetEngine แบบไดนามิกได้ หากไม่ได้เรียกใช้ API ด้วยค่า FleetEngine ระบบจะพยายามดึงค่าจากไฟล์ Manifest ของ Android หรือกลับไปใช้ค่าเริ่มต้น

การปรับปรุง

  • ระบบจะไม่แสดงเส้นประกอบของเส้นทางเมื่อสถานะการเดินทางเป็น ARRIVED_AT_PICKUP
  • ปรับปรุงการติดตามยานพาหนะนอกเส้นทาง (ต้องใช้ DriverSDK 1.15) ดังนี้
    • การติดตามยานพาหนะจะไม่ล็อกยานพาหนะไว้กับเส้นทางเมื่อยานพาหนะขับผ่านจุดรับ
    • การติดตามยานพาหนะช่วยให้แสดงยานพาหนะนอกถนนได้ เช่น ในลานจอดรถที่ไม่ได้ระบุไว้ในแผนที่
  • ตอนนี้ไอคอนยานพาหนะจะอัปเดตเมื่อจุดหมายของคนขับไม่ตรงกับจุดหมายใน Fleet Engine

v0.8.6 (16 ธันวาคม 2019)

การเปลี่ยนแปลง API

  • เพิ่ม TripInfo.getVehicleLocation() แล้ว

  • ConsumerMapView ไม่ใช่เวอร์ชันสุดท้ายอีกต่อไป

การเปลี่ยนแปลงการติดตั้งใช้งาน

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

การเปลี่ยนแปลงอื่นๆ

  • ต้องใช้ทรัพยากร Dependency ใหม่ ดูรายละเอียดได้ที่ไฟล์ .pom

    • com.google.android.datatransport:transport-api:2.0.0
    • com.google.android.datatransport:transport-backend-cct:2.0.2
    • com.google.android.datatransport:transport-runtime:2.0.0
  • เพิ่มบันทึกสำหรับเวลาในการตอบสนองของคำขอการเดินทาง

  • เพิ่มบันทึกสำหรับข้อผิดพลาดในการตอบกลับการเดินทาง

หมายเหตุ

  • ตั้งแต่เวอร์ชัน 0.8.1 เป็นต้นมา Consumer SDK สำหรับ Android จะจัดส่งเป็นไฟล์เก็บถาวรแบบ ZIP ที่ผ่านการ Jetify แล้ว ดูข้อมูลเกี่ยวกับวิธี De-jetify ได้ที่ Jetifier: Reverse mode

v0.8.1 (13 กันยายน 2019)

ฟีเจอร์ใหม่

  • การรองรับ ConsumerMapView

  • ตอนนี้อาร์ติแฟกต์ ODRD จะจัดส่งในที่เก็บ Maven แทนไฟล์ ZIP .aar ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเพิ่ม Consumer SDK ลงในแอป

การเปลี่ยนแปลง API

  • เพิ่ม ConsumerController.disableAutoCamera() เป็นฟังก์ชันตรงข้ามกับ centerMapForState() แล้ว

  • ตอนนี้ VehicleLocation.getUpdateTime() จะแสดงผลเป็น Long ซึ่งแสดงการประทับเวลา (เป็นมิลลิวินาที)

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

การเปลี่ยนแปลงการติดตั้งใช้งาน

  • ตอนนี้ชิ้นงานจะอยู่ตรงกลางของไอคอน ซึ่งจะช่วยลดการออฟเซ็ตของเงา

  • setState ถึง JOURNEY_SHARING onStartTripMonitoring() แทนที่จะรอสถานะการเดินทางที่ตรวจสอบ

  • แสดงข้อมูลสำหรับการอัปเดตข้อมูลการเดินทางครั้งแรกเสมอ แม้ว่าข้อมูลการเดินทางจะไม่ซิงค์กันก็ตาม

  • เพิ่ม Android Map Utils เป็นทรัพยากร Dependency ที่ระบุ

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

  • แก้ไขไวยากรณ์การส่งออก ProGuard ที่ใช้งานไม่ได้สำหรับ grpc keep

v0.7.0 (7 สิงหาคม 2019)

ฟีเจอร์ใหม่

  • การรองรับหลายปลายทางสำหรับการแชร์เส้นทาง

การเปลี่ยนแปลง API

  • วิธีการใหม่สำหรับ ConsumerTripCallback

    • onTripIntermediateDestinationsUpdated()
    • onTripETAToNextTripWaypointUpdated()
  • ConsumerController วิธีใหม่

    • getIntermediateDestinations()
    • setIntermediateDestinations(List<TerminalLocation> intermediateDestinations)
  • TripStatuses ใหม่

    • TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION
    • TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION
  • TripWaypoint รายใหม่

    • getETAMillis()
    • getDistanceMeters()
  • เพิ่มชั้นเรียน TripInfo แล้ว

    • คุณสามารถดู TripInfo สำหรับการเดินทางที่ดำเนินอยู่ได้ด้วย ConsumerTripManager.getActiveTripInfo()
  • เพิ่ม WaypointType.INTERMEDIATE_DESTINATION แล้ว

  • เพิ่ม MarkerType.TRIP_INTERMEDIATE_DESTINATION แล้ว

  • สร้าง ConsumerMapState.JOURNEY_SHARING จาก ConsumerMapStates ที่ผสานรวมแล้ว ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ENROUTE_TO_DROPOFF และ COMPLETE

    • อัปเดต StateChangeCallbacks แล้ว

    • เพิ่ม onStateJourneySharing() แล้ว

    • นำ onStateWaitingForPickup(), onStateDriverArrived(), onStateEnroute() และ onStateEndofTrip() ออกแล้ว

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

  • แก้ไขข้อบกพร่องที่ระบบไม่ตัดเส้นทางไปยังตำแหน่งของยานพาหนะเมื่อการตรวจสอบการเดินทางเริ่มต้นขึ้นระหว่างการเดินทางที่ดำเนินอยู่ (ไม่ใช่ที่ต้นทางของเส้นทาง)

  • แก้ไขข้อบกพร่องที่ระบบไม่เรียกใช้ Callback ของการเดินทางสำหรับ Listener ที่ลงทะเบียนใน TripManager หลังจากที่ TripManager ดึงข้อมูลการเดินทางแล้ว

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

การปรับปรุง

  • ป้อนข้อมูลคนขับในจุดอ้างอิงที่เหลือจุดที่ 0 (ระบบจะแสดงรายการจุดอ้างอิงที่เหลือจาก ConsumerTripCallback.onTripRemainingWaypointsUpdated และ TripInfo.getRemainingWaypoints()

  • อัปเดต ETA ของจุดอ้างอิงที่เหลือทั้งหมดเมื่อ ETA ของจุดอ้างอิงแรกในรายการเปลี่ยนแปลง

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

v0.6.1 (26 มิถุนายน 2019)

ฟีเจอร์ใหม่

  • การรองรับการแชร์เส้นทางสำหรับคาร์พูล

การเปลี่ยนแปลง API

  • ตอนนี้ ConsumerController.getConsumerMapStyle() จะแสดงผลเป็น ConsumerMapStyle แทน Task<ConsumerMapStyle>

  • เพิ่ม PolylineStyle.setZIndex() แล้ว

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

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

  • แก้ไข "การกะพริบ" ของยานพาหนะระหว่างการประมาณค่าในช่วงภาพเคลื่อนไหวเมื่อการอัปเดตตำแหน่งคนขับอยู่ใกล้กัน

  • แก้ไขข้อบกพร่องที่ยานพาหนะเริ่มที่ต้นเส้นทางแทนที่จะเป็นตำแหน่งที่อัปเดตล่าสุดเมื่อการตรวจสอบการเดินทางเริ่มขึ้นระหว่างการเดินทางที่ดำเนินอยู่

  • แสดงเส้นประกอบของเส้นทางที่ใช้งานอยู่เหนือเส้นทางที่เหลือเมื่อทับซ้อนกัน

การปรับปรุง

  • ตอนนี้ให้แสดงคลาส gRPC Status ด้วยเมธอดที่ไม่ได้ผ่านการสร้างความสับสน

v0.5.1.01 (17 พฤษภาคม 2019)

ฟีเจอร์ใหม่

  • การรองรับการแชร์เส้นทางแบบต่อเนื่อง

การเปลี่ยนแปลง API

  • ชั้นเรียน ConsumerController ใหม่

PolylineType

ค่าเดิม ค่าใหม่
TRIP_PREVIEW_AUTO_ROUTE PREVIEW_AUTO_ROUTE
TRIP_PREVIEW_TAXI_ROUTE PREVIEW_TAXI_ROUTE
TRIP_PREVIEW_TRUCK_ROUTE PREVIEW_TRUCK_ROUTE
TRIP_PREVIEW_TWO_WHEELER_ROUTE PREVIEW_TWO_WHEELER_ROUTE
TRIP_ROUTE ACTIVE_ROUTE
REMAINING_ROUTE

ConsumerTripCallback

ค่าเดิม ค่าใหม่
onTripRouteUpdated onTripActiveRouteUpdated
onTripRemainingDistanceUpdated onTripActiveRouteRemainingDistanceUpdated
onTripRemainingWaypointsUpdated()

ConsumerController

  • ตอนนี้คุณตั้งค่า Callback สำหรับสถานะต่างๆ ได้โดยไม่ต้องเข้าสู่สถานะ
วิธีการ การติดต่อกลับ
startPickupSelection setPickupSelectionCallback
startDropoffSelection setDropoffSelectionCallback
startTripPreview setTripPreviewSelectionCallback
  • ConsumerController.setLanguage(String languageCode) ช่วยให้คุณตั้งค่าภาษาที่ใช้ในการเรียก FleetEngine ได้ (เช่น สำหรับคำอธิบายจุดรับ)

การปรับปรุง

  • ตอนนี้สถานะการเลือกจุดส่งมีหมุดที่ลากได้แล้ว
  • นำภาพเคลื่อนไหวของกล้องในสถานะ INITIALIZE ออกแล้ว
  • แทนที่ ManagedChannelBuilder ด้วย AndroidChannelBuilder แล้ว