Configurare un progetto Xcode

Dopo aver abilitato la fatturazione e creato una chiave API, puoi configurare il progetto Xcode che utilizzi per sviluppare la tua app.

Le note di rilascio sono disponibili per ogni release.

Passaggio 1: installa il software richiesto

Per creare un progetto utilizzando l'SDK Navigation per iOS, devi scaricare e installare:

  • Xcode versione 26.0 o successive

Passaggio 2: crea il progetto Xcode e installa l'SDK di navigazione

Swift Package Manager

L'SDK di navigazione può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze dell'SDK Navigation esistenti.

Per aggiungere l'SDK a un progetto nuovo o esistente, segui questi passaggi:

  1. Apri il tuo Xcode project o workspace, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
  2. Inserisci https://github.com/googlemaps/ios-navigation-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
  3. Per installare un version specifico, imposta il campo Regola di dipendenza su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare l'ultima versione e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli i prodotti del pacchetto, verifica che GoogleNavigation verrà aggiunto al target main designato. Al termine, fai clic su "Aggiungi pacchetto".
  5. Per verificare l'installazione, vai al riquadro Generale della destinazione. Nella sezione Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" (Dipendenze del pacchetto) di "Project Navigator" (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Per aggiornare package per un progetto esistente, segui questi passaggi:

  1. In Xcode, vai a File > Packages > Update To Latest Package Versions (File > Pacchetti > Aggiorna alle ultime versioni dei pacchetti).
  2. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze del pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Per rimuovere l'SDK Navigation per iOS esistente installato manualmente, segui questi passaggi:
  1. Nelle impostazioni di configurazione del progetto Xcode, individua Framework, librerie e contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. Dalla directory di primo livello del progetto Xcode, rimuovi il bundle GoogleMaps.

Installazione manuale

Questa guida mostra come aggiungere manualmente al progetto gli XCFramework contenenti l'SDK Navigation per iOS e l'SDK Maps per iOS e come configurare le impostazioni di build in Xcode. Un XCFramework è un pacchetto binario che puoi utilizzare su più piattaforme, incluse le macchine che utilizzano il chipset M1

Segui questi passaggi per installare gli XCFramework per l'SDK Navigation per iOS e l'SDK Maps per iOS:

  1. Scarica i seguenti file di risorse e binari dell'SDK:
  2. Avvia Xcode e apri un progetto esistente o creane uno nuovo. Se non hai mai utilizzato iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
  3. Rimuovi dal progetto tutti i riferimenti esistenti a Maps, Navigation e Places.
  4. Trascina i seguenti XCFramework nel progetto in Framework, librerie e contenuti incorporati per installare sia l'SDK Maps sia l'SDK Navigation (quando richiesto, seleziona Copia elementi se necessario):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Trascina GoogleMaps.bundle da GoogleMapsResources che hai scaricato nella directory di primo livello del tuo progetto Xcode. Quando richiesto, assicurati che l'opzione Copia elementi se necessario sia selezionata.
  6. Trascina GoogleNavigation.bundle da GoogleNavigationResources che hai scaricato nella directory di primo livello del tuo progetto Xcode. Quando richiesto, assicurati che l'opzione Copia gli elementi nella cartella del gruppo di destinazione sia selezionata.
  7. Seleziona il progetto da Project Navigator e scegli la destinazione dell'applicazione.
  8. Apri la scheda Build Phases (Fasi di creazione) e, in Link Binary with Libraries (Collega file binari con librerie), aggiungi i seguenti framework e librerie:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. Nella destinazione dell'applicazione, seleziona la scheda Capabilities, attiva Background Modes e abilita le seguenti modalità:
    • Audio, AirPlay e Picture in picture
    • Aggiornamenti della posizione
  10. Scegli il tuo progetto, anziché un target specifico, e apri la scheda Build Settings. Nella sezione Other Linker Flags (Altri flag del linker), aggiungi ‑ObjC sia per debug che per release. Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni build da Base a Tutte.
  11. Apri Info.plist e aggiungi le seguenti coppie chiave-valore:
    • Chiave: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Valore: "Questa app richiede l'autorizzazione per utilizzare la tua posizione per la navigazione passo passo."
    • Chiave: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Valore: "Questa app richiede l'autorizzazione per utilizzare la tua posizione per la navigazione passo passo."

Passaggio 3: aggiungi la chiave API al progetto

I seguenti esempi mostrano come aggiungere la chiave API al tuo progetto in Xcode:

Swift

Aggiungi la chiave API al tuo AppDelegate.swift come segue:

  1. Aggiungi le seguenti istruzioni di importazione: 
    import GoogleMaps
import GoogleNavigation
  2. Aggiungi quanto segue al metodo application(_:didFinishLaunchingWithOptions:): 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

Aggiungi la chiave API al tuo AppDelegate.m come segue:

  1. Aggiungi le seguenti istruzioni di importazione: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. Aggiungi quanto segue al metodo application:didFinishLaunchingWithOptions:: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Passaggio 4 (facoltativo): esamina il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app per le app presenti nell'App Store. Visita la pagina dei dettagli sulla privacy dell'App Store di Apple per aggiornamenti e ulteriori informazioni.

Il file manifest della privacy di Apple è incluso nel bundle di risorse per l'SDK. Per verificare che il file manifest della privacy sia stato incluso e per esaminarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Se sei un cliente di Mobility Services

Se sei un cliente di Mobility Services, consulta la documentazione di Mobility per informazioni sulla fatturazione. Per saperne di più sulla registrazione delle transazioni, consulta Configura la fatturazione. Per scoprire come aggiungere gli ID transazione all'implementazione dell'SDK Navigation, consulta Associa l'utilizzo del servizio alle transazioni di Mobility.

Passaggi successivi

Ora che hai una chiave API e un progetto Xcode, puoi creare ed eseguire app. L'SDK Navigation per iOS fornisce tutorial che possono aiutarti a iniziare. Per ulteriori dettagli, vedi: