取得驅動程式 SDK

本節說明如何確認系統符合基本需求。 設定 Workspace 群組,並取得驅動程式 SDK。

事前準備

應用程式必須符合下列標準,才能使用 iOS 版驅動程式 SDK:

  • 具備 Navigation SDK。
  • 在 Google Cloud 控制台中啟用 Maps SDK for iOS,並取得 API 金鑰。

檢查最低系統需求

查看版本資訊,瞭解 您使用的驅動程式 SDK。請參閱版本資訊

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

取得 Google Workspace 會員資格

如果您是 Google Workspace 客戶,請按照下列步驟操作:

  1. 建立 Workspace 群組。詳情請參閱「Workspace 群組」一文。

    舉例來說,新手上路期間,請務必為群組命名。google-maps-platform-sdk-users@workspacedomain.com

  2. 向 Google 提供名稱,即可將 Workspace 群組加入 會授予正確的 CocoaPods 存放區存取權。

  3. 確認需要存取權的使用者電子郵件和服務帳戶電子郵件地址 加入這份清單中

如果貴機構無法建立 Workspace 群組,請將清單傳送給 Google 存取這些構件的使用者及服務帳戶電子郵件。

使用 Cloud SDK 登入

如要進行本機開發,請使用 Cloud SDK 登入。詳情請參閱「安裝 gcloud CLI」一文。

以下範例說明如何使用 Cloud SDK 登入。

gcloud

gcloud auth login

你必須使用已加入 Workspace 群組的電子郵件地址,

設定自動化主機

如果是建構系統或持續整合,請根據建構作業的主機設定自動化主機 使用服務帳戶進行驗證 Google API 和服務詳情請參閱服務帳戶一節。 「驗證方式」頁面

  • 如果您的程序是在 Google Cloud 環境中執行,請使用 能自動偵測憑證詳情請參閱「自動偵測憑證」。

  • 否則,請將服務帳戶金鑰檔案存放在 並將 GOOGLE_APPLICATION_CREDENTIALS 設為 環境變數詳情請參閱 GOOGLE_APPLICATION_CREDENTIALS

與憑證相關聯的服務帳戶電子郵件地址必須是 Workspace 群組

取得驅動程式 SDK

安裝及設定 Driver SDK。

CocoaPods

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

    sudo gem install cocoapods
    

    詳情請參閱 CocoaPods 入門指南

  2. 建立驅動程式 SDK 的 Podfile:使用 Podfile 安裝 對 API 及其依附元件而言

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

    2. 編輯 Podfile 並新增依附元件。這個例子說明瞭 包含依附元件:

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

      以下這個範例包含了 使用驅動程式 SDK 做為依附元件:

      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. 儲存 Podfile:開啟終端機,然後前往 Podfile:

      cd <path-to-project>
      
  3. 執行 pod 安裝指令:這個指令會安裝 API 及其所有依附元件。

    pod install
    
  4. 在 Xcode 中開啟專案:關閉 Xcode,然後開啟 (按兩下) 專案的 .xcworkspace 檔案即可啟動 Xcode。若要開啟 請使用 .xcworkspace 檔案執行專案。

Swift Package Manager

您可以透過 Swift Package Manager 安裝 Driver SDK。如要新增 SDK,請確認您具備 已移除所有現有的驅動程式 SDK 依附元件

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

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

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

  1. 在 Xcode 中,前往 [檔案] >套裝行程 >更新至最新套件版本」。
  2. 如要驗證安裝作業,請前往 Project Navigator 的「Package Dependencies」部分,驗證套件及其版本。
,瞭解如何調查及移除這項存取權。

移除已安裝的現有驅動程式 SDK 手動操作,步驟如下:

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

    • GoogleRidesharingDriver.xcframework
  2. 從 Xcode 專案的頂層目錄中,移除 GoogleRidesharingDriver 軟體包。

手動安裝程式庫

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

按照本指南操作前,請先執行下列操作:

  • 下載 XCFramework,這是用來安裝 Driver SDK 的二進位檔套件。這個套件可用於多個平台,包括 採用 Apple 晶片的機器

  • 安裝 Navigation SDK

請按照下列步驟手動安裝驅動程式 SDK:

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

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

  3. 啟動 Xcode,然後開啟現有項目或建立專案。如果您是 建立新的專案並選取 iOS 應用程式範本

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

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

  6. 將下載的 GoogleRidesharingDriver.bundle 拖曳到頂層 目錄。畫面出現提示時,請選取「複製項目」

  7. 從「Project Navigator」中選取專案,然後選擇 並指定應用程式的目標

  8. 開啟「Build Phases」分頁,然後在「Link Binary with Libraries」內新增 下列架構和程式庫 (如果尚未提供):

    • 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. 選擇專案 (而非特定目標),然後開啟「Build」 設定標籤。在 Other Linker Flags 區段中,將 -ObjC 包括偵錯和發布版本

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

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

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

Apple 隱私權資訊清單檔案包含在 SDK 資源套件中。如要確認隱私權資訊清單檔案已納入並檢查其中的內容,請建立應用程式的封存檔案,然後從封存檔中產生隱私權報告

後續步驟

設定 Google Cloud 控制台專案