Версии

Выберите платформу: Android iOS JavaScript

Специалисты платформы Google Карт регулярно обновляют SDK: добавляют новые функции, исправляют ошибки и повышают производительность. На этой странице вы найдете инструкции по управлению зависимостями при работе с новыми версиями SDK для мобильных устройств.

  • For mission-critical apps, link to the latest dot release of the major version that you are using (X.*). This method requires you to make app updates at least once a year, when a new major version is released.
  • For non-critical apps, link to any fixed version. When you receive a deprecation notice for that fixed version, you will have 12 months to make your updated app code available to your users. This method means less frequent maintenance work, but the work may involve a greater amount of resources to adapt, rewrite, and test than would be required for annual updates. Such work would have to be completed before the deprecation.

Владельцы проектов заблаговременно получают по электронной почте уведомления об изменениях по каждому из своих проектов. Узнавайте о крупных обновлениях, прекращении поддержки и других изменениях.

Установка

В файле build.gradle на уровне приложения всегда необходимо указывать точную версию. Если вы укажете диапазон префиксов (+) или значение latest, это может вызвать непредсказуемое или невоспроизводимое поведение сборки. Maps SDK для Android поддерживает семантическое управление версиями, поэтому новые основные версии могут содержать критические изменения. Минимально допустимый уровень API: 19.

Указывать зависимость от Карт в рамках сервисов Google Play необходимо с применением синтаксиса Gradle.

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

Вы также можете ознакомиться с дополнительными рекомендациями по работе с версиями сервисов Google Play.

Обслуживание и обновление

Android Studio автоматически проверяет наличие новых доступных версий зависимости. Если такая версия обнаружена, вы получите уведомление об этом. Чтобы избежать технических проблем, как можно скорее перейдите на самую последнюю версию. Если это новая основная версия, ознакомьтесь с примечаниями к выпуску, чтобы узнать, есть ли там функции с обратной несовместимостью и как обновить код.

Помимо уведомлений о новых версиях, владельцы проектов Google Cloud получают электронные письма о функциях с обратной несовместимостью, которая может затронуть их проекты. Чтобы не пропускать такие сообщения, назначьте владельца для каждого проекта, чтобы он регулярно просматривал письма, приходящие на его адрес электронной почты.