Google 地圖平台團隊會定期更新 SDK,加入新功能、修正錯誤及改善執行效能。本頁內容說明如何透過行動 SDK 管理依附元件。
要連結哪個版本?
-
如果是重要業務應用程式,請連結至目前使用的主要版本中最新的次要版本 (X.*),然後每年升級至新的主要版本。
如果全年陸續發布新版應用程式,您可以開始使用較新的 Maps SDK for Android 次要版本。這種做法不需要更新應用程式,因為新的次要版本具有回溯相容性。
優點:
- 根據行動裝置支援政策,如果您在 Maps SDK for Android 中發現問題,在主要版本首次發布後的 12 個月內,我們會以回溯相容的方式提供修正內容。您無須立即升級至不相容的 SDK 版本,即可進行修正。
- 如果您已在最新版本中建構應用程式,便可輕鬆採用最新改善項目和功能。
- 相較於處理多次發布主要版本時造成的回溯不相容性變更,每年更新 SDK 最新主要版本的做法,在調整、重寫及測試應用程式方面所需的作業量較少。
如果是非重要應用程式,請連結至任何修正版本。收到該修正版本的淘汰通知後,您必須在 12 個月內向使用者提供新版應用程式的程式碼。
優點:
- 維護作業頻率降低。
- 針對執行舊版行動作業系統的使用者裝置,新版應用程式持續提供支援的時間較長 (可持續到您必須升級至新版 SDK 為止)。
相關變更影響到各項專案時,電子郵件地址有人監管的專案擁有者會收到主動通知。隨時掌握重大更新、淘汰項目和其他異動。
安裝
在應用程式層級的 build.gradle
檔案中,請一律指定版本,而不使用前置字串範圍 (+
) 或 latest
,因為這麼做可能導致系統產生無法預測且不可重複的版本。Maps SDK for Android 採用語意化版本管理,而新的主要版本可能包含破壞性變更。支援的最低 API 級別為 19。
使用 Gradle 語法在 Google Play 服務中指定地圖依附元件。
dependencies { // Maps SDK for Android implementation 'com.google.android.gms:play-services-maps:18.2.0' }
如需更多有關控管 Google Play 服務版本管理的指引,請參閱這裡的內容。
維護與升級
Android Studio 會自動檢查可用的新版本,並在偵測到可用的新版依附元件時發出提醒。為了盡可能避免產生技術債,請盡快更新至最新的可用版本。如果您要更新至新的主要版本,請查看版本資訊瞭解是否有回溯不相容的變更,以及程式碼的更新方法。
除了針對新版本的意見調查之外,Google Cloud 專案擁有者也會收到通知電子郵件,說明回溯不相容性變更對專案可能造成的影響。如要取得與回溯不相容性變更相關的主動通知,請在每個專案中使用可監控的電子郵件地址指派擁有者角色。