iOS 版本消費者 SDK

Google 地圖平台團隊會定期更新 SDK，加入新功能、修正錯誤及改善執行效能。本頁內容說明如何透過行動 SDK 管理依附元件。

  • 如果是重要業務應用程式，請連結至目前使用的主要版本中最新的次要版本 (X.*)，然後每年升級至新的主要版本。

    發布應用程式新版本時 在這一年內，您就可以開始使用較新的 iOS 版 Consumer SDK。這種做法不需要更新應用程式，因為新的次要版本具有回溯相容性。

    優點：

    • 如果您在 iOS 版 Consumer SDK 中發現問題，我們會透過 主要版本發布後 12 個月內，回溯相容。 行動服務支援 政策。您無須立即升級至不相容的 SDK 版本，即可進行修正。
    • 如果您已在最新版本中建構應用程式，便可輕鬆採用最新改善項目和功能。
    • 相較於處理多次發布主要版本時造成的回溯不相容性變更，每年更新 SDK 最新主要版本的做法，在調整、重寫及測試應用程式方面所需的作業量較少。

  • 如果是非重要應用程式，請連結至任何修正版本。收到該修正版本的淘汰通知後，您必須在 12 個月內向使用者提供新版應用程式的程式碼。

    優點：

    • 維護作業頻率降低。
    • 針對執行舊版行動作業系統的使用者裝置，新版應用程式持續提供支援的時間較長 (可持續到您必須升級至新版 SDK 為止)。

相關變更影響到各項專案時，電子郵件地址有人監管的專案擁有者會收到主動通知。隨時掌握重大更新、淘汰項目和其他異動。

安裝

請務必在依附元件中指定版本號碼，不要使用樂觀運算子 (~>)，因為這可能會導致無法預測且不可重複的版本。 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. 如果要升級的是 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」部分 驗證套件及其版本
，瞭解如何調查及移除這項存取權。

如要移除使用 CocoaPods，請按照下列步驟操作：

  1. 關閉 Xcode 工作區。開啟終端機並執行下列指令： 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. 移除 Podfile、Podfile.resolved 和 如果不是 CocoaPods，則使用 Xcode workspace。

CocoaPods

CocoaPods

使用以下程式碼的 Podfile 依附元件範例 Podfile 語法：

    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end

以下是使用 Consumer SDK Beta 版的 Podfile 依附元件範例：

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end

維護與升級

如要使用最新的改善項目執行建構作業，請定期檢查新版本並更新 規格。如果您要更新至新的主要版本，請檢查 版本資訊 ，瞭解回溯不相容的變更，以及如何更新程式碼。

Cocoapods

  1. 開啟終端機並前往包含 Podfile 的目錄：

    cd <path-to-project>
  2. 執行 pod outdated，查看是否有較新版本的 Consumer SDK for iOS 可以使用。
  3. 如果找到新版 SDK，請使用這個新版本更新您的 Podfile。 請參閱指定 Pod 版本 ，瞭解如何在 Podfile 中設定特定版本。
  4. 執行 pod update。
  5. 對升級做出必要的修改。詳情請參閱 版本資訊。
  6. 選取 [產品] > 即可清理並重新建立專案清理，然後 產品 >版本

手動

取得最新來源檔案的連結 安裝 SDK 一文

除了輪詢較新版本外，Google Cloud 專案 擁有者會收到電子郵件，說明與回溯不相容的變更可能會對專案造成影響。目的地： 接收與回溯不相容變更相關的主動通知。 指派 擁有者角色，並使用受監控的電子郵件地址來處理各項專案。