取得 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 projectworkspace,然後依序前往「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. 在 Xcode 中,前往 [檔案] >套裝行程 >更新至最新套件版本」。
  2. 如要驗證安裝狀態,請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
,瞭解如何調查及移除這項存取權。

移除已安裝的現有 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 控制台專案