取得驅動程式 SDK

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

事前準備

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

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

檢查最低系統需求

請參閱版本資訊，瞭解您目前使用的驅動程式 SDK 版本的最低需求。請參閱版本資訊。

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

取得 Google Workspace 存取權

如果您是 Google Workspace 客戶，請執行下列步驟：

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

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

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

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

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

注意： Workspace 群組「不」與以 @googlegroups.com 結尾的 Google 群組相同。僅支援 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 群組的成員。

取得驅動程式 SDK

安裝並設定驅動程式 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 及其所有依附元件。

   pod install
   

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

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

Swift Package Manager

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

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

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

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

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

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

重要事項：有時無法解決成果或發生錯誤，在這種情況下，請選取「File」>「Packages」>「重設套件快取」。

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

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

   • GoogleRidesharingDriver.xcframework

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

手動安裝程式庫

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

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

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

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

• 安裝 Navigation SDK。

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. 將壓縮的檔案解壓縮，以存取 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 控制台專案