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

Phần này chứa các ghi chú phát hành cho Consumer SDK cho iOS.

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. Hiện tại, phiên bản iOS tối thiểu là 16.0.

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

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

Phiên bản 9.2.1 (Tháng 4 năm 2025)

Đã thay đổi

  • Khắc phục lỗi biểu tượng không xác định.

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

Đã thay đổi

  • Tăng 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í của xe" trong chuyến đi.
  • Khắc phục một vấn đề hiếm gặp khiến đường nhiều đoạn biến mất.

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

Đã thay đổi

  • Hỗ trợ Geo iOS SDK phiên bản 9.0.
  • Chúng tôi hiện đã ngừng hỗ trợ iOS 14. Phiên bản iOS tối thiểu hiện nay là 15.0.
  • Bản phát hành này bao gồm tệp .xcprivacy để hỗ trợ Apple Privacy Manifests.
  • Bao gồm một bản sửa lỗi tiềm ẩn 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 Driver SDK và Consumer SDK để có thể tạo các SDK này trong cùng một ứng dụng.
  • Hỗ trợ Trình quản lý gói Swift cho Driver SDK và Consumer SDK.

phiên bản 3.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.

phiên bản 3.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

  • CocaaPod for Consumer SDK hiện là .xcframework hỗ trợ cả bản dựng thiết bị và trình mô phỏng cho các nhà phát triển trên cả máy Mac chạy Intel và Apple Silicon.

v3.0.1 (Tháng 8 năm 2023)

Đã thay đổi

  • Khắc phục lỗi biểu tượng không xác định.

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

Đã thay đổi

  • Xóa trình khởi tạo không còn được sử dụng trong GMTCMapView.
  • Khắc phục lỗi tiếp tục tìm nạp mã thông báo uỷ quyền sau khi tất cả người dùng đă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 nay là 14.0.
  • Phiên bản tối thiểu mới được hỗ trợ của Xcode là 14.0. Lưu ý các thông báo không dùng nữa trong ghi chú phát hành Xcode 14 về việc ngừng hỗ trợ việc tạo 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ừ Consumer SDK 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 Consumer SDK 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 tă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.

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 chính sắp tới của Consumer SDK cho iOS.

Các phiên bản Consumer SDK cho iOS được phát hành từ quý 2 năm 2024 sẽ hỗ trợ tối thiểu iOS 15. 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 Consumer SDK 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 tă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 các 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.

phiên bản 2.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.

phiên bản 2.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. Hiện tại, phiên bản iOS tối thiểu là 13.0.

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

  • Các trình khởi tạo không dùng nữa trong lớp công khai GMTCMapView.

Thông báo

Chúng tôi sẽ ngừng hỗ trợ (không dùng nữa) iOS 13 trong các bản cập nhật phiên bản chính năm 2023 cho Consumer iOS SDK. 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)

Các bản sửa lỗi nội bộ.

phiên bản 1.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

Các thay đổi về quy trình xác thực

  • SDK gọi getToken() cho quá trình triển khai giao diện AuthTokenFactory cho từng 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 phải tự 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ó các xác nhận quyền sở hữu phù hợp.

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

  • Đã xoá GMTSServiceType.

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

  • Đã cập nhật tên thuộc tính 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 theo dõi chuyến đi cho tripModel. UnregisterSubscriber sẽ ngừng theo dõi khi không còn người đăng ký nào nữa. 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.

  • Xoá dịch vụ chọn điểm đến 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 chính sắp tới của Consumer SDK cho iOS.

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

Nếu các phụ thuộc của bạn trong CocoaPods hoặc Carthage không chỉ định số phiên bản, 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 bản dựng của ứng dụng để kiểm soát thời điểm bạn tă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. Hãy xem ví dụ về cách chỉ định một phiên bản trong tài liệu Maps SDK cho iOS. Hãy xem hướng dẫn về các phương pháp hay nhất để duy 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

Tiền tố tên được cập nhật cho tất cả các lớp:

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

API GMTSAuthorization đã được cập nhật

  • Đã thêm khóa mới kGMTSAuthorizationContextKeyTaskID để chỉ định ID 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

Không còn hỗ trợ cho iOS 10.x. Hiện tại, phiên bản iOS tối thiểu được hỗ trợ 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

  • Đường đa tuyến không được hiển thị khi trạng thái chuyến đi là ARRIVED_AT_PICKUP.
  • Đã cải thiện tính năng theo dõi xe đi sai lộ trình (yêu cầu DriverSDK 1.15):
    • Tính năng theo dõi xe không điều chỉnh xe cho khớp với tuyến đường khi xe chạy qua điểm đón.
    • Tính năng theo dõi xe cho phép hiển thị xe khi xe không ở trên đường, ví dụ: trong bãi đỗ xe chưa được lập bản đồ.
  • 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 người lái xe 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 sẽ 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ý cho độ trễ của yêu cầu chuyến đi.

  • Đã thêm nhật ký cho các lỗi phản hồi về 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 thuộc tính mới vào GRSTrip.

    • intermediateDestinations.
    • intermediateDestinationIndex.

  • Thêm API lệnh 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 có thể tuỳ chỉnh mới vào GRCCustomizableMarkerType.

    • GRCCustomizableMarkerTypeIntermediateDestination

  • Một mapViewCustomerState mới đã được thêm vào GRCMapViewCustomerState.

    • GRCMapViewCustomerStateJourneySharing

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

    • GRCMapViewCustomerStateWaitingForPickup
    • GRCMapViewCustomerStateArrivedAtPickup
    • GRCMapViewCustomerStateEnRoute
    • GRCMapViewCustomerStateEndOfTrip

  • Bốn API lệnh gọi lại mapView đã bị xoá khỏi GRCMapView.

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

  • Một API lệnh gọi lại mới đã được thêm vào GRCMapView.

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

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

  • Cập nhật tất cả thời gian đến dự kiến (ETA) còn lại của điểm tham chiếu 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.

  • Giới hạn 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 bất kỳ địa điểm xe phù hợp nào khả dụng.

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

Tính năng mới

  • Hỗ trợ tính năng đi chung xe khi chia sẻ hành trình.

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

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

Sửa lỗi

  • Hoạt ảnh tuyến đường hiện chỉ xảy ra khi phân đoạn tuyến đường được đồng bộ, mang lại trải nghiệm người dùng được cải thiện.

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

v0.4.3 (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í của xe ở chế độ động.

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 hiện đã được đánh dấu.
  • Tương thích với Maps SDK v3.1.0

Sửa lỗi

  • Đã khắc phục sự cố điểm đánh dấu không phản hồi khi chạm lần thứ hai.
  • Đã khắc phục sự cố khiến giới hạn camera của mapView đôi khi hiển thị chế độ xem không mong muốn vào thời điểm bắt đầu, sau khi chuyến đi đã được đặt.
  • Khắc phục vấn đề với API Phiên bản SDK.