取得 iOS Consumer SDK

選取平台： Android iOS JavaScript

如要在 iOS 消費者應用程式中追蹤隨選行程，請使用 Consumer SDK。如要進一步瞭解追蹤行程功能，並瞭解相關資訊，請參閱「在 iOS 上追蹤行程」。

如需範例，請參閱 iOS 範例應用程式或結合範例。

如要為 iOS 消費者應用程式設定 Consumer SDK，請按照下列步驟操作：

1. 檢查最低系統需求。
2. 取得 Consumer SDK。
3. 檢查 Apple 隱私權資訊清單檔案。
4. 設定 Google Cloud 控制台專案。
5. 取得驗證權杖。
6. 初始化 Consumer SDK。

檢查最低系統需求

請查看版本資訊，瞭解您所使用的 Consumer SDK 版本的最低需求條件。請參閱版本資訊。

• 行動裝置必須搭載 iOS 14 以上版本。
• Apple Xcode 15 以上版本。

取得 Consumer SDK

您可以使用 CocoaPods 安裝及設定 Consumer SDK。

Swift Package Manager

您可以透過 Swift Package Manager 安裝 Consumer SDK。如要新增 SDK，請務必移除任何現有的 Consumer SDK 依附元件。

重要事項：這些操作說明假設您使用 Xcode 15 以上版本，但適用於先前版本的 Xcode。

如要將 SDK 加進新的或現有專案，請按照下列步驟操作：

1. 開啟 Xcode project 或 workspace，然後依序點選「File」>「Add Package Dependencies」。
2. 輸入 https://github.com/googlemaps/ios-consumer-sdk 做為網址，按下 Enter 鍵來匯入套件，然後按一下「Add Package」。
3. 如要安裝特定 version，請將「Dependency Rule」欄位設為其中一個版本選項。對於新專案，建議您指定最新版本並使用「Exact Version」選項。完成後，按一下「新增套件」。

如要更新現有專案的 package，請按照下列步驟操作：

1. 如要驗證安裝作業，請前往 Project Navigator 的「Package Dependencies」部分，驗證套件及其版本。

重要事項：有時無法解析構件或發生錯誤，在這種情況下，請依序選取「File」>「Packages」>「Reset Package Cache」。

如要移除手動安裝的現有 Consumer SDK，請按照下列步驟操作：

1. 在 Xcode 專案設定中，找出「Frameworks, Libraries, and Embedded Content」。使用減號圖示(-)移除下列架構：

   • GoogleRidesharingConsumer.xcframework

2. 從 Xcode 專案的頂層目錄中移除 GoogleRidesharingConsumer 套件。

使用 CocoaPods

1. 安裝 CocoaPods 工具：開啟終端機視窗，然後執行下列指令：

   sudo gem install cocoapods
   

   詳情請參閱 CocoaPods 入門指南。

2. 為 Consumer SDK 建立 Podfile：您可以使用 Podfile 安裝 API 及其依附元件。

   1. 在專案目錄中建立名為 Podfile 的檔案。這個檔案會定義專案的依附元件。

   2. 編輯 Podfile 並新增依附元件。以下是包含依附元件的範例：

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

   3. 儲存 Podfile：開啟終端機，然後前往 Podfile 所在的資料夾：

      cd <path-to-project>
      

3. 執行 Pod 安裝指令：這個指令會安裝 Podfile 中指定的 API，以及可能的依附元件。

   pod install
   

4. 在 Xcode 中開啟專案：關閉 Xcode，接著按兩下來開啟專案的 .xcworkspace 檔案來啟動 Xcode。如要日後開啟專案，請使用 .xcworkspace 檔案。

   注意： 請定期執行 pod outdated，以便偵測 SDK 是否有新版本。詳情請參閱「Consumer SDK 版本資訊」一節中的「Consumer SDK 版本資訊」。

手動安裝程式庫

本指南將說明如何手動將含有 Consumer SDK 的 XCFramework 新增至專案，並在 Xcode 中完成建構設定。

注意：最佳做法是盡可能使用 Cocoapods 安裝 Consumer SDK。

在按照本指南操作之前，請先完成下列步驟：

• 下載 XCFramework，這是用來安裝 Consumer SDK 的二進位檔套件。您可以在多個平台上使用這個套件，包括使用 M1 晶片組的機器。

• 安裝 Maps SDK。

1. 下載 SDK 二進位檔和資源：

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

2. 解壓縮 ZIP 檔案，存取 XCFramework 和資源。

3. 啟動 Xcode，然後開啟或建立專案。如果您是 iOS 新手，請建立新專案，並選取 iOS 應用程式範本。

4. 如果專案群組不包含「架構」群組，請建立這個群組。

5. 將下載的 gRPCCertificates.bundle 檔案拖曳至 Xcode 專案的頂層目錄。如果出現提示，請選取「複製項目」。

6. 如要安裝 Consumer SDK，請將 GoogleRidesharingConsumer.xcframework 檔案拖曳至「Framework、Library 和 Embedded Content」下方的專案中。如果出現提示，請選取「複製項目」。

7. 將下載的 GoogleRidesharingConsumer.bundle 拖曳至 Xcode 專案的頂層目錄中。如果出現提示，請選取「複製項目」。

8. 從「Project Navigator」中選取您的專案，然後為您的應用程式選擇目標。

9. 開啟「Build Phases」分頁標籤，然後在「Link Binary with Libraries」中，新增下列架構和程式庫 (如果尚未顯示)：

   • 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. 選擇您的專案 (而不是特定目標)，然後開啟「Build Settings」分頁標籤。在「Other Linker Flags」部分中，為調試和發布版本新增 -ObjC。

    如果您沒有看到這些設定，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

檢查 Apple 隱私權資訊清單檔案

Apple 要求 App Store 中的應用程式提供應用程式隱私權詳細資料。如需最新消息和更多資訊，請造訪 Apple App Store 隱私權詳細資訊頁面。

Apple 隱私權資訊清單檔案已納入 SDK 的資源套件。如要驗證是否已納入隱私權資訊清單檔案，並檢查其內容，請建立應用程式的封存檔，然後從封存檔產生隱私權報告。

後續步驟

設定 Google Cloud 控制台專案