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

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

SDK Người tiêu dùng có thể được cài đặt 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 dùng hiện có.

Để 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-consumer-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 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. Trên cửa sổ Choose Package Products (Chọn sản phẩm gói), hãy xác minh để đảm bảo GoogleRidesharingConsumer 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. 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 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.

Để xoá SDK Người tiêu dùng hiện 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. Dùng dấu trừ(-) để xoá khung sau:

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

Sử dụng 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 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 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à ví dụ có 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ó Tệp 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 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) tệp .xcworkspace của dự án để chạy Xcode. Để mở dự án sau, hãy sử dụng tệp .xcworkspace.

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 Người dùng 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 sử dụng để cài đặt SDK dành cho người tiêu dùng. 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 chipset M1.

• Cài đặt SDK Maps.

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 nén để 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 mới sử dụng iOS, hãy tạo một dự án mới rồi 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. Kéo tệp gRPCCertificates.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.

6. Để cài đặt SDK Người tiêu dùng, hãy kéo GoogleRidesharingConsumer.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.

7. Kéo GoogleRidesharingConsumer.bundle đã tải xuống vào thư mục 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.

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

9. 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
   • 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ục tiêu cụ thể, rồi mở Build Settings (Cài đặt bản dựng). Trong phần Cờ trình liên kết khác, 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ả).