版本

選取平台: Android iOS JavaScript

Google 地圖平台團隊會定期更新 SDK,藉此添加新功能、修正錯誤及改善執行效能。本頁面將提供在行動 SDK 上管理依附元件的相關指引。

  • 如果是重要業務應用程式,請連結至您所使用主要版本的最新次要版本 (X.*)。如果使用這個方法,在新的主要版本推出後,您必須每年至少發布一次應用程式更新。
  • 如果是非重要應用程式,請連結至任何修正版本。收到該修正版本的淘汰通知後,您必須在 12 個月內向使用者提供新版應用程式程式碼。這種方法可以降低維護頻率,但與每年更新相比,調整、重寫及測試需要耗費更多資源。這類工作必須在版本淘汰之前完成。

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

安裝

在應用程式層級的 build.gradle 檔案中,請一律指定版本,而不使用前置字串範圍 (+) 或 latest,因為這麼做可能導致系統產生無法預測且不可重複的版本。Maps SDK for Android 採用語意化版本管理,而新的主要版本可能包含破壞性變更。支援的最低 API 級別為 19。

使用 Gradle 語法在 Google Play 服務中指定地圖依附元件。

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.0.2'
    // ...
}

如需更多有關控管 Google Play 服務版本管理的指引,請參閱這裡的內容

維護與升級

Android Studio 會自動檢查可用的新版本,並在偵測到可用的新版依附元件時發出提醒。為了盡可能避免產生技術債,請盡快更新至最新的可用版本。如果您要更新至新的主要版本,請查看版本資訊瞭解是否有回溯不相容的變更,以及程式碼的更新方法。

除了針對新版本的意見調查之外,Google Cloud 專案擁有者也會收到通知電子郵件,說明回溯不相容性變更對專案可能造成的影響。如要取得與回溯不相容性變更相關的主動通知,請在每個專案中使用可監控的電子郵件地址指派擁有者角色