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 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.
2. Inserisci https://github.com/googlemaps/ios-navigation-sdk come URL, premi Invio per recuperare il pacchetto e fai clic su "Add Package".
3. Per installare uno specifico version, imposta il campo Dependency Rule su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare l'ultima versione e di utilizzare l'opzione "Exact Version". Al termine, fai clic su "Add Package".
4. Nella finestra Choose Package Products, verifica che GoogleNavigation venga aggiunto al target main designato. Al termine, fai clic su "Add Package".
5. Per verificare l'installazione, vai al riquadro General del target. In Frameworks, Libraries, and Embedded Content dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" di "Project Navigator" per verificare il pacchetto e la relativa versione.

Per aggiornare il package di un progetto esistente:

1. Da Xcode, vai a File > Packages > Update To Latest Package Versions.
2. Per verificare l'installazione, vai alla sezione Package Dependencies di Project Navigator per verificare il pacchetto e la relativa versione.

1. Nelle impostazioni di configurazione del progetto Xcode, trova Frameworks, Libraries, and Embedded Content. 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 che contengono l' SDK Navigation per iOS e Maps SDK for iOS al tuo 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 Maps SDK for iOS:

1. Scarica i seguenti file binari e di risorse dell'SDK:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Avvia Xcode e apri un progetto esistente o creane uno nuovo progetto. Se non hai familiarità con 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 per installare sia Maps che Navigation SDK (quando richiesto, seleziona Copy items if needed):
   • 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 Copy items if needed.
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 Copy items into destination group's folder.
7. Seleziona il progetto dal navigatore del progetto e scegli il tuo target dell'applicazione.
8. Apri la scheda Build Phases e, in 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, attiva Background Modes e abilita le seguenti modalità:
   • Audio, AirPlay, and Picture in Picture
   • Location updates
10. Scegli il progetto, anziché un target specifico, e apri la scheda Build Settings. Nella sezione Other Linker Flags , aggiungi ‑ObjC sia per debug che per release. Se queste impostazioni non sono visibili, cambia il filtro nella Build Settings bar da Basic a All.
11. Apri Info.plist e aggiungi le seguenti coppie chiave-valore:
    • Chiave: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Valore: "Questa app necessita 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 necessita dell'autorizzazione per utilizzare la tua posizione per la navigazione passo passo."

Swift

Aggiungi la chiave API a AppDelegate.swift nel seguente modo:

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 nel seguente modo:

1. Aggiungi le seguenti istruzioni di importazione:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Aggiungi quanto segue al metodo application:didFinishLaunchingWithOptions::

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];