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
- È richiesto Android Studio Arctic Fox o versioni successive. Se non l'hai ancora fatto, scaricala e installala.
- 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:
- 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 bloccopluginManagement
. Il bloccopluginManagement
deve apparire prima di qualsiasi altra istruzione nello script.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Nel file
settings.gradle
di primo livello, includi il Repository Maven di Google e il repository centrale Maven nel bloccodependencyResolutionManagement
:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
- 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' }
- Nel file
build.gradle
a livello di modulo, impostacompileSdk
eminSdk
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:
-
In Android Studio, apri il file
build.gradle
a livello di progetto e aggiungi il seguente codice all'elementodependencies
inbuildscript
.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") } }
-
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