Tải SDK trình điều khiển

Phần này mô tả cách xác minh rằng hệ thống của bạn đáp ứng các yêu cầu tối thiểu, thiết lập Nhóm Workspace rồi tải SDK trình điều khiển.

Trước khi bắt đầu

SDK Trình điều khiển dành cho iOS yêu cầu ứng dụng của bạn đáp ứng các tiêu chí sau:

  • Có SDK điều hướng.
  • Bật SDK bản đồ dành cho iOS trong Google Cloud Console của bạn và nhận khóa API.

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 trình điều khiển mà bạn đang sử dụng. Hãy xem phần Ghi chú phát hành.

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

Truy cập vào Google Workspace

Nếu bạn là khách hàng Google Workspace, hãy thực hiện các bước sau:

  1. Tạo một nhóm trên Workspace. Để biết thêm thông tin, hãy xem bài viết Nhóm Workspace.

    Ví dụ: phương pháp hay nhất là đặt tên cho nhóm của bạn google-maps-platform-sdk-users@workspacedomain.com trong khi làm quen với ứng dụng.

  2. Cung cấp tên cho Google để thêm Nhóm Workspace của bạn vào danh sách cho phép mà cấp quyền truy cập vào đúng kho lưu trữ CocoaPods.

  3. Xác nhận rằng email người dùng và email tài khoản dịch vụ cần có quyền truy cập có trong danh sách này.

Nếu tổ chức của bạn không thể tạo Nhóm trên Workspace, hãy gửi danh sách cho Google của người dùng và email tài khoản dịch vụ cần quyền truy cập vào các cấu phần phần mềm này.

Đăng nhập bằng Cloud SDK

Để phát triển cục bộ, hãy đăng nhập bằng Cloud SDK. Để biết thông tin chi tiết, hãy xem phần Cài đặt gcloud CLI.

Các ví dụ sau minh hoạ cách đăng nhập bằng Cloud SDK.

gcloud

gcloud auth login

Bạn phải sử dụng email là thành viên của Nhóm Workspace.

Thiết lập máy chủ tự động hoá

Đối với hệ thống xây dựng hoặc quá trình tích hợp liên tục, hãy thiết lập máy chủ tự động hoá dựa trên trên danh sách các phương thức được cung cấp để sử dụng tài khoản dịch vụ để xác thực API và dịch vụ của Google. Để biết thông tin chi tiết, hãy xem phần tài khoản dịch vụ trong trang Phương pháp xác thực tại Google.

  • Nếu quy trình của bạn chạy trong môi trường Google Cloud, hãy dùng tự động phát hiện thông tin xác thực. Để biết thêm thông tin, hãy xem tự động phát hiện thông tin đăng nhập.

  • Nếu không, hãy lưu trữ tệp khoá tài khoản dịch vụ ở một vị trí an toàn trên hệ thống tệp của máy chủ lưu trữ và thiết lập GOOGLE_APPLICATION_CREDENTIALS biến môi trường một cách thích hợp. Để biết thêm thông tin, hãy xem GOOGLE_APPLICATION_CREDENTIALS.

Email tài khoản dịch vụ được liên kết với thông tin xác thực phải là thành viên của Nhóm Workspace.

Tải SDK trình điều khiển

Cài đặt và định cấu hình SDK Trình điều khiển.

CocoaPods

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

    sudo gem install cocoapods

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

  2. Tạo Podfile cho SDK trình điều khiển: 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 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. Sau đây là một 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 'GoogleRidesharingDriver'
end

      Dưới đây là ví dụ bao gồm nhóm Alpha và Beta cho SDK trình điều khiển làm phần phụ thuộc:

      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 'GoogleRidesharingDriver'
end

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

      cd <path-to-project>

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

    pod install

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

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

Có thể cài đặt SDK Trình điều khiển qua Trình quản lý gói Swift. Để thêm SDK, hãy đảm bảo bạn có xoá mọi phần phụ thuộc hiện có của SDK Trình điều khiển.

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

  1. Mở Xcode project hoặc workspace của bạn, sau đó chuyển đến Tệp > Thêm phần phụ thuộc của gói.
  2. Nhập https://github.com/googlemaps/ios-driver-sdk làm URL, nhấn Enter để lấy gói rồi 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à bằng cách sử dụng "Phiên bản chính xác" . Sau khi hoàn tất, hãy nhấp vào "Add Package" (Thêm gói).
  4. Trong cửa sổ Choose Package Products (Chọn sản phẩm gói), xác minh để đảm bảo GoogleRidesharingDriver sẽ được thêm vào mục tiêu main bạn chỉ định. Sau khi hoàn tất, hãy nhấp vào "Add Package" (Thêm gói).
  5. Để xác minh chế độ cài đặt của bạn, hãy chuyển đến ngăn General của mục tiêu. Trong 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 "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.

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

  1. Nếu đang nâng cấp từ một phiên bản cũ hơn 9.0.0,bạn phải gỡ bỏ các phần phụ thuộc sau: GoogleMapsBase, GoogleMapsCore và GoogleMapsM4B sau khi nâng cấp. Không xoá phần phụ thuộc của GoogleMaps. Để biết thêm thông tin, hãy xem Ghi chú phát hành phiên bản 9.0.0.

    Trong phần cài đặt cấu hình dự án Xcode của bạn, hãy tìm Khung, Thư viện và Nội dung được nhúng. Sử dụng dấu trừ(-) để loại bỏ khung sau:

    • GoogleMapsBase (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
    • GoogleMapsCore (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
    • GoogleMapsM4B (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
  2. Từ Xcode, hãy chuyển đến "Tệp > Gói hàng > Hãy cập nhật lên phiên bản gói mới nhất".
  3. Để xác minh việc cài đặt của bạn, hãy chuyển đến phần Package Dependencies (Phần phụ thuộc 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.

Cách xoá các phần phụ thuộc hiện có của SDK Trình điều khiển đã thêm bằng cách sử dụng CocoaPods, hãy làm theo các bước sau:

  1. Đóng không gian làm việc Xcode của bạn. Mở terminal và thực thi lệnh sau: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. Xoá Podfile, Podfile.resolved và Xcode workspace nếu bạn không sử dụng chúng cho bất kỳ mục đích nào khác không phải là CocoaPods.

Cách xoá SDK Trình điều khiển đã cài đặt hiện có 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 của bạn, hãy tìm Frameworks, Thư viện và nội dung được nhúng. Dùng dấu trừ(-) để xoá khung sau:

    • GoogleRidesharingDriver.xcframework

  2. Từ thư mục cấp cao nhất của dự án Xcode của bạn, hãy xóa Gói GoogleRidesharingDriver.

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

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

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

  • Tải XCFramework, một gói nhị phân mà bạn sử dụng để cài đặt SDK trình điều khiển. Bạn có thể dùng gói này trên nhiều nền tảng, bao gồm máy sử dụng Apple Silicon

  • Cài đặt SDK điều hướng.

Thực hiện các bước sau để cài đặt SDK Trình điều khiển theo cách thủ công:

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

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

  3. Khởi động Xcode rồi mở một dự án hiện có hoặc tạo một dự án. Nếu bạn mới sử dụng iOS, hãy tạo 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 Khung, hãy tạo nhóm đó.

  5. Để cài đặt SDK Trình điều khiển, hãy kéo GoogleRidesharingDriver.xcframework tệp vào dự án của bạn trong Khung, thư viện và nội dung được nhúng. Nếu được nhắc, hãy chọn Sao chép các mục.

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

  7. Chọn dự án của bạn trên Project Navigator rồi chọn mục tiêu của ứng dụng.

  8. Mở tab Build Phase (Tạo giai đoạn) và trong 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 đây nếu chưa có:

    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • LocalAuthentication.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • WebKit.framework

  9. Chọn dự án của bạn, thay vì mục tiêu cụ thể, rồi mở cửa sổ Build Cài đặt. Trong phần Cờ trình liên kết khác, hãy thêm -ObjC cho cả gỡ lỗi và phát hành.

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

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

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

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 tệp kê khai về quyền riêng tư, cũng như để kiểm tra nội dung trong đó, hãy tạo một bản lưu trữ ứng dụng rồi tạo báo cáo về quyền riêng tư trong kho lưu trữ đó.

Các bước tiếp theo

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