Configurare un progetto Xcode

Swift Package Manager

L'SDK Navigation 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:

1. Apri Xcode project o workspace, quindi vai a File > Aggiungi dipendenze del pacchetto.
2. Inserisci https://github.com/googlemaps/ios-navigation-sdk come URL, premi Invio per importare il pacchetto e fai clic su "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 la versione più recente e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".

Per aggiornare il package di un progetto esistente:

1. Per verificare l'installazione, vai alla sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

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 compilazione in Xcode. Un XCFramework è un pacchetto binario che puoi utilizzare su più piattaforme, incluse le macchine che utilizzano il chipset M1

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:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
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 a Maps, Navigazione e Luoghi esistenti.
4. Trascina i seguenti XCFrameworks nel progetto in Frameworks, librerie e contenuti incorporati per installare sia gli SDK Maps sia quelli di navigazione (se 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 progetto Xcode. Quando richiesto, assicurati che sia selezionata l'opzione Copia elementi se necessario.
6. Trascina GoogleNavigation.bundle da GoogleNavigationResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando richiesto, assicurati che sia selezionata l'opzione Copia elementi nella cartella del gruppo di destinazione.
7. Seleziona il progetto dal Navigatore progetti e scegli la destinazione della tua applicazione.
8. Apri la scheda Fasi di compilazione e in Collega binario con librerie aggiungi i seguenti framework e librerie:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.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
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. Nel target dell'applicazione, seleziona la scheda Funzionalità, attiva Modalità in background e le seguenti modalità:
   • Audio, AirPlay e Picture in picture
   • Aggiornamenti sulla posizione
10. Scegli il progetto anziché un target specifico e apri la scheda Impostazioni compilazione. Nella sezione Altri flag del linker, aggiungi ‑ObjC sia per debug che per release. Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni di compilazione da Base a Tutte.
11. Apri Info.plist e aggiungi le seguenti coppie chiave-valore:
    • Chiave: NSLocationWhenInUseUsageDescription (Privacy - Descrizione dell'utilizzo della posizione quando in uso)
      Valore: "Questa app ha bisogno dell'autorizzazione per usare la tua posizione per la navigazione passo passo."
    • Chiave: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Descrizione dell'utilizzo della posizione sempre e quando in uso)
      Valore: "Questa app ha bisogno dell'autorizzazione per usare la tua posizione per la navigazione passo passo."

CocoaPods

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

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

sudo gem install cocoapods

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

1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai esperienza nello sviluppo 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 tua chiave API di seguito.
      3. Imposta l'interfaccia del progetto su Storyboard.
      4. Imposta 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 con le relative versioni. Ecco un esempio che include la dipendenza necessaria per l'SDK Navigation per iOS: # Riferimento all'installazione di CocoaPods #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '9.2.0'
   end
           

   Assicurati di eseguire regolarmente pod outdated per rilevare le versioni più recenti. Se necessario, esegui l'upgrade alla versione più recente.
4. Salva il Podfile.

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

   cd <path-to-project>

6. Esegui il comando pod install. Verranno installate le API specificate nel file 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, dovrai utilizzare il file .xcworkspace per aprire il progetto.

Per aggiornare l'API per un progetto esistente:

1. Apri un terminale e vai alla directory del progetto contenente Podfile.
2. Esegui il comando pod update. In questo modo, tutte le API specificate in Podfile vengono aggiornate all'ultima versione.

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"];