Maps SDK for iOS 版本

選取平台： Android iOS JavaScript

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

要連結哪個版本？

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

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

  優點：

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

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

  優點：

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

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

安裝

Swift 套件管理工具

您可以透過 安裝 Maps SDK for iOS Swift 套件管理工具。如要新增 SDK，請確認您具備 已移除所有現有的 Maps SDK for iOS 依附元件。

重要： 這些指示假設使用 Xcode 15 以上版本，但應該很類似 先前的 Xcode 版本

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

1. 開啟 Xcode project 或 workspace，然後依序前往「File」>新增套件依附元件。
2. 輸入 https://github.com/googlemaps/ios-maps-sdk 做為網址，然後按下 Enter 鍵 來提取套件，然後點選「Add Package」
3. 如要安裝特定 version，請將「Dependency Rule」(依附元件規則) 欄位設為 版本化選項如果是新專案，建議您指定最新版本 使用「完全比對版本」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇完成後，點選「新增套件」。
4. 在「Choose Package Products」視窗中驗證 GoogleMaps (如果為 9.0.0 以下版本，請確認 GoogleMaps、GoogleMapsBase和 GoogleMapsCore) 將會加入 您指定的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」部分 驗證套件及其版本

，瞭解如何調查及移除這項存取權。

重要事項：有時成果無法解決或發生錯誤， 在這個範例中，請選取「檔案」套裝行程 >重設套件快取」。

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

1. 關閉 Xcode 工作區。開啟終端機並執行下列指令：

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. 移除 Podfile、Podfile.resolved 和 如果不是 CocoaPods，則使用 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', '8.4.0'
end

維護與升級

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

Swift 套件管理工具

如要更新現有專案的 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. 開啟終端機並前往包含 Podfile 的目錄：

   cd <path-to-project>

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

手動安裝程式庫

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

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