Tải SDK cho người tiêu dùng iOS

Chọn nền tảng: Android iOS JavaScript

Để theo dõi các chuyến đi theo yêu cầu trong ứng dụng dành cho người tiêu dùng trên iOS, hãy sử dụng SDK dành cho người tiêu dùng. Để biết thêm thông tin và phần giới thiệu về cách theo dõi chuyến đi, hãy xem bài viết Theo dõi chuyến đi trên iOS.

Để xem ví dụ, hãy tham khảo phần các ứng dụng mẫu trên iOS hoặc các mẫu kết hợp.

Để thiết lập SDK Người tiêu dùng cho ứng dụng người tiêu dùng iOS, hãy làm theo các bước sau:

1. Kiểm tra các yêu cầu tối thiểu về hệ thống.
2. Tải Consumer SDK.
3. Kiểm tra tệp kê khai về quyền riêng tư của Apple.
4. Định cấu hình dự án trên Google Cloud Console.
5. Lấy mã thông báo xác thực.
6. Khởi động Consumer SDK.

Kiểm tra các yêu cầu tối thiểu về hệ thống

Hãy xem ghi chú phát hành để biết các yêu cầu tối thiểu đối với phiên bản SDK Người tiêu dùng mà bạn đang sử dụng. Xem Ghi chú phát hành.

• Thiết bị di động phải chạy iOS 16 trở lên.
• Apple Xcode phiên bản 26 trở lên.

Tải Consumer SDK

Bạn cài đặt và định cấu hình SDK Người tiêu dùng bằng CocoaPods.

Trình quản lý gói Swift

Bạn có thể cài đặt SDK Người tiêu dùng thông qua Trình quản lý gói Swift. Để thêm SDK, hãy đảm bảo bạn đã xoá mọi phần phụ thuộc SDK Người tiêu dùng hiện có.

Để thêm SDK vào một dự án mới hoặc hiện có, hãy làm theo các bước sau:

1. Mở project hoặc workspace Xcode, sau đó chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc của gói).
2. Nhập https://github.com/googlemaps/ios-consumer-sdk làm URL, nhấn phím Enter để lấy gói và nhấp vào "Add Package" (Thêm gói).
3. Để cài đặt một version cụ thể, hãy đặt trường Quy tắc phần phụ thuộc thành một trong các tuỳ chọn dựa trên phiên bản. Đối với các dự án mới, bạn nên chỉ định phiên bản mới nhất và sử dụng tuỳ chọn "Exact Version" (Phiên bản chính xác). Sau khi hoàn tất, hãy nhấp vào "Thêm gói".
4. Trong cửa sổ Choose Package Products (Chọn sản phẩm gói), hãy xác minh rằng GoogleRidesharingConsumer sẽ được thêm vào mục tiêu main được chỉ định. Sau khi hoàn tất, hãy nhấp vào "Thêm gói".
5. Để xác minh quá trình cài đặt, hãy chuyển đến ngăn General (Chung) của mục tiêu. Trong phần Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng), bạn sẽ thấy các gói đã cài đặt. Bạn cũng có thể xem phần "Package Dependencies" (Phần phụ thuộc của gói) trong "Project Navigator" (Trình điều hướng dự án) để xác minh gói và phiên bản của gói.

Để cập nhật package cho một dự án hiện có, hãy làm theo các bước sau:

1. Trong Xcode, hãy chuyển đến File > Packages > Update To Latest Package Versions (Tệp > Gói > Cập nhật lên phiên bản gói mới nhất).
2. Để xác minh quá trình cài đặt, hãy chuyển đến phần Package Dependencies (Phần phụ thuộc của gói) của Project Navigator (Trình điều hướng dự án) để xác minh gói và phiên bản của gói.

Quan trọng: Đôi khi, bạn không thể phân giải các cấu phần phần mềm hoặc có thể xảy ra lỗi. Trong trường hợp này, hãy chọn "File > Packages > Reset Package Cache" (Tệp > Gói > Đặt lại bộ nhớ đệm của gói).

Để xoá SDK Người tiêu dùng hiện có được cài đặt theo cách thủ công, hãy làm theo các bước sau:

1. Trong phần cài đặt cấu hình dự án Xcode, hãy tìm Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng). Sử dụng dấu trừ(-) để xoá khung sau:

   • GoogleRidesharingConsumer.xcframework

2. Trong thư mục cấp cao nhất của dự án Xcode, hãy xoá gói GoogleRidesharingConsumer.

Sử dụng CocoaPods

1. Cài đặt công cụ CocoaPods: Mở cửa sổ dòng lệnh rồi chạy lệnh sau:

   sudo gem install cocoapods
   

   Để biết thêm thông tin, hãy tham khảo Hướng dẫn bắt đầu sử dụng CocoaPods.

2. Tạo Podfile cho SDK Người tiêu dùng: Bạn sử dụng Podfile để cài đặt API và các phần phụ thuộc của API đó.

   1. Tạo một tệp có tên là Podfile trong thư mục dự án. Tệp này xác định các phần phụ thuộc của dự án.

   2. Chỉnh sửa Podfile và thêm các phần phụ thuộc. Dưới đây là ví dụ bao gồm các phần phụ thuộc:

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      

   3. Lưu Podfile: Mở cửa sổ dòng lệnh rồi chuyển đến thư mục có Podfile:

      cd <path-to-project>
      

3. Chạy lệnh cài đặt pod: Lệnh này cài đặt các API được chỉ định trong Podfile, cùng với mọi phần phụ thuộc mà các API đó có thể có.

   pod install
   

4. Mở dự án trong Xcode: Đóng Xcode rồi mở (nhấp đúp) tệp .xcworkspace của dự án để chạy Xcode. Để mở dự án sau, hãy sử dụng tệp .xcworkspace.

   Lưu ý: Chạy pod outdated định kỳ để phát hiện khi có phiên bản SDK mới hơn. Để biết thêm thông tin, hãy xem phần Phiên bản SDK cho người tiêu dùng trong Ghi chú phát hành SDK cho người tiêu dùng.

Cài đặt theo cách thủ công

Hướng dẫn này trình bày cách thêm XCFramework chứa Consumer SDK vào dự án theo cách thủ công và định cấu hình chế độ cài đặt bản dựng trong Xcode.

Thận trọng: Bạn nên sử dụng Cocoapods để cài đặt SDK Người tiêu dùng bất cứ khi nào có thể.

Trước khi làm theo hướng dẫn này, hãy làm như sau:

• Tải XCFramework xuống. Đây là một gói tệp nhị phân mà bạn dùng để cài đặt Consumer SDK. Bạn có thể sử dụng gói này trên nhiều nền tảng, bao gồm cả những máy dùng chipset M1.

• Cài đặt Maps SDK.

1. Tải tệp nhị phân và tài nguyên SDK xuống:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

2. Giải nén các tệp ZIP để truy cập vào XCFramework và tài nguyên.

3. Khởi động Xcode rồi mở hoặc tạo một dự án. Nếu bạn mới sử dụng iOS, hãy tạo một dự án mới và chọn mẫu Ứng dụng iOS.

4. Nếu nhóm dự án của bạn không chứa nhóm Frameworks, hãy tạo nhóm đó.

5. Kéo tệp gRPCCertificates.bundle đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Nếu được nhắc, hãy chọn Sao chép mục.

6. Để cài đặt SDK Người tiêu dùng, hãy kéo tệp GoogleRidesharingConsumer.xcframework vào dự án của bạn trong phần Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng). Nếu thấy lời nhắc, hãy chọn Sao chép mục.

7. Kéo GoogleRidesharingConsumer.bundle đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Nếu thấy lời nhắc, hãy chọn Sao chép mục.

8. Chọn dự án của bạn trong Project Navigator (Trình điều hướng dự án) rồi chọn mục tiêu của ứng dụng.

9. Mở thẻ Build Phases (Giai đoạn xây dựng) và trong phần Link Binary with Libraries (Liên kết tệp nhị phân với thư viện), hãy thêm các khung và thư viện sau nếu chưa có:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Chọn dự án của bạn thay vì một mục tiêu cụ thể, rồi mở thẻ Build Settings (Cài đặt bản dựng). Trong phần Other Linker Flags (Cờ trình liên kết khác), hãy thêm -ObjC cho cả bản gỡ lỗi và bản phát hành.

    Nếu bạn không thấy các chế độ cài đặt này, hãy thay đổi bộ lọc trong thanh Build Settings (Cài đặt bản dựng) từ Basic (Cơ bản) thành All (Tất cả).

Kiểm tra Tệp kê khai về quyền riêng tư của Apple

Apple yêu cầu các ứng dụng trên App Store phải cung cấp thông tin chi tiết về quyền riêng tư của ứng dụng. Hãy truy cập trang Thông tin về quyền riêng tư trên Apple App Store để biết thông tin cập nhật và thông tin khác.

Tệp kê khai về quyền riêng tư của Apple có trong gói tài nguyên cho SDK. Để xác minh rằng Tệp kê khai về quyền riêng tư đã được đưa vào và để kiểm tra nội dung của tệp này, hãy tạo một kho lưu trữ cho ứng dụng của bạn và tạo báo cáo về quyền riêng tư từ kho lưu trữ đó.

Bước tiếp theo

Định cấu hình dự án trên Google Cloud Console