Konfigurowanie projektu na Androida Studio

Z tego artykułu dowiesz się, jak skonfigurować projekt Android Studio pod kątem użycia pakietu SDK Map Google na Androida bez korzystania z szablonu Map Google opisanego w krótkim wprowadzeniu.

Szablon Map Google automatycznie konfiguruje mapę podstawową i dodaje ją do nowego projektu Android Studio. Możesz też dodać mapę do projektu na Androida, który korzysta z innego szablonu Android Studio. Aby to zrobić, musisz ręcznie skonfigurować projekt, a następnie dodać mapę.

Krok 1. Skonfiguruj Android Studio

  1. Wymagane jest Android Studio Arctic Fox lub nowsza wersja. Pobierz i zainstaluj aplikację, jeśli jeszcze jej nie masz.
  2. Upewnij się, że używasz wtyczki Androida do obsługi Gradle w Android Studio w wersji 7.0 lub nowszej.

Krok 2. Skonfiguruj pakiet SDK

Biblioteka Maps SDK na Androida jest dostępna w repozytorium Google Maven. Aby dodać pakiet SDK do aplikacji, wykonaj te czynności:

  1. W pliku settings.gradle najwyższego poziomu umieść w bloku pluginManagement portal wtyczek Gradle, repozytorium Google Maven i centralne repozytorium Maven. Blok pluginManagement musi występować przed innymi instrukcjami w skrypcie. 
    pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
  2. W pliku settings.gradle najwyższego poziomu umieść w bloku dependencyResolutionManagement repozytorium Google Maven i centralne repozytorium Maven:
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
  3. W pliku build.gradle na poziomie modułu dodaj zależność Usług Google Play do pakietu SDK Map Google na Androida. 
    dependencies {

    // Maps SDK for Android
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
}
  4. W pliku build.gradle na poziomie modułu ustaw compileSdk i minSdk na te wartości: 
    android {
    compileSdk 31

    defaultConfig {
        minSdk 19
        // ...
    }

Krok 3. Dodaj do projektu klucz interfejsu API

W tej sekcji dowiesz się, jak zapisać klucz interfejsu API, aby aplikacja mogła się do niego bezpiecznie odwoływać. Nie sprawdzaj klucza interfejsu API w systemie kontroli wersji, więc zalecamy zapisanie go w pliku secrets.properties, który znajduje się w katalogu głównym Twojego projektu. Więcej informacji o pliku secrets.properties znajdziesz w artykule o plikach właściwości Gradle.

Aby usprawnić to zadanie, zalecamy korzystanie z wtyczki do obsługi obiektów tajnych w Gradle na Androida.

Aby zainstalować wtyczkę do obiektów tajnych do Gradle na Androida w projekcie Map Google:

  1. W Android Studio otwórz plik build.gradle na poziomie projektu i dodaj do elementu dependencies w sekcji buildscript podany niżej kod.

    Zakręcony

    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")
    }
}
  2. Open your module-level build.gradle file and add the following code to the plugins element.

    Groovy

    plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

    Kotlin

    plugins {
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}
  3. Save the file and sync your project with Gradle.
  4. Open the secrets.properties in your project level directory, and then add the following code. Replace YOUR_API_KEY with your API key. 
    MAPS_API_KEY=YOUR_API_KEY