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

gcloud

gcloud auth login

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 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. Dưới đây là ví dụ có chứa 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à một 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ở 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 nhóm: 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à chúng 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 vào lúc khác, hãy sử dụng tệp .xcworkspace.

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 hiện có của SDK Trình điều khiển.

Để 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ở Xcode project hoặc workspace, sau đó chuyển đến File > Add Package Dependencies (Tệp > 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 Quy tắc phần phụ thuộc thành một trong các lựa 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 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) 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.

Để 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 được nhúng. Sử dụng dấu trừ(-) để xoá khung sau:

   • GoogleRidesharingDriver.xcframework

2. Trên 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.

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 và tài nguyên SDK 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 Frameworks, Libraries and Embedded Content (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 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 trên Project Navigator và 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 các chế độ cài đặt này không hiển thị, 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ả).