Configurare un progetto Android Studio

In questa pagina viene descritto come configurare un progetto Android Studio per l'utilizzo dell'SDK Maps per Android senza utilizzare il modello di Google Maps, descritto in dettaglio nella Guida rapida.

Il modello di Google Maps configura e aggiunge automaticamente una mappa di base a un nuovo progetto Android Studio. Tuttavia, puoi anche aggiungere una mappa a un progetto Android che utilizza un modello Android Studio diverso. Per farlo, devi configurare manualmente il progetto e poi aggiungere la mappa.

Passaggio 1: configura Android Studio

  1. È richiesto Android Studio Arctic Fox o versioni successive. Se non l'hai ancora fatto, scaricala e installala.
  2. Assicurati di utilizzare il plug-in Android per Gradle 7.0 o versioni successive in Android Studio.

Passaggio 2: Configurare l'SDK

La libreria di Maps SDK per Android è disponibile tramite il Repository Maven di Google. Per aggiungere l'SDK alla tua app:

  1. Nel file settings.gradle di primo livello, includi il portale del plug-in Gradle, il repository Maven di Google e il repository centrale Maven nel blocco pluginManagement. Il blocco pluginManagement deve apparire prima di qualsiasi altra istruzione nello script.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. Nel file settings.gradle di primo livello, includi il Repository Maven di Google e il repository centrale Maven nel blocco dependencyResolutionManagement:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. Nel file build.gradle a livello di modulo, aggiungi la dipendenza Google Play Services per Maps SDK for Android.
    dependencies {
    
        // Maps SDK for Android
        implementation 'com.google.android.gms:play-services-maps:18.2.0'
    } 
  4. Nel file build.gradle a livello di modulo, imposta compileSdk e minSdk sui seguenti valori:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 19
            // ...
        }

Passaggio 3: aggiungi la chiave API al progetto

Questa sezione descrive come memorizzare la chiave API in modo che la tua applicazione possa fare riferimento in modo sicuro. Non controllare la chiave API nel sistema di controllo della versione, pertanto ti consigliamo di memorizzarla nel file secrets.properties, che si trova nella directory principale del progetto. Per ulteriori informazioni sul file secrets.properties, consulta File delle proprietà Gradle.

Per semplificare questa operazione, ti consigliamo di utilizzare il plug-in Secrets Gradle per Android.

Per installare il plug-in Secrets Gradle per Android nel tuo progetto Google Maps:

  1. In Android Studio, apri il file build.gradle a livello di progetto e aggiungi il seguente codice all'elemento dependencies in buildscript.

    Trendy

    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