取得 iOS Consumer SDK

選取平台： Android iOS JavaScript

如要在 iOS 消費者應用程式中追蹤隨選行程，請使用 Consumer SDK如需更多資訊及參閱以下簡介 透過分享功能進行的行程，請參閱 在 iOS 裝置上追蹤行程。

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

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

檢查最低系統需求

查看版本資訊，瞭解 您使用的用戶端 SDK。請參閱版本資訊。

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

取得 Consumer SDK

使用 CocoaPods 安裝並設定 Consumer SDK。

Swift 套件管理工具

您可以透過 安裝 Consumer SDK Swift 套件管理工具。如要新增 SDK，請確認您具備 移除了所有現有的 Consumer SDK 依附元件。

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

  1. 開啟 Xcode project 或 workspace，然後依序前往「File」>新增套件依附元件。
  2. 輸入 https://github.com/googlemaps/ios-consumer-sdk 做為網址，然後按下 Enter 鍵 來提取套件，然後點選「Add Package」
  3. 如要安裝特定 version，請將「Dependency Rule」(依附元件規則) 欄位設為 版本化選項如果是新專案，建議您指定最新版本 使用「完全比對版本」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇完成後，點選「新增套件」。
  4. 在「Choose Package Products」視窗中，確認 GoogleRidesharingConsumer 將新增至 您指定的main目標完成後，點選「新增套件」。
  5. 如要驗證安裝狀態，請前往目標的 General 窗格。 在「Frameworks、Library and Embedded Content」中應會顯示已安裝的套件。 您也可以查看「套件依附元件」「專案導覽器」的 驗證套件及其版本

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

  1. 如果要升級的是 9.0.0 以下版本，請務必移除 下列依附元件：GoogleMapsBase、GoogleMapsCore 和 升級後的費用為 GoogleMapsM4B。請勿移除以下項目的依附元件： GoogleMaps。詳情請參閱 9.0.0 版本資訊。

    在 Xcode 專案配置設定中，找到「Frameworks, libraries」 和嵌入內容請使用減號(-) 移除下列架構：

    • GoogleMapsBase (僅適用於 9.0.0 以下版本的升級作業)
    • GoogleMapsCore (僅適用於 9.0.0 以下版本的升級作業)
    • GoogleMapsM4B (僅適用於 9.0.0 以下版本的升級作業)
  2. 在 Xcode 中，前往 [檔案] >套裝行程 >更新至最新套件版本」。
  3. 如要驗證安裝狀態，請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
，瞭解如何調查及移除這項存取權。

如要移除使用 CocoaPods，請按照下列步驟操作：

  1. 關閉 Xcode 工作區。開啟終端機並執行下列指令： 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. 移除 Podfile、Podfile.resolved 和 如果不是 CocoaPods，則使用 Xcode workspace。

移除已安裝的現有 Consumer SDK 手動操作，步驟如下：

  1. 在 Xcode 專案配置設定中，找出 Frameworks、 程式庫和嵌入內容使用減號(-)即可移除 下列架構：

    • 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 安裝指令：這個指令會安裝 API 及其所有依附元件。

    pod install

  4. 在 Xcode 中開啟專案：關閉 Xcode，然後開啟 (連按兩下) 您專案的 .xcworkspace 檔案會啟動 Xcode。開啟專案 請稍後使用 .xcworkspace 檔案。

手動安裝程式庫

本指南將說明如何手動新增包含 用戶端 SDK 新增至專案，並在 Xcode 中進行建構設定。

按照本指南操作前，請先執行下列操作：

  • 下載 XCFramework (用於安裝 Consumer SDK。這個套件可用於多個平台，包括 搭載使用 M1 晶片組的機器

  • 安裝 Maps SDK：

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

  2. 將壓縮的檔案解壓縮，以存取 XCFramework 和資源。

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

  4. 如果您的專案群組不含架構群組，請建立一個。

  5. 將下載的 gRPCCertificates.bundle 檔案拖曳到頂層 目錄。畫面出現提示時，請選取「複製項目」。

  6. 如要安裝 Consumer SDK，請拖曳 將 GoogleRidesharingConsumer.xcframework 個檔案匯入專案 架構、程式庫和嵌入內容。畫面出現提示時，請選取 複製項目。

  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 控制台專案