В этом руководстве рассказывается, как установить Maps SDK для Android (версию 3.1.0 БЕТА). Завершив установку, узнайте, как пользоваться новыми функциями.
Как установить Maps SDK для Android, версия 3.1.0 БЕТА
Чтобы вручную добавить клиентскую библиотеку Maps SDK для Android версии 3.1.0 БЕТА в свой проект Android Studio, выполните указанные ниже действия.
-
Скачайте статическую библиотеку Places (этот шаг можно пропустить, если вы не используете Places).
- places-maps-sdk-3.1.0-beta.aar – необязательно. Используется только с Картами версии 3.1.0 БЕТА.
- Скопируйте файл AAR в папку
app/libs
своего проекта Android Studio. -
В разделе
buildscript.repositories
файла верхнего уровняbuild.gradle
должно быть указано хранилище Google Maven:buildscript { repositories { google() // ... } }
-
В разделе
dependencies
файла уровня приложенияbuild.gradle
добавьте Maps SDK для Android и (при необходимости) статическую библиотеку Places и ее требуемые зависимости:dependencies { implementation 'com.google.android.libraries.maps:maps:3.1.0-beta' // If you are using Places, add all of the dependencies below implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar' implementation 'com.google.android.gms:play-services-gcm:17.0.0' implementation 'com.google.auto.value:auto-value-annotations:1.6.2' }
В разделе
dependencies
файлаbuild.gradle
уровня приложения удалите строку implementation для прежней версии. Она должна выглядеть примерно так:- Синхронизируйте свой проект Gradle.
Преобразуйте существующие конфигурации.
- Если в вашем существующем приложении используется Maps SDK для Android через сервисы Google Play, замените все упоминания пакета
com.google.android.gms.maps
наcom.google.android.libraries.maps
. Для этого в Android Studio нажмите Edit (Изменить) > Replace in Path (Заменить в указанном каталоге). - Если в существующем приложении используется платформа Google Карт с пакетом услуг Premium Plan, замените все упоминания пакета
com.google.android.m4b.maps
наcom.google.android.libraries.maps
. Кроме того, удалите префиксm4b_
из всех упоминаний атрибутов макета XML. Например,m4b_mapType
нужно заменить наmapType
, аm4b_cameraZoom
– наcameraZoom
.
- Если в вашем существующем приложении используется Maps SDK для Android через сервисы Google Play, замените все упоминания пакета
-
Настройте в правилах ProGuard сохранение классов Maps SDK для Android, если в конечной сборке выполняются сжатие кода и обфускация.
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
Библиотека Maps SDK для Android доступна в репозитории Google Maven. Чтобы добавить SDK в свое приложение, выполните следующие действия:
implementation 'com.google.android.gms:play-services-maps:17.0.0'
Если вы клиент платформы Google Карт с пакетом услуг Premium Plan, то строка implementation, которую нужно удалить, будет выглядеть как в одном из следующих примеров:
implementation(name:'google-maps-sdk-m4b', ext:'aar') implementation project(':googlemapssdkm4b_lib')
Как импортировать библиотеку утилит, совместимую с бета-версией
Если вы используете библиотеку утилит Google Maps для Android, необходимо обновить зависимости вашего проекта, заменив существующую версию библиотеки на бета-совместимую. Для этого выполните следующие действия:
- Импортируйте бета-совместимую библиотеку утилит в файле
build.gradle
:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- Удалите следующую строку из файла
build.gradle
, чтобы удалить несовместимую библиотеку утилит:implementation 'com.google.maps.android:android-maps-utils:1.3.1'
Как запустить приложения–примеры
В репозитории Google Samples на сайте GitHub доступны примеры приложений, где демонстрируется использование Maps SDK для Android версии 3.1.0 БЕТА.
- Примеры приложений с интеграцией Maps SDK для Android
- Примеры приложений с интеграцией Places SDK для Android (только для использования с Картами версии 3.1.0 БЕТА)