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 dành cho người dùng trên iOS.

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

Đã thay đổi

  • Hỗ trợ SDK Geo cho iOS phiên bản 9.0.
  • Hỗ trợ cho iOS 14 hiện đã bị tạm ngưng. 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 quyền riêng tư của Apple.
  • Bao gồm một bản sửa lỗi tiềm năng cho 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 Trình điều khiển và SDK Người dùng để có thể tạo trong cùng một ứng dụng.
  • Hỗ trợ Trình quản lý gói Swift cho SDK Trình điều khiển và SDK Người dùng.

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 phương thức GMSMapViewDelegate.

Phiên bản 3.1.0 (Tháng 9 năm 2023)

Đã thay đổi

  • CocoaPod cho SDK dành cho người tiêu dùng hiện là .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 chạy Intel và Apple Silicon.

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

Phiên bản 3.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.
  • Hỗ trợ cho iOS 13 hiện đã bị tạm ngưng. Phiên bản iOS tối thiểu hiện là 14.0.
  • Phiên bản Xcode tối thiểu được hỗ trợ mới là 14.0. Lưu ý các nội dung ngừng hoạt động trong ghi chú phát hành của 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ừ SDK dành cho người dùng 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ũ sẽ tiếp tục hỗ trợ iOS 13. Nếu các phần phụ thuộc không chỉ định số phiên bản, 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 phiên bản SDK dành cho người dùng cho iOS trong 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 được hỗ trợ tối thiểu 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 SDK dành cho người tiêu dùng dành cho iOS.

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

Nếu các phần phụ thuộc không chỉ định số phiên bản, 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 phiên bản của SDK dành cho người dùng cho iOS trong 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 được hỗ trợ tối thiểu cho các phiên bản mới của ứng dụng.

Phiên bản 2.2.0 (Tháng 2 năm 2023)

Đã thay đổi

  • Cập nhật URL cho các đ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 và 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

  • Hỗ trợ cho iOS 12 hiện đã bị ngừng. Phiên bản iOS tối thiểu hiện là 13.0.

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

  • Các trình khởi chạy 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ợ (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 iOS dành cho người tiêu dùng. 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.

Phiên bản 1.0.6 (Ngày 24 tháng 3 năm 2022)

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

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

  • SDK gọi getToken() để 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 Công cụ của đội xe, 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ó thể 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 thích 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 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 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ý nào. ModelState và ModelOptions lần lượt được đổi tên thành state và options. Xoá stop và start 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

Để đáp ứng các 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 dành cho người dùng iOS.

SDK dành cho người 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ũ sẽ tiếp tục hỗ trợ iOS 12.

Nếu các phần phụ thuộc 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 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 được hỗ trợ tối thiểu cho các phiên bản mới của ứng dụng. Hãy xem ví dụ về cách chỉ định phiên bản trong tài liệu SDK Maps cho iOS. Xem hướng dẫn về các phương pháp hay nhất để bảo trì ứng dụng.

Phiên bản 0.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 sử 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.

Cập nhật API GMTSAuthorization

  • Thêm khoá mới kGMTSAuthorizationContextKeyTaskID để 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

Phiên bản 0.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

Phiên bản 0.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

Phiên bản 0.6.7 (Ngày 23 tháng 3 năm 2020)

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

  • Đường đa giác tuyến đường không xuất hiện 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 ngoài lộ trình (yêu cầu DriverSDK 1.15):
    • Tính năng theo dõi xe không gắn xe vào 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 không đi 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 tuyến cũ khi điểm đến của người lái xe không khớp với điểm đến trong Công cụ quản lý đội xe.
  • Các câu trả lời về chuyến đi đã lỗi thời hiện đã bị xoá.

Phiên bản 0.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 lỗi phản hồi chuyến đi.

Phiên bản 0.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

  • 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 API gọi lại mapView khỏi GRCMapView.

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

  • Thêm một API gọi lại mới vào GRCMapView.

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

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

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

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

  • Ranh giới của máy ảnh sẽ bao gồm cả vị trí đón và trả khách sau khi chuyến đi được đặt và trước khi có bất kỳ vị trí xe nào được so khớ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.

Sửa lỗi

  • Ảnh động tuyến đường hiện chỉ xảy ra khi đoạn tuyến đường được đồng bộ hoá, nhờ đó mang lại trải nghiệm tốt hơn cho người dùng.

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

Phiên bản 0.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í xe độ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 sử dụng mạng khi chia sẻ hành trình.
  • Giờ đây, vị trí lấy hàng được chọn sẽ được làm nổi bật.
  • Tương thích với SDK Bản đồ phiên bản 3.1.0

Sửa lỗi

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