取得 iOS Consumer SDK

Swift 套件管理工具

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

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

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

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

1. 在 Xcode 中，前往 [檔案] >套裝行程 >更新至最新套件版本」。
2. 如要驗證安裝狀態，請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本

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

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

   • GoogleRidesharingConsumer.xcframework

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

使用 CocoaPods

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

   sudo gem install cocoapods
   

   詳情請參閱 CocoaPods 入門指南。

2. 建立 Consumer SDK 的 Podfile：您 使用 Podfile 安裝 API 及其依附元件

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

   2. 編輯 Podfile 並新增依附元件。這裡是 包含依附元件的範例：

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

   3. 儲存 Podfile：開啟終端機，並前往 Podfile：

      cd <path-to-project>
      

3. 執行 pod 安裝指令：這個指令會安裝 API 及其所有依附元件。

   pod install
   

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

手動安裝程式庫

本指南將說明如何手動新增包含 用戶端 SDK 新增至專案，並在 Xcode 中進行建構設定。

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

• 下載 XCFramework (用於安裝 Consumer SDK。這個套件可用於多個平台，包括 搭載使用 M1 晶片組的機器

• 安裝 Maps SDK：

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

5. 將下載的 gRPCCertificates.bundle 檔案拖曳到頂層 目錄。畫面出現提示時，請選取「複製項目」。

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

7. 將下載的 GoogleRidesharingConsumer.bundle 拖曳到 您 Xcode 專案的頂層目錄畫面出現提示時，請選取 複製項目。

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

9. 開啟「Build Phases」分頁，並在「Link Binary with Libraries」內找到。 新增下列架構和程式庫 (如果尚未這麼做) 目前：

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. 選擇專案 (而非特定目標) 並開啟 「Build Settings」分頁。在「Other Linker Flags」部分中 為偵錯和發布版本新增 -ObjC。

    如果這些設定未顯示，請在 「Build Settings」列從「Basic」到「All」。