Maps SDK for iOS 版本

選取平台： Android iOS JavaScript

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

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

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

    優點：

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

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

    優點：

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

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

安裝

Swift Package Manager

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

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

  1. 開啟 Xcode project 或 workspace，然後依序前往「File」>「Add Package Dependencies」。
  2. 輸入 https://github.com/googlemaps/ios-maps-sdk 做為網址，按下 Enter 鍵提取套件，然後按一下「Add Package」。
  3. 如要安裝特定 version，請將「Dependency Rule」欄位設為其中一個版本選項。如果是新專案，建議指定最新版本，並使用「Exact Version」選項。完成後，按一下「新增套裝方案」。
  4. 在「Choose Package Products」視窗中，確認 GoogleMaps (如果是 9.0.0 之前的版本，請確認 GoogleMaps、GoogleMapsBase 和 GoogleMapsCore) 會新增至指定的 main 目標。完成後，按一下「新增套裝方案」。
  5. 如要驗證安裝，請前往目標的「General」窗格。 在「Frameworks, Libraries, and Embedded Content」中，您應該會看到已安裝的套件。 您也可以查看「Project Navigator」的「Package Dependencies」部分，確認套件及其版本。

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

  1. 如果您是從 9.0.0 之前的版本升級，則必須在升級後移除下列依附元件：GoogleMapsBase、GoogleMapsCore 和 GoogleMapsM4B。請勿移除 GoogleMaps 的依附元件。詳情請參閱9.0.0 版版本資訊。

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

    • GoogleMapsBase (僅適用於從 9.0.0 以下版本升級)
    • GoogleMapsCore (僅適用於從 9.0.0 以下版本升級)
    • GoogleMapsM4B (僅適用於從 9.0.0 以下版本升級)
  2. 在 Xcode 中，依序前往「File」(檔案) >「Packages」(套件) >「Update To Latest Package Versions」(更新至最新套件版本)。
  3. 如要驗證安裝，請前往「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. 如果您只在 CocoaPods 使用 Podfile、Podfile.resolved 和 Xcode workspace，請移除這些項目。

維護與升級

如要使用最新改良功能建構，請定期檢查是否有新版本，並更新版本規格。如果您要更新至新的主要版本，請查看版本資訊，瞭解是否有回溯不相容的變更，以及程式碼的更新方法。

Swift Package Manager




To update the package for an existing project, follow these steps:


  
    
    
    
    
  1. 
      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
    2.

手動安裝程式庫

如要取得最新來源檔案的連結，請參閱「安裝 SDK」一節。

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