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

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

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 là 15.0.
  • Bản phát hành này chứa tệp .xcprivacy để hỗ trợ Tệp kê khai quyền riêng tư của Apple.
  • Có 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 Trình điều khiển và SDK Người tiêu dùng để các SDK này có thể được xây dựng 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

  • Không dùng [GMTCMapView initWithCoder] trong GMTCMapView nữa.

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à .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 dựa trên 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 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.
  • 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 được hỗ trợ mới là 14.0. Hãy lưu ý về việc ngừng hỗ trợ trong ghi chú phát hành của Xcode 14 về việc ngừng hỗ trợ bản 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 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 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 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

Hỗ trợ đóng băng cho iOS 14 – ngày 15 tháng 5 năm 2023

Theo Hỗ trợ phiên bản Hệ điều hành dành cho thiết bị di động , chúng tôi luôn sẵn sàng hỗ trợ treo cho iOS 14 trong phiên bản lớn sắp tới của SDK người tiêu dùng iOS.

Các phiên bản SDK người tiêu dùng dành 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ũ 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, IDE sẽ tải phiên bản SDK mới nhất và 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 tiêu 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 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 của 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 khắc phục các vấn đề nhỏ khác về dấu 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 này.

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á Terminal Point Service, 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

  • 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 băng (ngừng hỗ trợ) đối với iOS 13 trong các bản cập nhật phiên bản chính trong năm 2023 cho SDK iOS dành cho người tiêu dùng. Phiên bản iOS tối thiểu được hỗ trợ sẽ là iOS 14, bắt đầu từ tháng 6 năm 2023. 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 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 sẽ gọi getToken() để triển khai giao diện AuthTokenFactory cho mỗi gRPC. SDK làm 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 việc tạo mã thông báo hợp lệ là tuỳ thuộc vào bạn. 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 thuộc tính chuyến đi: remainingDistanceOfActiveRouteInMeters.

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

  • Đã thêm thuộc tính remainingDistanceOfCurrentRouteInMeters.

  • Đã thêm 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.

  • Giờ đây, RegisterSubscriber sẽ 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.

Hỗ trợ đóng băng cho iOS 12 – Ngày 18 tháng 10 năm 2021

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

SDK người tiêu dùng dành cho iOS phiên bản 2.0 trở lên sẽ chỉ hỗ trợ thiết bị đang 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ầ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à bản dựng mới của ứng dụng của bạn 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 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. Xem ví dụ về cách chỉ định phiên bản trong tài liệu Maps SDK 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 tham gia bằng cách sử dụng setAbnormalTerminationReportingEnabled: API 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 API GMTSLicense

  • Thêm khoá mới kGMTSAuthorizationContextKeyTaskID để chỉ định mã công việc trong authorizationContext khi fetchAuthTokenForServiceType:authorizationContext:completion: sẽ đượ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

Không còn hỗ trợ cho 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 sẽ 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 sai tuyến đã được cải thiện (yêu cầu DriverSDK 1.15):
    • Tính năng theo dõi xe không điều chỉnh xe theo tuyến đường khi xe đang chạy qua điểm đến lấy hàng.
    • Tính năng theo dõi xe cho phép hiển thị xe ngoài đường; ví dụ: trong những 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 hiển thị tuyến đường lỗi thời khi người lái xe không khớp với đích đến trong Fleet Engine.
  • Câu trả lời về chuyến đi đã lỗi thời hiện bị loại bỏ.

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ý về độ trễ của yêu cầu về chuyến đi.

  • Thêm nhật ký cho các lỗi phản hồi về 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ợ tính năng Chia sẻ hành trình cho nhiều điểm đến.

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 thuộc tính 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 callback 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 là điểm tham chiếu đầu tiên trong thay đổi đối với danh sách.

  • Buộc camera tự động căn giữa lại chính sách khi người lái xe đến điểm đón.

  • Giới hạn máy ảnh sẽ bao gồm cả vị trí nhận hàng và trả xe sau một chuyến đi được đặt và trước khi có vị trí phù hợp của xe.

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 tính năng 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 đường được đồng bộ hoá, dẫn đến trong trải nghiệm người dùng được cải thiện.

  • 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

  • Quay lại hỗ trợ 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 GRCTripServiceSubscriptions

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 cho tính năng chia sẻ hành trình.
  • Đề xuất đến lấy hàng được chọn hiện được làm nổi bật.
  • Tương thích với Maps SDK 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 ngoài dự kiến ngay từ đầu, sau khi bạn đặt một chuyến đi.
  • Khắc phục vấn đề với API Phiên bản SDK.