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

Phiên bản 3.3.0 (Tháng 3/2024)

Đã thay đổi

  • Hỗ trợ khả năng tương thích với SDK của trình điều khiển và SDK người dùng để có thể xây dựng các SDK này 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 trong đó các phương thức GMSMapViewDelegate không được gọi.

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

Đã thay đổi

  • CocoaPod dành 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.

Phiên bản 3.0.0 (Tháng 5 năm 2023)

Đã thay đổi

  • Xoá trình khởi tạo không dùng nữa trong GMTCMapView.
  • Khắc phục vấn đề liên 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.
  • Phiên bản iOS 13 hiện đã bị dừng hỗ trợ. 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. Vui lòng lưu ý việc ngừng hỗ trợ 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 băng hỗ trợ đối với iOS 13 kể từ SDK tiêu dùng cho iOS phiên bản 3.0.0. Hệ điều hành 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 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 của SDK người dùng dành 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 đưa ra 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

Hỗ trợ treo phiên bản 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 thiết bị di động, chúng tôi sẽ tạm dừng hỗ trợ iOS 14 trong phiên bản lớn sắp tới của SDK người dùng dành cho iOS.

Các phiên bản SDK người dùng dành cho iOS được phát hành từ quý 2 năm 2024 sẽ hỗ trợ phiên bản iOS 15 trở lên. 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, 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 phiên bản của SDK người dùng dành 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.

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, đồng thời sửa các vấn đề nhỏ khác liên quan đến dấu chấm câu.
  • Chúng tôi đã 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 đầu cuối, trong đó có:

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • iOS 12 hiện đã bị dừng hỗ trợ. 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 trình khởi tạo trong lớp công khai GMTCMapView.

Thông báo

Chúng tôi sẽ tạm ngưng dịch vụ hỗ trợ (không dùng nữa) đối với 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 mình trước khi cập nhật.

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

Sửa các 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ề việc 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 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ó toàn quyền tạo mã thông báo hợp lệ. Tức là 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.

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 dữ liệu giao thông cập nhật lên GMTCTripModelSubscriber.

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

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

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

  • Thêm cơ sở lưu trú mới remainingDistanceOfActiveRouteInMeters và distanceOfRemainingRouteInMeters trong GMTSTrip.

  • Giờ đây, RegisterSubscriber sẽ 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 nữa. Lần lượt đổi tên ModelState và ModelOptions 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.

Hỗ trợ treo ứng dụng cho iOS 12 – ngày 18/10/2021

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

SDK 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 trướ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, 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 bản dựng của ứ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. Xem ví dụ về cách chỉ định một phiên bản trong tài liệu SDK Maps 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.

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

Đã 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 GMTSUỷ quyền API

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

  • Đã 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

  • Hình nhiều đường không hiển thị khi trạng thái chuyến đi là ARRIVED_AT_PICKUP.
  • Tính năng theo dõi xe sai lộ trình đã được cải thiện (cần có DriverSDK 1.15):
    • Tính năng theo dõi xe không điều chỉnh xe theo 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 các bãi đỗ xe chưa có trên bản đồ.
  • Các biểu tượng xe không còn bị buộc phải ở tuyến đường cũ khi điểm đến của người lái không khớp với điểm đến trong Fleet Engine.
  • Những câu trả lời cho chuyến đi lỗi thời hiện sẽ 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 các 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 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 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 của mapViewCustomerState khỏi GRCMapViewCustomerState.

    • GRCMapViewCustomerStateWaitingForPickup
    • GRCMapViewCustomerStateArrivedAtPickup
    • GRCMapViewCustomerStateEnRoute
    • GRCMapViewCustomerStateEndOfTrip

  • 4 API 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;

  • 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ả các ETA điểm tham chiếu còn lại khi ETA thành điểm tham chiếu đầu tiên trong danh sách thay đổi.

  • Buộc máy ảnh tự động điều hướng khi người lái xe đến điểm đón trả.

  • Các giới hạn đối với máy ảnh sẽ bao gồm cả vị trí nhận xe và trả xe sau khi khách đặt chuyến đi và trước khi có bất kỳ vị trí xe nào trùng khớp.

Phiên bản 0.4.5(28.0) (Ngày 26 tháng 6 năm 2019)

Tính năng mới

  • Hỗ trợ đi chung xe cho việc 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 về tuyến đường hiện chỉ xảy ra khi đoạn tuyến đường được đồng bộ hoá, giúp cải thiện trải nghiệm người dùng.

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

Phiên bản 0.4.3 (ngày 17 tháng 5 năm 2019)

Tính năng mới

  • Hỗ trợ quay lại 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ỷ lệ báo cáo vị trí xe linh độ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 GRCTripServiceSubscription

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
remainingWaypoints cơ sở lưu trú
route cơ sở lưu trú
remainingDistanceInMeters cơ sở lưu trú
GRSTripWaypoint

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

  • Giảm mức tiêu thụ mạng để chia sẻ hành trình.
  • Hiện tại, đề xuất đến lấy hàng đã chọn đượ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 sự cố điểm đánh dấu không phản hồi khi nhấn lần thứ hai.
  • Khắc phục vấn đề giới hạn máy ảnh của mapView đôi khi hiển thị một khung nhìn không mong muốn vào lúc bắt đầu, sau khi chuyến đi được đặt trước.
  • Khắc phục vấn đề về SDK Version API.