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 依附元件。
如要將 SDK 加入新專案或現有專案,請按照下列步驟操作:
-
開啟 Xcode
project
或workspace
,然後依序前往「File」>新增套件依附元件。 - 輸入 https://github.com/googlemaps/ios-maps-sdk 做為網址,然後按下 Enter 鍵 來提取套件,然後點選「Add Package」
-
如要安裝特定
version
,請將「Dependency Rule」(依附元件規則) 欄位設為 版本化選項如果是新專案,建議您指定最新版本 使用「完全比對版本」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇完成後,點選「新增套件」。 -
在「Choose Package Products」視窗中驗證
GoogleMaps
(如果為 9.0.0 以下版本,請確認GoogleMaps
、GoogleMapsBase
和GoogleMapsCore
) 將會加入 您指定的main
目標完成後,點選「新增套件」。 -
如要驗證安裝狀態,請前往目標的
General
窗格。 「Frameworks、Library and Embedded Content」應會顯示已安裝的套件。 您也可以查看「套件依附元件」「專案導覽器」的 驗證套件及其版本
如要更新現有專案的 package
,請按照下列步驟操作:
如果要升級的是 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 以下版本的升級作業)
- 在 Xcode 中,依序前往「File」>「Packages」>「Update To Latest Package Versions」。
- 如要驗證安裝狀態,請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
如要移除現有的 Maps SDK for iOS 依附元件,請使用
CocoaPods
,請按照下列步驟操作:
- 關閉 Xcode 工作區。開啟終端機並執行下列指令:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
移除
Podfile
、Podfile.resolved
和 如果不是 CocoaPods,則使用 Xcodeworkspace
。
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
,請按照下列步驟操作:
- 在 Xcode 中,前往 [檔案] >套裝行程 >更新至最新套件版本」。
- 如要驗證安裝狀態,請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
Cocoapods
手動安裝程式庫
取得最新來源檔案的連結 安裝 SDK 一文
除了輪詢較新版本外,Google Cloud 專案 擁有者會收到電子郵件,說明與回溯不相容的變更可能會對專案造成影響。目的地: 接收與回溯不相容變更相關的主動通知。 指派 擁有者角色,並使用受監控的電子郵件地址來處理各項專案。