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

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

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

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

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

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

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

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

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

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

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

Установка

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

dependencies {

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

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

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

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

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

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

  1. Включите API Places (новое) для ключа 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() для инициализации приложения. Подробнее см. в статье «Инициализация клиента API Places» .

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