取得 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. 如要驗證安裝作業，請前往 Project Navigator 的「Package Dependencies」部分，驗證套件及其版本。

如要移除手動安裝的現有 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 安裝指令：這個指令會安裝 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. 如果專案群組不包含「架構」群組，請建立這個群組。

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

6. 如要安裝 Consumer SDK，請將 GoogleRidesharingConsumer.xcframework 檔案拖曳至「Framework、Library 和 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」。