Maps SDK for iOS 版本

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」選項。完成後，按一下「新增套件」。

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

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

   在 Xcode 專案設定中，找出「Frameworks、Libraries 和 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。

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', '9.2.0'
end