取得驅動程式 SDK

gcloud

gcloud auth login

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 套件管理工具

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

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

1. 開啟 Xcode project 或 workspace，然後依序前往「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. 如果要升級的是 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」部分 驗證套件及其版本

如要移除現有驅動程式 SDK 依附元件，請使用 CocoaPods，請按照下列步驟操作：

1. 關閉 Xcode 工作區。開啟終端機並執行下列指令：

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. 移除 Podfile、Podfile.resolved 和 如果不是 CocoaPods，則使用 Xcode workspace。

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

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

   • GoogleRidesharingDriver.xcframework

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

手動安裝程式庫

本指南將說明如何手動新增包含 將 SDK 驅動程式至專案，並在 Xcode 中調整建構設定。

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

• 下載 XCFramework (用於安裝 驅動程式 SDK。這個套件可用於多個平台，包括 採用 Apple 晶片的機器

• 安裝 Navigation SDK。

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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」。