Maps SDK для версий Android

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Выберите платформу: Android iOS JavaScript

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

  • Для критически важных приложений создайте ссылку на последнюю точечную версию основной версии, которую вы используете (X.*), и ежегодно выполняйте обновление до новой основной версии.

    По мере выпуска новых версий вашего приложения в течение года вы можете начать использовать более новые точечные версии Maps SDK для Android. Это не потребует обновлений в вашем приложении, так как новые точечные версии обратно совместимы.

    Преимущества:

    • Если вы обнаружите проблемы в Maps SDK для Android, исправления будут предоставляться с обратной совместимостью в течение 12 месяцев после первоначального выпуска основной версии в соответствии с политикой поддержки мобильных устройств . Вам не нужно будет срочно переходить на несовместимую версию SDK, чтобы воспользоваться исправлениями.
    • Последние улучшения и функции легко внедрить, если ваше приложение уже создано на основе последней версии.
    • Ежегодные добавочные обновления новейшей основной версии SDK могут потребовать меньше усилий по адаптации, переписыванию и тестированию вашего приложения, чем обработка несовместимых с предыдущими версиями изменений, внесенных в несколько выпусков основных версий.

  • Для некритических приложений дайте ссылку на любую исправленную версию. Когда вы получите уведомление об устаревании этой фиксированной версии, у вас будет 12 месяцев, чтобы сделать обновленный код приложения доступным для ваших пользователей.

    Преимущества:

    • Менее частые работы по техническому обслуживанию.
    • Новые версии вашего приложения продолжают поддерживать устройства пользователей с более старыми мобильными операционными системами дольше (пока вам не потребуется перейти на новую версию SDK).

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

Монтаж

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

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

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

См. дополнительные рекомендации по управлению версиями сервисов Google Play .

Техническое обслуживание и обновление

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

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