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

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

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

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

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

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

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

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

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

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

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

Установка

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

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:5.1.1")
}

Техническое обслуживание и модернизация

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

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

Если вы обновляете приложение с версии Places SDK для Android 3.2.0 или более ранней,

При переходе на новый SDK миграция не требуется. Вам нужно лишь:

  1. Включите функцию Places API (новая) для ключа API, используемого в вашем приложении. Для получения дополнительной информации см. раздел «Использование ключей API» .

  2. В разделе dependencies вашего файла build.gradle на уровне модуля обновите зависимость places и добавьте зависимость kotlin-bom :

      dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.5.0'
  }

    Для получения дополнительной информации о зависимости kotlin-bom см. раздел «Использование последней версии kotlin-stdlib в транзитивных зависимостях» .

  3. Обновите существующее приложение, добавив вызов нового метода Places.initializeWithNewPlacesApiEnabled() для инициализации приложения. Дополнительную информацию см. в разделе «Инициализация клиента Places API» .

Ваши существующие приложения продолжат работать без изменений, но теперь вы можете воспользоваться всеми новыми функциями SDK.