Maps SDK for iOS 版本

選取平台： Android iOS JavaScript

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

要連結哪個版本？

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

全年發布新版應用程式時，您可能會開始使用新版 Maps SDK for iOS 圓點。這種做法不需要更新應用程式，因為新的次要版本具有回溯相容性。

優點：
- 如果您在 Maps SDK for iOS 中發現問題，根據行動支援政策，在主要版本首次發布後，我們會提供回溯相容的 12 個月修正項目。您無須立即升級至不相容的 SDK 版本，即可進行修正。
- 如果您已在最新版本中建構應用程式，便可輕鬆採用最新改善項目和功能。
- 相較於處理多次發布主要版本時造成的回溯不相容性變更，每年更新 SDK 最新主要版本的做法，在調整、重寫及測試應用程式方面所需的作業量較少。
如果是非重要應用程式，請連結至任何修正版本。收到該修正版本的淘汰通知後，您必須在 12 個月內向使用者提供新版應用程式的程式碼。

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

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

請一律在依附元件中指定版本號碼，而非使用最佳運算子 (~>)，因為這樣會導致系統產生無法預測且不可重複的版本。Maps SDK for iOS 採用語意化版本管理，而新的主要版本包含破壞性變更。

使用 Podfile 語法的 Podfile 依附元件範例：

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

platform :ios, '13.0'

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

使用 Cartfile 語法的 Cartfile 依附元件範例：

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

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

開啟終端機並前往包含 Podfile 的目錄：
```
cd <path-to-project>
```
執行 pod outdated，查看是否有可用的新版 Maps SDK for iOS 版本。
如果找到新版 SDK，請將新版本更新為 Podfile。如要瞭解如何在 Podfile 中設定特定版本，請參閱指定 Pod 版本。
執行 pod update。
進行升級後，請進行必要的修改。如需各版本的變更清單，請參閱版本資訊。
依序選取 [Product] (產品) > [Clean] (清理) > [Product] (產品) > [Build] (建構)，即可清理及重新建構您的專案

開啟終端機並前往包含 Podfile 的目錄：
```
cd <path-to-project>
```
執行 carthage outdated，查看是否有可用的新版 Maps SDK for iOS 版本。
如果找到新版 SDK，請將新版本更新為 Cartfile。請參閱版本規定，瞭解如何在 Cartfile 中設定特定版本。
執行 carthage update。
進行升級後，請進行必要的修改。如需各版本的變更清單，請參閱版本資訊。
依序選取 [Product] (產品) > [Clean] (清理) > [Product] (產品) > [Build] (建構)，即可清理及重新建構您的專案

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