取得 iOS Consumer SDK

Swift Package Manager

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

如要在新專案或現有專案中新增 SDK，請按照下列步驟操作：

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

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

1. 如要驗證安裝作業，請前往「專案導覽器」的「套件依附元件」部分，驗證套件及其版本。

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

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

   • 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 install 指令：這項指令會安裝 Podfile 中指定的 API 及其所有依附元件。

   pod install
   

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

手動安裝程式庫

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

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

• 下載 XCFramework，這是用來安裝 Consumer SDK 的二進位套件。您可以在多個平台上使用這個套件，包括使用 M1 晶片的電腦。

• 安裝 Maps SDK。

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

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

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

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

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

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

6. 如要安裝 Consumer SDK，請將 GoogleRidesharingConsumer.xcframework 檔案拖曳至專案的「Frameworks, Libraries, and Embedded Content」下方。如果出現提示，請選取「複製項目」。

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