Kết hợp cả SDK trình điều khiển và SDK người dùng vào cùng một ứng dụng iOS

Lý do để thêm cả hai SDK trong cùng một ứng dụng iOS

Trong một số trường hợp, bạn có thể muốn có cả SDK trình điều khiển và SDK người dùng trong cùng một ứng dụng iOS. Ví dụ:

Bạn muốn có một ứng dụng xử lý cả chức năng của người lái và hành khách.
Ứng dụng của bạn cần cả khung hiển thị trình khám phá/điều phối để người lái xe có thể sử dụng, nhưng các thành viên khác trong nhóm có thể theo dõi thông tin chi tiết của một chiếc xe.

Điều kiện tiên quyết để tạo cả hai SDK trong cùng một ứng dụng

Bạn phải định cấu hình cả hai SDK trong quá trình thiết lập dự án. Đối với nhiều cách cài đặt khung, bạn có thể làm theo hướng dẫn SDK trình điều khiển với một số chi tiết nhỏ:

Để cài đặt CocoaPods, hãy xem Bắt đầu với SDK trình điều khiển cho Cấu hình dự án iOS CocoaPods.

Trong Podfile, hãy thêm phần phụ thuộc SDK người dùng. Podfile sẽ có dạng như sau

source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk.git"
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
source "https://github.com/CocoaPods/Specs.git"

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
    pod 'GoogleRidesharingConsumer'
    pod 'GoogleRidesharingDriver'
end

Để cài đặt theo cách thủ công, hãy xem bài viết Bắt đầu sử dụng SDK trình điều khiển cho quá trình cài đặt thủ công cấu hình dự án iOS.

Sau khi làm theo hướng dẫn cài đặt SDK trình điều khiển, hãy làm theo các bước 5 và 6 trong bài viết Bắt đầu sử dụng SDK người tiêu dùng cho cấu hình dự án iOS để cài đặt theo cách thủ công để định cấu hình SDK người dùng.

Lập phiên bản

Cả SDK trình điều khiển và SDK người tiêu dùng đều cần có phiên bản 3.3.0 trở lên để hỗ trợ tính năng này.

Các thay đổi có thể gây lỗi về mặt lý thuyết của SDK

SDK Trình điều khiển và SDK người dùng phiên bản 3.3.0 ra mắt các thay đổi sau đây về mặt lý thuyết có thể gây ra vấn đề cho một số ứng dụng SDK trình điều khiển, mặc dù điều này khó xảy ra. Nhìn chung, nếu ứng dụng SDK trình điều khiển của bạn sử dụng các lớp dành cho SDK người dùng, thì bạn cần khai báo SDK người dùng là phần phụ thuộc để tránh gặp vấn đề. Theo dõi là danh sách các thay đổi:

SDK trình điều khiển

Xoá các lớp không dùng đến:

GMTSLatLng.h
GMTSRequest.h
GMTSRequestHeader.h
GMTSRequestOptions.h
GMTSRequestOptionsSupport.h
GMTSSpeedReadingSpan.h
GMTSTerminalLocation.h
GMTSTimestamp.h
GMTSTrafficData.h
GMTSTrip.h
GMTSTripPropertyField.h
GMTSTripWaypoint.h
GMTSVehicle.h
GMTSVehicleLocation.h
GMTSVehicleMatch.h
GMTSVehicleSupportedTripType.h
GMTSVehicleType.h
GMTSWaypoint.h

Đổi tên lớp trong Preview (Bản xem trước). Chế độ này chỉ được chế độ người lái đáng tin cậy sử dụng trong Giải pháp Last Mile Fleet. Đối với chế độ đáng tin cậy, hãy xem bài viết Mô hình người lái đáng tin cậy (Bản xem trước).

GMTSTaskInfo.h -> GMTDTaskInfo.h

SDK dành cho người tiêu dùng

Đổi tên GMTSImmutableData thành lớp GMTCImmutableData. GMTSImmutableData chỉ được dùng làm lớp cơ sở và không được dùng trực tiếp.

GMTSImmutableData.h -> GMTCImmutableData.h

Đổi tên một typedef có khả năng tương thích ngược:

GMTSFleetEngineIDString.h -> GMTCFleetEngineIDString.h