В этой статье рассказывается, как настроить проект Android Studio для использования Maps SDK для Android, не применяя шаблон Google Карт, описанный в кратком руководстве.
Этот шаблон автоматически задает конфигурацию для проекта и добавляет базовую карту. Однако вы также можете добавить карту в проект Android, где используется другой шаблон Android Studio. Для этого необходимо вручную изменить настройки проекта, а затем добавить карту.
Шаг 1. Настройте Android Studio
- Вам потребуется Android Studio версии Arctic Fox или более поздней. Если у вас нет этого инструмента, скачайте и установите его.
- Убедитесь, что вы используете в Android Studio плагин Android Gradle версии 7.0 или более поздней.
Шаг 2. Настройте SDK
Библиотека Maps SDK для Android доступна в репозитории Google Maven. Чтобы добавить SDK в свое приложение, выполните следующие действия:
- Добавьте портал плагина Gradle, репозиторий Google Maven и центральный репозиторий Maven в блок
pluginManagement
файлаsettings.gradle
верхнего уровня. БлокpluginManagement
должен находиться над всеми операторами скрипта.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Добавьте репозиторий Google Maven и центральный репозиторий Maven в блок
dependencyResolutionManagement
файлаsettings.gradle
верхнего уровня:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
- В файле
build.gradle
на уровне модуля добавьте сервисы Google Play в качестве зависимости Maps SDK для Android:dependencies { // Maps SDK for Android implementation 'com.google.android.gms:play-services-maps:18.2.0' }
- В файле
build.gradle
на уровне модуля присвойтеcompileSdk
иminSdk
следующие значения:android { compileSdk 31 defaultConfig { minSdk 19 // ... }
Шаг 3. Добавьте ключ API в проект
В этом разделе рассказывается, как настроить безопасный вызов ключа API вашим приложением. Вводить ключ API в систему управления версиями нежелательно, поэтому мы рекомендуем хранить его в файле secrets.properties
, который находится в корневом каталоге проекта. Подробные сведения о файле secrets.properties
можно найти в описании файлов свойств Gradle.
Чтобы упростить работу, используйте плагин Secrets Gradle для Android.
Чтобы установить плагин Secrets Gradle для Android в проекте Google Карт:
-
В Android Studio откройте файл
build.gradle
уровня проекта и добавьте в элементdependencies
, принадлежащий элементуbuildscript
, указанный ниже код.Groovy
buildscript { dependencies { classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
Kotlin
buildscript { dependencies { classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
-
Open your module-level
build.gradle
file and add the following code to theplugins
element.Groovy
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- Save the file and sync your project with Gradle.
-
Open the
secrets.properties
in your project level directory, and then add the following code. ReplaceYOUR_API_KEY
with your API key.MAPS_API_KEY=YOUR_API_KEY