取得驅動程式 SDK

本節說明如何驗證系統是否符合最低需求、設定 Workspace Group，以及取得 Driver SDK。

事前準備

iOS 版 Driver SDK 要求應用程式符合下列條件：

• 擁有 Navigation SDK。
• 在 Google Cloud 控制台中啟用 Maps SDK for iOS，並取得 API 金鑰。

檢查最低系統需求

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

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

取得 Google Workspace 存取權

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

1. 建立工作區群組。詳情請參閱「Workspace Group」。

   舉例來說，最佳做法是在新手上路期間為群組命名。[e-mail]

2. 將名稱提供給 Google，將您的 Workspace 群組加入許可清單，授予存取正確 CocoaPods 存放區的權限。

3. 確認需要存取權的使用者電子郵件和服務帳戶電子郵件是否已列入這份清單。

如果貴機構無法建立 Workspace 群組，請將需要存取這些構件項目的使用者和服務帳戶電子郵件地址清單傳送給 Google。

注意： Workspace 群組不等同於 Google 群組 (結尾為 @googlegroups.com)。僅支援 Workspace 群組。

使用 Cloud SDK 登入

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

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

gcloud

gcloud auth login

您必須使用 Workspace 群組成員的電子郵件地址。

設定自動化主機

針對建構系統或持續整合，請根據提供的服務帳戶方法清單，設定自動化主機，以便使用服務帳戶驗證 Google API 和服務。詳情請參閱「Google 的驗證方式」頁面中的服務帳戶專區。

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

• 否則，請將服務帳戶金鑰檔案儲存在主機檔案系統的安全位置，並適當設定 GOOGLE_APPLICATION_CREDENTIALS 環境變數。詳情請參閱 GOOGLE_APPLICATION_CREDENTIALS。

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

取得 Driver SDK

安裝及設定 Driver SDK。

CocoaPods

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

   sudo gem install cocoapods
   

   詳情請參閱 CocoaPods 入門指南。

2. 為 Driver 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
      

      以下範例將 Driver SDK 的 Alpha 和 Beta 版 pod 納入依附元件：

      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 安裝指令：這個指令會安裝 Podfile 中指定的 API，以及這些 API 可能有的任何依附元件。

   pod install
   

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

   注意： 請定期執行 pod outdated，以便偵測是否有較新的 SDK 版本。詳情請參閱「 Driver SDK for iOS 版本」
   。

Swift Package Manager

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

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

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

手動安裝程式庫

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

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

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

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

• 安裝 Navigation SDK。

請按照下列步驟手動安裝 Driver SDK：

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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 Settings」分頁標籤。在「Other Linker Flags」部分，為調試和發布版本新增 -ObjC。

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

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

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

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

後續步驟

設定 Google Cloud 控制台專案