Versioning

The Google Maps Platform team regularly updates SDKs with new features, bug fixes, and performance improvements. This page provides guidance on how to manage your dependencies on mobile SDKs.

Installation

In your app-level build.gradle file, always specify a version instead of a prefix range (+) or latest since these can lead to unpredictable and unrepeatable builds. The Maps SDK for Android adheres to semantic versioning, and new major version releases may include breaking changes.

Specifying the Maps dependency within Google Play services using Gradle syntax.

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

See additional guidance for managing Google Play services versioning.

Maintenance

Android Studio automatically checks for newer available versions and provides a warning when a newer version of a dependency is available. To minimize technical debt, update to the newest available version as soon as possible. If you are updating to a new major version, check the release notes for backwards-incompatible changes and how to update your code.

In addition to polling for newer versions, Google Cloud project owners receive emails about backwards incompatible changes that may affect their projects. To get proactive notification about backwards incompatible changes, assign the owner role with a monitored email address for each of your projects.