Maps SDK for iOS 版本

選取平台: Android iOS JavaScript

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

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

    如果全年陸續發布新版應用程式,您可以開始使用較新的 Maps SDK for iOS 次要版本。這種做法不需要更新應用程式,因為新的次要版本具有回溯相容性。

    優點:

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

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

    優點:

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

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

安裝

Swift 套件管理員

您可以透過 Swift Package Manager 安裝 Maps SDK for iOS。如要新增 SDK,請確認您已移除所有現有的 Maps SDK for iOS 依附元件。

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

  1. 開啟 Xcode projectworkspace,然後依序前往「File」>「Add Package Dependencies」。
  2. 在網址欄位中輸入 https://github.com/googlemaps/ios-maps-sdk,按下 Enter 鍵擷取套件,然後按一下「新增套件」。
  3. 如要安裝特定 version,請將「Dependency Rule」欄位設為其中一個版本型選項。如果是新專案,建議您指定最新版本並使用「精確版本」選項。完成後,按一下 [Add Package]。
  4. 在「Choose Package Products」視窗中,確認 GoogleMapsGoogleMapsBaseGoogleMapsCore 會新增至指定的 main 目標。完成後,按一下「Add Package」。
  5. 如要驗證安裝,請前往目標的 General 窗格。「Frameworks、程式庫和嵌入的內容」應該會顯示已安裝的套件。 您也可以查看「Project Navigator」的「Package Dependencies」部分,確認套件及其版本。

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

  1. 在 Xcode 中,依序前往「File」>「Packages」>「Update to Package Versions」。
  2. 如要驗證安裝,請前往「Project Navigator」的「Package Dependencies」部分,驗證套件及其版本。

如要移除使用 CocoaPods 新增的現有 Maps SDK for iOS 依附元件,請按照下列步驟操作:

  1. 關閉 Xcode 工作區。開啟終端機並執行下列指令:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. 如果不想將 PodfilePodfile.resolved 和 Xcode workspace 用於 CocoaPods 以外的任何產品,請移除。

CocoaPods

請務必在依附元件中指定版本號碼,而不要使用樂觀運算子 (~>),因為這麼做可能導致系統產生無法預測且不可重複的版本。Maps SDK for iOS 採用語意化版本管理,而新的主要版本包含破壞性變更。

以下是使用 Podfile 語法的 Podfile 依附元件範例:

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.4.0'
end

維護與升級

如要使用最新改善項目進行建構,請定期檢查新版本並更新版本規格。如果您要更新至新的主要版本,請參閱版本資訊瞭解是否有回溯不相容的變更,以及程式碼的更新方法。

Swift 套件管理員

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

  1. 在 Xcode 中,依序前往「File」>「Packages」>「Update to Package Versions」。
  2. 如要驗證安裝,請前往「Project Navigator」的「Package Dependencies」部分,驗證套件及其版本。

Cocoapods

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

    cd <path-to-project>
  2. 執行 pod outdated,查看是否有新版 Maps SDK for iOS 可用。
  3. 如果找到較新版本的 SDK,請使用這個新版本更新 Podfile。如要瞭解如何在 Podfile 中設定特定版本,請參閱指定 Pod 版本
  4. 執行 pod update
  5. 進行任何必要變更,以便完成升級。如需每個版本的變更清單,請參閱版本資訊
  6. 依序選取「Product」>「Clean」>「Product」>「Build」,即可清理並重新建構專案

手動

在安裝 SDK 中取得最新來源檔案的連結

除了輪詢較新版本之外,Google Cloud 專案擁有者也會收到通知電子郵件,說明回溯不相容性變更可能會影響專案。如要取得與回溯不相容性變更相關的主動通知,請在每個專案中使用可監控的電子郵件地址指派擁有者角色