取得驅動程式 SDK

gcloud

gcloud auth login

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

   pod install
   

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

Swift Package Manager

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

如要將 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」選項。完成後，按一下「新增套裝方案」。
4. 在「Choose Package Products」視窗中，確認 GoogleRidesharingDriver 會新增至指定的 main 目標。完成後，按一下「新增套裝方案」。
5. 如要驗證安裝，請前往目標的「General」窗格。 在「Frameworks, Libraries, and Embedded Content」中，您應該會看到已安裝的套件。您也可以查看「Project Navigator」的「Package Dependencies」部分，確認套件及其版本。

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

1. 在 Xcode 中，依序前往「File」(檔案) >「Packages」(套件) >「Update To Latest Package Versions」(更新至最新套件版本)。
2. 如要驗證安裝，請前往「Project Navigator」的「Package Dependencies」部分，驗證套件及其版本。

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

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

   • GoogleRidesharingDriver.xcframework

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

手動安裝程式庫

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

按照本指南操作之前，請先完成下列事項：

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

• 安裝 Navigation SDK。

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

4. 如果專案群組不含 Frameworks 群組，請建立該群組。

5. 如要安裝 Driver SDK，請將 GoogleRidesharingDriver.xcframework 檔案拖曳至專案的「Frameworks, Libraries, and Embedded Content」下方。如果出現提示，請選取「Copy items」(複製項目)。

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