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

Phần này mô tả cách xác minh 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 không gian làm việc và tải SDK trình điều khiển.

Trước khi bắt đầu

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

• Có Navigation SDK.
• Bật SDK Maps cho iOS trong Google Cloud Console và lấy khoá API.

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

Hãy kiểm tra 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. Xem Ghi chú phát hành.

• Thiết bị di động phải chạy iOS 14 trở lên.
• Xcode của Apple 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 làm theo các bước sau:

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

   Ví dụ: Bạn nên đặt tên nhóm là [e-mail] trong quá trình làm quen.

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

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

Nếu tổ chức của bạn không thể tạo Nhóm Workspace, hãy gửi cho Google danh sách email của người dùng và 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.

Lưu ý: Nhóm Workspace không giống với Nhóm Google, có đuôi là @googlegroups.com. Chỉ hỗ trợ Nhóm Workspace.

Đă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 bài viết Cài đặt gcloud CLI.

Các ví dụ sau đây cho thấy cách đăng nhập bằng Cloud SDK.

gcloud

gcloud auth login

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

Thiết lập máy chủ lưu trữ tự động

Đối với hệ thống xây dựng hoặc tích hợp liên tục, hãy thiết lập máy chủ tự động hoá dựa 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ụ nhằm xác thực với cá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 thức xác thực của Google.

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

• 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ủ và đặt biến môi trường GOOGLE_APPLICATION_CREDENTIALS một cách thích hợp. Để biết thêm thông tin, hãy xem GOOGLE_APPLICATION_CREDENTIALS.

Email của 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 thông tin, hãy tham khảo Hướng dẫn bắt đầu sử dụng CocoaPods.

2. Tạo tệp Pod cho SDK trình điều khiển: Bạn sử dụng tệp Pod để 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 'GoogleRidesharingDriver'
      end
      

      Dưới đây là ví dụ bao gồm các nhóm Alpha và Beta cho SDK Trình điều khiển dưới dạng 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ở một 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 sẽ 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, sau đó 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 ý: Hãy chạy định kỳ pod outdated để phát hiện thời điểm có phiên bản SDK mới hơn. Để biết thêm thông tin, hãy xem phần SDK trình điều khiển cho các phiên bản iOS.

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

Bạn có thể cài đặt SDK trình điều khiển 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 trình điều khiển hiện có.

Lưu ý quan trọng: Những hướng dẫn này giả định bạn sử dụng Xcode 15 trở lên, nhưng cũng tương tự đối với các phiên bản Xcode trướ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 (Tệp) > Add Package Dependencies (Thêm phần phụ thuộc gói).
2. Nhập https://github.com/googlemaps/ios-driver-sdk làm URL, nhấn phím Enter để lấy gói và nhấp vào "Thêm gói".
3. Để cài đặt một version cụ thể, hãy đặt trường Dependency Rule (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 "Phiên bản chính xác". Sau khi hoàn tất, hãy nhấp vào "Thêm 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. Để xác minh quá trình cài đặt, 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.

Lưu ý quan trọng: Đôi khi, bạn không thể phân giải 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 gói).

Để xoá SDK Trình điều khiển 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 Khung, Thư viện và Nội dung nhúng. Sử dụng dấu trừ(-) để xoá khung sau:

   • GoogleRidesharingDriver.xcframework

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

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

Hướng dẫn này cho biết cách thêm XCFramework chứa SDK Trình điều khiển 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 trình điều khiển 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, một gói nhị phân mà bạn dùng để cài đặt SDK Trình điều khiển. Bạn có thể sử dụng gói này trên nhiều nền tảng, bao gồm cả máy sử dụng Apple silicon

• Cài đặt Navigation SDK.

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 SDK và tài nguyên xuống:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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 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 Khung, hãy tạo nhóm đó.

5. Để cài đặt SDK trình điều khiển, hãy kéo tệp GoogleRidesharingDriver.xcframework vào dự án của bạn trong phần Khung, Thư viện và Nội dung 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 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 các mục.

7. 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.

8. Mở thẻ Build Phases (Giai đoạn xây dựng) 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ộ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ả gỡ lỗi và 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 thông tin chi tiết về quyền riêng tư trong ứng dụng đối với các ứng dụng trên App Store. Hãy truy cập vào trang Thông tin chi tiết về quyền riêng tư trên App Store của Apple để biết thông tin cập nhật và thông tin khác.

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

Bước tiếp theo

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