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 Navigation

Swift Package Manager

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

Per aggiungere l'SDK a un progetto nuovo o esistente:

  1. Apri il project o workspace di Xcode, 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 recuperare il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
  3. Per installare una version specifica, imposta il campo Dependency Rule su una delle le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare l'ultima versione e di utilizzare l'opzione "Exact Version" (Versione esatta). Al termine, fai clic su "Add Package" (Aggiungi pacchetto).

Per aggiornare il package di un progetto esistente:

  1. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator (Navigatore del 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, trova Frameworks, Libraries, and Embedded Content (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 GoogleMaps bundle.

Installazione manuale

Questa guida mostra come aggiungere manualmente gli XCFramework contenenti l'SDK Navigation per iOS e l'SDK Maps per iOS al progetto 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 binari e di risorse dell'SDK:
  2. Avvia Xcode e apri un progetto esistente o creane uno nuovo progetto. Se non hai mai utilizzato iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
  3. Rimuovi tutti i riferimenti esistenti a Maps, Navigation e Places dal progetto.
  4. Trascina i seguenti XCFramework nel progetto in Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) per installare sia l'SDK Maps sia l'SDK Navigation (quando richiesto, seleziona Copy items if needed (Copia gli elementi se necessario)):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Trascina GoogleMaps.bundle da GoogleMapsResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando richiesto, assicurati che l'opzione Copy items if needed (Copia gli elementi se necessario) sia selezionata.
  6. Trascina GoogleNavigation.bundle da GoogleNavigationResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando richiesto, assicurati che l'opzione Copy items into destination group's folder (Copia gli elementi nella cartella del gruppo di destinazione) sia selezionata.
  7. Seleziona il progetto dal navigatore del progetto e scegli il tuo target dell'applicazione.
  8. Apri la scheda Build Phases e, all'interno di Link Binary with Libraries, 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. Nel target dell'applicazione, seleziona la scheda Capabilities (Funzionalità), attiva Background Modes (Modalità in background) e abilita le seguenti modalità:
    • Audio, AirPlay, and Picture in Picture (Audio, AirPlay e Picture in picture)
    • Location updates (Aggiornamenti della posizione)
  10. Scegli il progetto, anziché un target specifico, e apri la scheda Build Settings (Impostazioni di build). Nella sezione Other Linker Flags (Altre flag del linker), aggiungi ‑ObjC sia per debug sia per release. Se queste impostazioni non sono visibili, modifica il filtro nella Build Settings (Impostazioni di build) da Basic (Di base) a All (Tutte).
  11. Apri Info.plist e aggiungi le seguenti coppie chiave-valore:
    • Chiave: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Valore: "Questa app ha bisogno dell'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 ha bisogno dell'autorizzazione per utilizzare la tua posizione per la navigazione passo passo."

CocoaPods

L'SDK Navigation per iOS è disponibile come CocoaPods pod. CocoaPods è un gestore di dipendenze open source per i progetti Cocoa Swift e Objective-C

Se non hai ancora lo strumento CocoaPods, installalo su macOS eseguendo il seguente comando dal terminale. Per maggiori dettagli, consulta la guida introduttiva a CocoaPods.

sudo gem install cocoapods

Crea un Podfile per l'SDK Navigation per iOS e utilizza lo per installare l'API e le relative dipendenze:

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo su il computer locale. Se non hai mai sviluppato per iOS:
    1. Crea un nuovo progetto.
    2. Seleziona il modello iOS > App.
    3. Nella schermata delle opzioni del progetto:
      1. Inserisci il nome del progetto.
      2. Registra il valore del campo Identificatore pacchetto. Puoi utilizzare questo valore per limitare la chiave API di seguito.
      3. Imposta l'interfaccia del progetto su Storyboard.
      4. Imposta la lingua su Swift o Objective-C.
  2. Crea un file denominato Podfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
  3. Modifica il Podfile e aggiungi le dipendenze insieme alle relative versioni. Ecco un esempio che include la dipendenza necessaria per l'SDK Navigation per iOS: # Cocoapods install reference # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.10.0'
end
    Assicurati di eseguire regolarmente pod outdated per rilevare le versioni più recenti. Se necessario, esegui l'upgrade all'ultima versione.
  4. Salva il Podfile.

  5. Apri un terminale e vai alla directory contenente il Podfile:

    cd <path-to-project>

  6. Esegui il comando pod install. Vengono installate le API specificate nel Podfile, insieme a eventuali dipendenze.

    pod install

  7. Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Da questo momento in poi, devi utilizzare il file .xcworkspace per aprire il progetto.

Per aggiornare l'API di un progetto esistente:

  1. Apri un terminale e vai alla directory del progetto contenente il Podfile.
  2. Esegui il comando pod update. Vengono aggiornate tutte le API specificate nel Podfile all'ultima versione.

Passaggio 3: aggiungi la chiave API al progetto

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

Swift

Aggiungi la chiave API a 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 a 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 nell'App Store. Visita la pagina 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 dell'app e genera un report sulla privacy dall'archivio.

Se sei un cliente di Mobility Services

Se sei un cliente di Mobility Services, scopri di più sulla fatturazione nella documentazione di Mobility. Per ulteriori informazioni sulla registrazione delle transazioni, consulta Configurare la fatturazione. Per scoprire come aggiungere gli ID transazione all'implementazione dell'SDK Navigation, consulta Associare 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 maggiori dettagli, consulta: