Partecipa al nostro prossimo Google Maps Platform Developer Community Day a San Francisco a dicembre. Fai domanda ora per partecipare.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configurazione del progetto: versione 4.99 e precedenti

Questa guida elenca i requisiti di configurazione di compilazione per l'utilizzo di Navigation SDK for Android. Le istruzioni presuppongono che tu abbia installato un IDE Android e che tu abbia familiarità con lo sviluppo Android.

Requisiti minimi per l'utilizzo dell'SDK Navigation

Questi requisiti si applicano all'SDK Navigation per Android versione 4.99 e precedenti.

Console Google Cloud

con l'SDK Navigation abilitato. Per il provisioning, rivolgiti al tuo rappresentante di Google Maps Platform.
La tua app deve avere il livello API target 30 o versioni successive.
Per eseguire un'app creata con l'SDK di navigazione, sul dispositivo Android devono essere installati e attivati Google Play Services.
All'app devono essere aggiunti attribuzioni e testo di licenza.

Configura i tuoi progetti: progetto della console Cloud e progetto Android

Prima di poter creare o testare un'app, devi creare un progetto della console Cloud e aggiungere le credenziali della chiave API. Il progetto deve disporre del provisioning per accedere all'SDK Navigation. A tutte le chiavi all'interno del progetto della console Cloud viene concesso lo stesso accesso al Navigation SDK. A una chiave possono essere associati più progetti di sviluppo. Se hai già un progetto della console, puoi aggiungere una chiave al progetto corrente.

Per configurare

Nel tuo browser web preferito, accedi alla console Cloud e crea il tuo progetto della console Cloud.
Nel tuo IDE, ad esempio Android Studio, crea un progetto di sviluppo di app per Android e prendi nota del nome del pacchetto.
Contatta il tuo rappresentante di Google Maps Platform per fornire l'accesso all'SDK di navigazione per il tuo progetto della console Cloud.
Nella dashboard della console Cloud nel browser web, crea le credenziali per generare una chiave API con restrizioni.
Nella pagina della chiave API, fai clic su App per Android nell'area Restrizioni per le applicazioni.
Fai clic su Aggiungi il nome del pacchetto e l'impronta, quindi inserisci il nome del pacchetto del tuo progetto di sviluppo e l'impronta SHA-1 per la chiave.
Fai clic su Salva.

Aggiungi l'SDK Navigation al progetto

L'SDK Navigation è disponibile tramite Maven o come bundle AAR. Dopo aver creato il progetto di sviluppo, puoi integrare l'SDK utilizzando uno dei seguenti approcci.

Utilizza Maven per l'SDK Navigation v4.5 e versioni successive (consigliato)

Di seguito viene utilizzato il repository Maven google(), che è il modo più semplice e consigliato per aggiungere l'SDK Navigation al tuo progetto

Aggiungi la seguente dipendenza alla configurazione Gradle o Maven, sostituendo il segnaposto VERSION_NUMBER con la versione dell'SDK Navigation per Android.

Gradle

Aggiungi quanto segue al file build.gradle a livello di modulo:

dependencies {
...
implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER'
}

Se esegui l'upgrade dal repository Maven originale, tieni presente che i nomi dei gruppi e degli artefatti sono cambiati e il plug-in com.google.cloud.artifactregistry.gradle-plugin non è più necessario.

Aggiungi quanto segue al file build.gradle di primo livello:

allprojects {
...
// Required: you must exclude the Google Play service Maps SDK from
// your transitive dependencies to make nsure there won't be
// multiple copies of Google Maps SDK in your binary, as the Navigation
// SDK already bundles the Google Maps SDK.
configurations {
       implementation {
           exclude group: 'com.google.android.gms', module: 'play-services-maps'
       }
}
}

Maven

Aggiungi quanto segue a pom.xml:

<dependencies>
...
<dependency>
     <groupId>com.google.android.libraries.navigation</groupId>
     <artifactId>navigation</artifactId>
     <version>VERSION_NUMBER</version>
</dependency>
</dependencies>

Se hai dipendenze che utilizzano Maps SDK, devi escludere la dipendenza in ogni dipendenza dichiarata che si basa su Maps SDK.

<dependencies>
<dependency>
<groupId>project.that.brings.in.maps</groupId>
<artifactId>MapsConsumer</artifactId>
<version>1.0</version>
     <exclusions>
       <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
       <exclusion>  <!-- declare the exclusion here -->
         <groupId>com.google.android.gms</groupId>
         <artifactId>play-services-maps</artifactId>
       </exclusion>
     </exclusions>
</dependency>
</dependencies>

Utilizza Maven per l'SDK Navigation precedente alla versione 4.5 o con l'SDK Driver

L'SDK Navigation continua a essere disponibile utilizzando il repository Maven originale per il resto delle versioni v4. Si tratta della stessa libreria con tutti gli stessi aggiornamenti della versione precedente e offre la compatibilità con l'SDK Driver e altre librerie durante la transizione. Per utilizzare questa dipendenza, devi accedere al tuo progetto cloud utilizzando gcloud durante la compilazione.

Configura l'ambiente per accedere al repository Maven di Google come descritto nella sezione Prerequisiti della documentazione dell'SDK Consumer. L'accesso all'SDK Navigation è controllato tramite un gruppo di Workspace.

Aggiungi la seguente dipendenza alla configurazione Gradle o Maven, sostituendo il segnaposto VERSION_NUMBER con la versione dell'SDK Navigation.

Gradle

Aggiungi quanto segue al file build.gradle a livello di modulo:

dependencies {
...
implementation 'com.google.android.maps:navsdk:VERSION_NUMBER'
}

Aggiungi quanto segue al file build.gradle di primo livello:

allprojects {
...
// Required: you must exclude the Google Play service Maps SDK from
// your transitive dependencies to make sure there won't be
// multiple copies of Google Maps SDK in your binary, as the Navigation
// SDK already bundles the Google Maps SDK.
configurations {
        implementation {
            exclude group: 'com.google.android.gms', module: 'play-services-maps'
        }
}
}

Maven

Aggiungi quanto segue a pom.xml:

<dependencies>
...
<dependency>
     <groupId>com.google.android.maps</groupId>
     <artifactId>navsdk</artifactId>
     <version>VERSION_NUMBER</version>
</dependency>
</dependencies>

Se hai dipendenze che utilizzano Maps SDK, devi escludere la dipendenza in ogni dipendenza dichiarata che si basa su Maps SDK.

<dependencies>
<dependency>
<groupId>project.that.brings.in.maps</groupId>
<artifactId>MapsConsumer</artifactId>
<version>1.0</version>
     <exclusions>
       <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
       <exclusion>  <!-- declare the exclusion here -->
         <groupId>com.google.android.gms</groupId>
         <artifactId>play-services-maps</artifactId>
       </exclusion>
     </exclusions>
</dependency>
</dependencies>

Utilizza un bundle AAR scaricato (opzione non consigliata)

L'SDK Navigation è disponibile anche come bundle AAR. Dopo aver creato il progetto di sviluppo, puoi integrare l'SDK. Queste istruzioni presuppongono l'utilizzo di Android Studio per l'IDE.

Scarica l'ultima versione dell'SDK di navigazione da Google Drive condiviso ed estraila. Se non hai accesso, contatta il tuo rappresentante.
In Android Studio, apri un progetto e aggiungi il pacchetto Google Play Services utilizzando SDK Manager.
Dalla directory del file ZIP, copia libs/google_navigation_navmap.aar nella directory app/libs del progetto.

Aggiungi quanto segue al file build.gradle a livello di modulo:

implementation(name: 'google_navigation_navmap', ext: 'aar')

Aggiungi quanto segue al file build.gradle di primo livello:

allprojects {
   ...
   // Required: you must exclude the Google Play service Maps SDK from
   // your transitive dependencies to make sure there won't be
   // multiple copies of Google Maps SDK in your binary, as the Navigation
   // SDK already bundles the Google Maps SDK.
   configurations {
       implementation {
           exclude group: 'com.google.android.gms', module: 'play-services-maps'
       }
   }
}

Configura la build

Dopo aver creato il progetto, puoi configurare le impostazioni per una corretta creazione e un utilizzo ottimale di Navigation SDK.

Aggiorna le proprietà locali

Nella cartella Gradle Scripts, apri il file local.properties e aggiungi android.useDeprecatedNdk=true.

Aggiorna lo script di build Gradle

Apri il file build.gradle (Module:app) e utilizza le seguenti linee guida per aggiornare le impostazioni in modo da soddisfare i requisiti di Navigation SDK e valuta anche la possibilità di impostare le opzioni di ottimizzazione.

Impostazioni obbligatorie per l'SDK Navigation
1. Imposta minSdkVersion su 23 o un valore superiore.
2. Imposta targetSdkVersion su 30 o un valore superiore.
3. Aggiungi un'impostazione dexOptions che aumenta il valore di javaMaxHeapSize.
4. Imposta la posizione delle raccolte aggiuntive.
5. Aggiungi repositories e dependencies per l'SDK Navigation.
6. Sostituisci i numeri di versione nelle dipendenze con le ultime versioni disponibili.
Impostazioni facoltative per ridurre i tempi di build
- Attiva la riduzione del codice e delle risorse utilizzando R8/ProGuard per rimuovere il codice e le risorse non utilizzati dalle dipendenze. Se il passaggio R8/ProGuard richiede troppo tempo, valuta la possibilità di attivare la configurazione multidex per il lavoro di sviluppo.
- Riduci il numero di traduzioni linguistiche incluse nella build: imposta resConfigs per una lingua durante lo sviluppo. Per la build finale, imposta resConfigs per le lingue che utilizzi effettivamente. Per impostazione predefinita, Gradle include stringhe di risorse per tutte le lingue supportate dal Navigation SDK.

Di seguito è riportato un esempio dello script di build Gradle per l'applicazione. Controlla le app di esempio per i set di dipendenze aggiornati, poiché la versione dell'SDK di navigazione che utilizzi potrebbe essere leggermente precedente o successiva a questa documentazione.

apply plugin: 'com.android.application'
apply plugin: 'com.google.cloud.artifactregistry.gradle-plugin'

ext {
    androidxVersion = "1.0.0"
    lifecycle_version = "1.1.1"
}

android {
    compileSdkVersion 30
    buildToolsVersion '28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
        // Set this to the languages you actually use, otherwise you'll include resource strings
        // for all languages supported by the Navigation SDK.
        resConfigs "en"
        multiDexEnabled true
    }

    dexOptions {
        // This increases the amount of memory available to the dexer. This is required to build
        // apps using the Navigation SDK.
        javaMaxHeapSize "4g"
    }
    buildTypes {
        // Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
        // The configuration is included transitively by depending on the Navigation SDK.
        // If the ProGuard step takes too long, consider enabling multidex for development work
        // instead.
        all {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

// This tells Gradle where to look to find additional libraries - in this case, the
// google_navigation_navmap.aar file.
repositories {
    flatDir {
        dirs 'libs'
    }
    google()

    // Required for accessing the Navigation SDK on Google's Maven repository.
    maven {
        url "artifactregistry://us-west2-maven.pkg.dev/gmp-artifacts/transportation"
    }
}

dependencies {
    // Include the Google Navigation SDK
    implementation 'com.google.android.maps:navsdk:4.4.0'

    // The included AAR file under libs can be used instead of the Maven repository.
    // Uncomment the line below and comment out the previous dependency to use
    // the AAR file instead. Make sure that you add the AAR file to the libs directory.
    // implementation(name: 'google_navigation_navmap', ext: 'aar')

    // These dependencies are required for the Navigation SDK to function
    // properly at runtime.
    implementation 'org.chromium.net:cronet-fallback:69.3497.100'
    // Optional for Cronet users:
    // implementation 'org.chromium.net:cronet-api:69.3497.100'
    implementation 'androidx.appcompat:appcompat:${androidxVersion}'
    implementation 'androidx.cardview:cardview:${androidxVersion}'
    implementation 'com.google.android.material:material:${androidxVersion}'
    implementation 'androidx.mediarouter:mediarouter:${androidxVersion}'
    implementation 'androidx.preference:preference:${androidxVersion}'
    implementation 'androidx.recyclerview:recyclerview:${androidxVersion}'
    implementation 'androidx.legacy:legacy-support-v4:${androidxVersion}'
    implementation 'com.github.bumptech.glide:glide:4.9.0'
    implementation 'com.github.bumptech.glide:okhttp-integration:4.9.0'
    implementation 'android.arch.lifecycle:common-java8:$lifecycle_version'
    implementation 'com.android.support:multidex:1.0.3'
    implementation 'com.google.android.datatransport:transport-api:2.2.0'
    implementation 'com.google.android.datatransport:transport-backend-cct:2.2.0'
    implementation 'com.google.android.datatransport:transport-runtime:2.2.0'
    implementation 'joda-time:joda-time:2.9.9'
    annotationProcessor 'androidx.annotation:annotation:1.1.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
}

Aggiungi la chiave API all'app

Questa sezione descrive come archiviare la chiave API in modo che l'app possa farvi riferimento in modo sicuro. Non devi inserire la chiave API nel sistema di controllo della versione, quindi ti consigliamo di archiviarla in un file secrets.properties nella directory root del progetto ed escludere il file dal controllo della versione. Per ulteriori informazioni sui file delle proprietà di Gradle, consulta File delle proprietà di Gradle.

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

Per installare il plug-in Secrets Gradle per Android e archiviare la chiave API:

In Android Studio, apri il file build.gradle.kts o build.gradle di primo livello e aggiungi il seguente codice al blocco plugins.

Kotlin

plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") version "2.0.1" apply false
}

Groovy

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

Apri il file build.gradle.kts o build.gradle a livello di modulo e aggiungi il seguente codice all'elemento plugins.

Kotlin

plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}

Groovy

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

Se utilizzi Android Studio, sincronizza il progetto con Gradle.
Apri il file secrets.properties nella directory di primo livello, quindi aggiungi il codice seguente. Sostituisci YOUR_API_KEY con la tua chiave API. Assicurati di aggiungere secrets.properties al file .gitignore (o di escluderlo in altro modo dal sistema di controllo della versione) in modo da non inserire la chiave API nel controllo della versione.
Nota: se il file secrets.properties non esiste, crealo nella stessa cartella del file local.properties.
```
MAPS_API_KEY=YOUR_API_KEY
```
Crea il file local.defaults.properties nella directory di primo livello, la stessa cartella del file secrets.properties, quindi aggiungi il codice seguente.

Nota: inserisci il codice come mostrato. Non sostituire DEFAULT_API_KEY con la tua chiave API.
```
MAPS_API_KEY=DEFAULT_API_KEY
```
Lo scopo di questo file è fornire una posizione di backup per la chiave API se il file secrets.properties non viene trovato, in modo che le build non abbiano esito negativo. Questo può accadere se cloni l'app da un sistema di controllo della versione che omette secrets.properties e non hai ancora creato un file secrets.properties localmente per fornire la tua chiave API.
Puoi aggiungere la chiave API al file AndroidManifest.xml o fornirla in modo programmatico.
- Aggiungi la tua chiave API a AndroidManifest.xml:
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
        
```
  Nota: com.google.android.geo.API_KEY è il nome dei metadati consigliato per la chiave API. Una chiave con questo nome può essere utilizzata per l'autenticazione in più API basate su Google Maps sulla piattaforma Android, incluso l'SDK Navigation per Android. Per la compatibilità con le versioni precedenti, l'API supporta anche il nome com.google.android.maps.v2.API_KEY. Questo nome legacy consente l'autenticazione solo per l'API di Google Maps per Android v2. Un'applicazione può specificare solo uno dei nomi dei metadati della chiave API. Se vengono specificati entrambi, l'API genera un'eccezione.
- Fornisci la chiave API in modo programmatico:
  Il plug-in Secrets Gradle rende disponibile la chiave nella classe BuildConfig. Nell'inizializzazione dell'app (ad esempio nel metodo Application.onCreate()), chiama il metodo come segue:
  Kotlin
  1. Aggiungi le seguenti istruzioni di importazione:
    import com.google.android.libraries.navigation.NavigationApi
  2. Aggiungi quanto segue al metodo Application.onCreate():
    NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY)
  Java
  1. Aggiungi le seguenti istruzioni di importazione:
    import com.google.android.libraries.navigation.NavigationApi;
  2. Aggiungi quanto segue al metodo Application.onCreate():
    NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY);
  Nota: quando utilizzi setApiKey(), tieni presente quanto segue:
  - Fornisci una chiave API non null e non vuota.
  - Chiama setApiKey() una sola volta durante il ciclo di vita dell'applicazione. Il metodo genera un IllegalStateException se viene chiamato più di una volta.
  - Chiama setApiKey() prima di inizializzare qualsiasi altro componente dell'SDK Navigation, ad esempio Navigator.
  - La chiave fornita con questo metodo sostituisce qualsiasi chiave API nel tuo AndroidManifest.xml.
  - Utilizza l'SDK Navigation versione 7.6 o successive.

In Android Studio, apri il file build.gradle.kts o build.gradle a livello di modulo e modifica la proprietà secrets. Se la proprietà secrets non esiste, aggiungila.

Modifica le proprietà del plug-in per impostare propertiesFileName su "secrets.properties", defaultPropertiesFileName su "local.defaults.properties" e qualsiasi altra proprietà.

Kotlin

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

Groovy

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

Includi le attribuzioni richieste nella tua app

Se utilizzi l'SDK di navigazione per Android nella tua app, devi includere il testo dell'attribuzione e le licenze open source nella sezione delle note legali dell'app.

Puoi trovare il testo dell'attribuzione richiesto e le licenze open source nel file ZIP dell'SDK Navigation per Android:

NOTICE.txt
LICENSES.txt

Configurazione del progetto: versione 4.99 e precedenti Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Requisiti minimi per l'utilizzo dell'SDK Navigation

Configura i tuoi progetti: progetto della console Cloud e progetto Android

Aggiungi l'SDK Navigation al progetto

Utilizza Maven per l'SDK Navigation v4.5 e versioni successive (consigliato)

Gradle

Maven

Utilizza Maven per l'SDK Navigation precedente alla versione 4.5 o con l'SDK Driver

Gradle

Maven

Utilizza un bundle AAR scaricato (opzione non consigliata)

Configura la build

Aggiorna le proprietà locali

Aggiorna lo script di build Gradle

Aggiungi la chiave API all'app

Kotlin

Groovy

Kotlin

Groovy

Kotlin

Java

Kotlin

Groovy

Includi le attribuzioni richieste nella tua app

Configurazione del progetto: versione 4.99 e precedenti