Ghi chú phát hành SDK dành cho người dùng iOS

Phần này chứa ghi chú phát hành cho SDK Người tiêu dùng dành cho iOS.

phiên bản 11.1.0 (tháng 9 năm 2026)

  • Tăng phiên bản cho bản phát hành 11.1.0.
  • Sửa một số lỗi nhỏ và cập nhật phần phụ thuộc nội bộ.

phiên bản 10.10.1 (tháng 5 năm 2026)

  • [Bản sửa lỗi] Khắc phục lỗi hồi quy khiến thông tin cập nhật về chuyến đi có thể không thành công nếu thiếu các trường cụ thể trong phản hồi.

Phiên bản 10.10 (tháng 3 năm 2026)

  • [Bản sửa lỗi] Chúng tôi đã thực hiện các thay đổi để giúp ConsumerSDK khôi phục nhanh hơn nếu xảy ra sự cố gián đoạn mạng trong chuyến đi.
  • SDK Người tiêu dùng được xây dựng bằng Xcode 26.

phiên bản 10.0.0 (tháng 6 năm 2025)

Đã thay đổi

  • Chúng tôi hiện đã ngừng hỗ trợ iOS 15. Phiên bản iOS tối thiểu hiện là 16.0.

Nội dung thay đổi đối với API

  • Thêm lớp GMTSVehicleLocationOptions, trong đó bạn có thể sử dụng thuộc tính serverTime để xác định thời điểm Fleet Engine nhận được thông báo cập nhật vị trí mới nhất.
  • Thêm trình khởi tạo initWithOptions<GMTSVehicleLocationOptions> vào GMTSVehicleLocation
  • Ngừng sử dụng trình khởi chạy initWithLatLng:GMTSLatLng trong GMTSVehicleLocation. Thay vào đó, hãy sử dụng trình khởi tạo initWithOptions:<GMTSVehicleLocationOptions>.

v9.2.1 (tháng 4 năm 2025)

Đã thay đổi

  • Sửa lỗi ký hiệu không xác định.

phiên bản 9.2 (tháng 1 năm 2025)

Đã thay đổi

  • Nâng cấp phiên bản từ 9.0 lên 9.2.
  • Hỗ trợ tính năng Định kiểu bản đồ dựa trên đám mây.
  • Hỗ trợ người dùng truy xuất trạng thái "Vị trí xe" trong suốt chuyến đi.
  • Khắc phục một vấn đề hiếm gặp khiến hình nhiều đường biến mất.

Phiên bản 9.0 (tháng 7 năm 2024)

Đã thay đổi

  • Hỗ trợ SDK Geo phiên bản 9.0 cho iOS.
  • Chúng tôi hiện đã ngừng hỗ trợ iOS 14. Phiên bản iOS tối thiểu hiện là 15.0.
  • Bản phát hành này bao gồm tệp .xcprivacy để hỗ trợ Tệp kê khai về quyền riêng tư của Apple.
  • Bao gồm một bản sửa lỗi tiềm năng cho một sự cố hiếm gặp liên quan đến nhật ký.

phiên bản 3.3.0 (tháng 3 năm 2024)

Đã thay đổi

  • Hỗ trợ khả năng tương thích của SDK Tài xế và SDK Người tiêu dùng để có thể tích hợp cả hai SDK này vào cùng một ứng dụng.
  • Hỗ trợ Trình quản lý gói Swift cho SDK Tài xế và SDK Người tiêu dùng.

v3.2.0 (tháng 12 năm 2023)

Đã thay đổi

  • Sửa lỗi và cập nhật tài liệu.

Không được dùng nữa

  • Ngừng sử dụng [GMTCMapView initWithCoder] trong GMTCMapView.

v3.1.1 (Tháng 10 năm 2023)

Đã thay đổi

  • Khắc phục lỗi không gọi được các phương thức GMSMapViewDelegate.

v3.1.0 (tháng 9 năm 2023)

Đã thay đổi

  • CocoaPod cho SDK Người tiêu dùng hiện là một .xcframework hỗ trợ cả bản dựng thiết bị và trình mô phỏng cho nhà phát triển trên cả máy Mac dựa trên Intel và Apple Silicon.

phiên bản 3.0.1 (tháng 8 năm 2023)

Đã thay đổi

  • Sửa lỗi ký hiệu không xác định.

v3.0.0 (Tháng 5 năm 2023)

Đã thay đổi

  • Xoá trình khởi chạy không dùng nữa trong GMTCMapView.
  • Khắc phục lỗi tiếp tục tìm nạp mã thông báo xác thực sau khi tất cả người đăng ký đã bị xoá khỏi GMTCTripModel.
  • Chúng tôi hiện đã ngừng hỗ trợ iOS 13. Phiên bản iOS tối thiểu hiện là 14.0.
  • Phiên bản Xcode tối thiểu mới được hỗ trợ là 14.0. Lưu ý về việc ngừng sử dụng trong ghi chú phát hành của Xcode 14 về việc ngừng hỗ trợ xây dựng bằng mã bit.
  • Theo chính sách hỗ trợ phiên bản hệ điều hành di động, chúng tôi sẽ ngừng hỗ trợ iOS 13 kể từ SDK Người tiêu dùng cho iOS phiên bản 3.0.0. Hệ điều hành tối thiểu mới được hỗ trợ là iOS 14. Các phiên bản SDK cũ hơn sẽ tiếp tục hỗ trợ iOS 13. Nếu các phần phụ thuộc của bạn không chỉ định số phiên bản, thì IDE sẽ tải phiên bản SDK mới nhất và các bản dựng mới của ứng dụng sẽ không hỗ trợ iOS 13. Chỉ định một phiên bản SDK Người tiêu dùng cho iOS trong các phần phụ thuộc của bản dựng ứng dụng để kiểm soát thời điểm bạn nâng cấp hệ điều hành tối thiểu được hỗ trợ cho các phiên bản mới của ứng dụng.

Thông báo

Ngừng hỗ trợ iOS 14 – Ngày 15 tháng 5 năm 2023

Theo Chính sách hỗ trợ phiên bản hệ điều hành di động, chúng tôi sẽ ngừng hỗ trợ iOS 14 trong một phiên bản lớn sắp tới của SDK Người tiêu dùng cho iOS.

Các phiên bản SDK Người tiêu dùng cho iOS được phát hành từ quý 2 năm 2024 sẽ hỗ trợ iOS 15 trở lên. Các phiên bản SDK cũ hơn sẽ tiếp tục hỗ trợ iOS 14.

Nếu các phần phụ thuộc của bạn không chỉ định số phiên bản, thì IDE sẽ tải phiên bản SDK mới nhất và các bản dựng mới của ứng dụng sẽ không hỗ trợ iOS 14.

Chỉ định một phiên bản của SDK Người tiêu dùng cho iOS trong các phần phụ thuộc bản dựng của ứng dụng để kiểm soát thời điểm bạn nâng hệ điều hành tối thiểu được hỗ trợ cho các phiên bản mới của ứng dụng.

v2.2.0 (Tháng 2 năm 2023)

Đã thay đổi

  • Cập nhật URL cho điều khoản và điều kiện trong tệp tiêu đề thành đường liên kết chính xác, đồng thời khắc phục các vấn đề nhỏ khác về dấu câu.
  • Sửa nhiều lỗi chính tả, dấu câu và các lỗi nhỏ khác trong tài liệu.

v2.1.0 (ngày 12 tháng 9 năm 2022)

Đã thay đổi

  • Sửa lỗi và cập nhật tài liệu.

v2.0.0 (ngày 18 tháng 7 năm 2022)

Đã thay đổi

  • Xoá Dịch vụ điểm cuối, bao gồm:

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • Chúng tôi hiện đã ngừng hỗ trợ iOS 12. Phiên bản iOS tối thiểu hiện là 13.0.

Không được dùng nữa

  • Không dùng các phương thức khởi tạo trong lớp công khai GMTCMapView nữa.

Thông báo

Chúng tôi sẽ ngừng hỗ trợ (ngừng sử dụng) iOS 13 trong các bản cập nhật phiên bản lớn năm 2023 cho SDK Người tiêu dùng trên iOS. Kể từ tháng 6 năm 2023, phiên bản iOS tối thiểu được hỗ trợ sẽ là iOS 14. Khách hàng nên chuẩn bị bằng cách thay đổi cờ hỗ trợ phiên bản tối thiểu trong mã của họ trước khi cập nhật.

v1.0.6 (ngày 24 tháng 3 năm 2022)

Bản sửa lỗi nội bộ.

v1.0 (ngày 7 tháng 12 năm 2021)

Phiên bản iOS tối thiểu được hỗ trợ cho bản phát hành này là 12.0.

Nội dung thay đổi đối với API

Thay đổi về phương thức xác thực

  • SDK gọi getToken() để triển khai giao diện AuthTokenFactory cho mỗi gRPC. SDK thực hiện việc này bằng cách chặn các lệnh gọi đến Fleet Engine, sau đó đính kèm JWT được trả về từ getToken() vào tiêu đề uỷ quyền HTTP. Xin lưu ý rằng bạn có trách nhiệm tạo mã thông báo hợp lệ. Tức là những mã thông báo chưa hết hạn và có thông báo xác nhận quyền sở hữu phù hợp.

  • Đã thay đổi GMTSAuthorization thành GMTCAuthorization.

  • Đã xoá GMTSServiceType.

Thay đổi đối với thông tin chuyến đi và lệnh gọi lại

  • Đã cập nhật tên cơ sở lưu trú trong chuyến đi: remainingDistanceOfActiveRouteInMeters.

  • Đã thêm tính năng cập nhật dữ liệu lưu lượng truy cập vào GMTCTripModelSubscriber.

  • Thêm thuộc tính remainingDistanceOfCurrentRouteInMeters.

  • Đã thêm các thuộc tính mới vào GMTSTripPropertyFields:

    • GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters.
    • GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute.
    • GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute.
    • GMTSTripPropertyFieldRemainingRouteTraffic.

  • Thêm các thuộc tính mới remainingDistanceOfActiveRouteInMeters và distanceOfRemainingRouteInMeters trong GMTSTrip.

  • RegisterSubscriber hiện tự động bắt đầu giám sát chuyến đi cho tripModel. UnregisterSubscriber sẽ ngừng giám sát khi không còn người đăng ký. ModelState và ModelOptions lần lượt được đổi tên thành state và options. stop và start đã bị xoá khỏi tiêu đề công khai.

    • Đổi tên modelState thành state.
    • Đổi tên modelOptions thành options.
    • Xoá start() và stop() trong TripModel.

Các thay đổi khác về API

  • Xoá GMTSTripPreview và GMTSTripPreviewVehicleOptions.

  • Đã xóa dịch vụ chọn điểm lấy hàng, bao gồm:

    • GMTSPickupPointArea.
    • GMTSPickupPointGroup.
    • GMTSPickupPointMatch.

Ngừng hỗ trợ iOS 12 – Ngày 18 tháng 10 năm 2021

Để ứng phó với những thay đổi trong các phần phụ thuộc nội bộ, chúng tôi sẽ ngừng hỗ trợ iOS 12 trong một phiên bản lớn sắp tới của SDK Người tiêu dùng cho iOS.

SDK Người tiêu dùng cho iOS phiên bản 2.0 trở lên sẽ chỉ hỗ trợ các thiết bị chạy iOS 13 trở lên. Các phiên bản SDK cũ hơn sẽ tiếp tục hỗ trợ iOS 12.

Nếu các phần phụ thuộc của bạn trong CocoaPods hoặc Carthage không chỉ định số phiên bản, thì Xcode sẽ tải phiên bản mới nhất và các bản dựng mới của ứng dụng sẽ không hỗ trợ iOS 12.

Hãy nhớ chỉ định một phiên bản trong các phần phụ thuộc của bản dựng ứng dụng để kiểm soát thời điểm bạn nâng cấp hệ điều hành tối thiểu được hỗ trợ cho các phiên bản mới của ứng dụng. Hãy xem các ví dụ về cách chỉ định một phiên bản trong tài liệu về SDK bản đồ dành cho iOS. Xem hướng dẫn về các phương pháp hay nhất để bảo trì ứng dụng.

v0.11.0 (ngày 30 tháng 9 năm 2021)

Các thay đổi

  • Thêm tính năng phát hiện sự cố trong quá trình khởi chạy SDK. Bạn cũng có thể chọn không sử dụng bằng cách dùng API setAbnormalTerminationReportingEnabled: trên GMTCServices.

Nội dung thay đổi đối với API

Đã cập nhật tiền tố tên cho tất cả các lớp:

  • GRC -> GMTC, ví dụ: GRCMapView -> GMTCMapView.
  • GRS -> GMTS, ví dụ: GRSTrip -> GMTSTrip.

Đã cập nhật GMTSAuthorization API

  • Thêm khoá kGMTSAuthorizationContextKeyTaskID mới để chỉ định mã tác vụ trong authorizationContext khi gọi fetchAuthTokenForServiceType:authorizationContext:completion:.

  • Đã cập nhật enum GMTSServiceType:

    Giá trị cũ Giá trị mới
    GMTSServiceTypeUnknown GMTSServiceTypeUnspecified
    GMTSServiceTypeTripService
    GMTSServiceTypeVehicleService GMTSServiceTypeVehicle
    GMTSServiceTypeTerminalPointService
    GMTSServiceTypeTask

v0.10.0 (ngày 3 tháng 5 năm 2021)

Các thay đổi

Ngừng hỗ trợ iOS 10.x. Phiên bản iOS tối thiểu được hỗ trợ hiện là 11.0.

Nội dung thay đổi đối với API

v0.9.0 (ngày 25 tháng 1 năm 2021)

Những điểm cải tiến

Nội dung thay đổi đối với API

v0.6.7 (ngày 23 tháng 3 năm 2020)

Những điểm cải tiến

  • Hình nhiều đường của tuyến đường không xuất hiện khi trạng thái chuyến đi là ARRIVED_AT_PICKUP.
  • Tính năng theo dõi xe đi chệch tuyến đường đã được cải thiện (yêu cầu DriverSDK 1.15):
    • Tính năng theo dõi xe không đưa xe về tuyến đường khi xe đi qua điểm đón.
    • Tính năng theo dõi xe cho phép hiển thị xe ngoài đường; ví dụ: trong bãi đỗ xe chưa được liên kết.
  • Biểu tượng xe không còn bị buộc phải đi theo một tuyến đường cũ khi điểm đến của tài xế không khớp với điểm đến trong Fleet Engine.
  • Các phản hồi về chuyến đi đã lỗi thời hiện đã bị loại bỏ.

v0.6.3 (Ngày 16 tháng 12 năm 2019)

Các thay đổi

  • Thêm nhật ký về độ trễ của yêu cầu chuyến đi.

  • Thêm nhật ký cho lỗi phản hồi chuyến đi.

v0.5.4(86.0) (ngày 7 tháng 8 năm 2019)

Tính năng mới

  • Hỗ trợ nhiều điểm đến cho tính năng Chia sẻ hành trình.

Nội dung thay đổi đối với API

  • Đã thêm trạng thái chuyến đi mới vào GRSTripStatus.

    • GRSTripStatusEnrouteToIntermediateDestination.
    • GRSTripStatusArrivedAtIntermediateDestination.

  • Đã thêm các cơ sở lưu trú mới vào GRSTrip.

    • intermediateDestinations.
    • intermediateDestinationIndex.

  • Thêm API gọi lại mới vào GRCTripServiceSubscriber.

    • - (void)tripService:(GRCTripService *)service didUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;

    • - (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;

  • Đã thêm enum loại điểm đánh dấu mới vào GRCMapViewMarkerType.

    • GRCMapViewMarkerTypeIntermediateDestination.

  • Đã thêm enum loại điểm đánh dấu mới có thể tuỳ chỉnh vào GRCCustomizableMarkerType.

    • GRCCustomizableMarkerTypeIntermediateDestination

  • Đã thêm mapViewCustomerState mới vào GRCMapViewCustomerState.

    • GRCMapViewCustomerStateJourneySharing

  • Đã xoá 4 thành viên mapViewCustomerState khỏi GRCMapViewCustomerState.

    • GRCMapViewCustomerStateWaitingForPickup
    • GRCMapViewCustomerStateArrivedAtPickup
    • GRCMapViewCustomerStateEnRoute
    • GRCMapViewCustomerStateEndOfTrip

  • Xoá 4 Callback API mapView khỏi GRCMapView.

    • -(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;
    • -(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;
    • -(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;
    • -(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;

  • Một Callback API mới đã được thêm vào GRCMapView.

    • - (void)mapViewDidStartJourneySharing:(GRCMapView *)mapView;

Những điểm cải tiến

  • Cập nhật ETA của tất cả các điểm tham chiếu còn lại khi ETA đến điểm tham chiếu đầu tiên trong danh sách thay đổi.

  • Buộc camera tự động căn giữa khi tài xế đến điểm đón.

  • Ranh giới camera sẽ bao gồm cả địa điểm đón và trả khách sau khi chuyến đi được đặt và trước khi có thông tin về vị trí của xe phù hợp.

v0.4.5(28.0) (ngày 26 tháng 6 năm 2019)

Tính năng mới

  • Hỗ trợ đi chung xe để chia sẻ hành trình.

Nội dung thay đổi đối với API

  • Trường type đã bị xoá khỏi GRSTerminalLocation.

Bản sửa lỗi

  • Ảnh động của tuyến đường hiện chỉ xuất hiện khi đoạn tuyến đường được đồng bộ hoá, nhờ đó cải thiện trải nghiệm người dùng.

  • Khắc phục vấn đề trong đó lệnh gọi đến API isMarkerStyleOptionsCustomizedForType: cho GRCCustomizableMarkerTypeSelectedDropoffPoint luôn trả về NO.

v0.4.3 (ngày 17 tháng 5 năm 2019)

Tính năng mới

  • Hỗ trợ liên tục cho tính năng Chia sẻ hành trình.
  • Tính năng chia sẻ hành trình hiện hỗ trợ tốc độ báo cáo vị trí linh động của xe.

Nội dung thay đổi đối với API

GRCMapViewMarkerType

Giá trị cũ Giá trị mới
GRCMapViewMarkerTypeSelectedPickup GRCMapViewMarkerTypeSelectedPickupPoint
GRCMapViewMarkerTypeSelectedDropoff GRCMapViewMarkerTypeSelectedDropoffPoint
GRCMapViewMarkerTypePickupCandidate GRCMapViewMarkerTypeSuggestedPickupPoint
GRCMapViewMarkerTypeHighlightedPickupPoint
GRCMapViewMarkerTypeTripPreviewPickupPoint
GRCMapViewMarkerTypeTripPreviewDropoffPoint
GRCMapViewMarkerTypeTripPickupPoint
GRCMapViewMarkerTypeTripDropoffPoint

GRCMapView

Giá trị cũ Giá trị mới
redrawRidesharingOverlays

Giao thức GRCTripServiceSubscriber

Giá trị cũ Giá trị mới
tripService:didUpdateTripRoute: tripService:didUpdateActiveRoute:
tripService:didUpdateRemainingDistance tripService:didUpdateActiveRouteRemainingDistance
tripService:didUpdateRemainingWaypoints

GRCPolylineType

Giá trị cũ Giá trị mới
GRCPolylineTypeTripRoute GRCPolylineTypeActiveRoute
GRCPolylineTypeTripPreviewAutoRoute GRCPolylineTypePreviewAutoRoute
GRCPolylineTypeTripPreviewTaxiRoute GRCPolylineTypePreviewTaxiRoute
GRCPolylineTypeTripPreviewTruckRoute GRCPolylineTypePreviewTruckRoute
GRCPolylineTypeTripPreviewTwoWheelerRoute GRCPolylineTypePreviewTwoWheelerRoute
GRCPolylineTypeRemainingRoute

GRCPolylineStyleOptions

Giá trị cũ Giá trị mới
zIndex

GRSTrip

Giá trị cũ Giá trị mới
Tài sản remainingWaypoints
Tài sản route
Tài sản remainingDistanceInMeters
GRSTripWaypoint

Những điểm cải tiến

  • Giảm mức tiêu thụ mạng khi chia sẻ hành trình.
  • Ứng viên được chọn để đón hiện đã được làm nổi bật.
  • Tương thích với SDK Maps phiên bản 3.1.0

Bản sửa lỗi

  • Khắc phục vấn đề điểm đánh dấu không phản hồi khi nhấn lần thứ hai.
  • Khắc phục vấn đề ranh giới camera của mapView đôi khi cho thấy một khung nhìn không mong muốn vào thời điểm bắt đầu, sau khi một chuyến đi được đặt trước.
  • Khắc phục vấn đề với API phiên bản SDK.