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

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

На какую версию дать ссылку?

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

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

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

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

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

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

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

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

Установка

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

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

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

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.