Configurare un progetto Xcode

Swift Package Manager

Maps SDK for iOS può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze di Maps SDK for iOS esistenti.

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

1. Apri il project o workspace Xcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
2. Inserisci https://github.com/googlemaps/ios-maps-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 la versione più recente e di utilizzare l'opzione "Exact Version" (Versione esatta). Al termine, fai clic su "Add Package" (Aggiungi pacchetto).
4. Nella finestra Choose Package Products (Scegli prodotti pacchetto), verifica che GoogleMaps (per le versioni precedenti alla 9.0.0, verifica che GoogleMaps, GoogleMapsBase, e GoogleMapsCore) venga aggiunto al target main designato. Al termine, fai clic su "Add Package" (Aggiungi pacchetto).
5. Per verificare l'installazione, vai al riquadro General (Generale) del target. In Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" (Dipendenze pacchetto) di "Project Navigator" per verificare il pacchetto e la relativa versione.

Per aggiornare il package di un progetto esistente:

1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le seguenti dipendenze: GoogleMapsBase, GoogleMapsCore, e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per ulteriori informazioni, consulta le note di rilascio della versione 9.0.0.

   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:

   • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
2. In Xcode, vai a File > Packages > Update To Latest Package Versions (File > Pacchetti > Esegui l'aggiornamento alle versioni più recenti dei pacchetti).
3. 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 le dipendenze di Maps SDK for iOS esistenti aggiunte utilizzando CocoaPods:

1. Chiudi l'area di lavoro Xcode. Apri il terminale ed esegui il seguente comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Rimuovi Podfile, Podfile.resolved e Xcode workspace se non li utilizzi per altro oltre a CocoaPods.

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
   • GoogleMapsBase (solo per le installazioni precedenti alla versione 9.2.0)
   • GoogleMapsCore (solo per le installazioni precedenti alla versione 9.2.0)
   • GoogleMapsM4B (solo per le installazioni precedenti alla versione 9.0.0)
2. Dalla directory di primo livello del progetto Xcode, rimuovi il GoogleMaps bundle.

Installazione manuale

Questa guida descrive come aggiungere manualmente gli XCFramework contenenti Maps SDK for iOS al tuo progetto e configurare le impostazioni di build in Xcode. Un XCFramework è un pacchetto binario che utilizzi su più piattaforme, inclusi i computer che utilizzano Apple Silicon.

1. Scarica i seguenti file binari e di risorse dell'SDK:
   • GoogleMaps
   • GoogleMapsResources
2. Estrai i file per accedere agli XCFramework e alle risorse.
3. Se non hai ancora un progetto Xcode, creane uno ora e salvalo su il computer locale. Se non hai familiarità con lo 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 Bundle identifier (Identificatore del bundle). 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.
4. Apri la scheda General (Generale). Trascina i seguenti XCFramework nel progetto sotto Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati). Assicurati di selezionare Do Not Embed (Non incorporare):
   • GoogleMaps.xcframework
5. Copia GoogleMaps.bundle da GoogleMapsResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando ti viene richiesto, assicurati di selezionare Copy items into destination group's folder (Copia gli elementi nella cartella del gruppo di destinazione).
6. Seleziona il progetto nel navigatore del progetto e scegli il tuo target dell'applicazione.
7. Apri la scheda Build Phases (Fasi di build) per il target dell'applicazione. In Link Binary with Libraries (Collega binario con librerie), aggiungi i seguenti framework e librerie:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (solo se utilizzi OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Scegli il progetto, anziché un target specifico, e apri la scheda Build Settings. Nella sezione Linking - General -> Other Linker Flags (Collegamento - Generale - > Altri flag del linker), aggiungi -ObjC a "Debug" e "Release" (Rilascio). Se queste impostazioni non sono visibili, modifica il filtro nella barra Build Settings (Impostazioni di build) da Basic (Di base) a All (Tutti).

9. Per installare l'XCFramework di Places SDK for iOS, consulta la pagina Guida introduttiva a Places SDK for iOS.

Swift

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

1. Aggiungi la seguente istruzione di importazione:

   import GoogleMaps

2. Aggiungi quanto segue al metodo application(_:didFinishLaunchingWithOptions:), utilizzando la tua chiave API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Se utilizzi anche l'API Places, aggiungi di nuovo la chiave come mostrato qui:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. Aggiungi la seguente istruzione di importazione:

   @import GoogleMaps;

2. Aggiungi quanto segue al metodo application:didFinishLaunchingWithOptions:, utilizzando la tua chiave API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Se utilizzi anche l'API Places, aggiungi di nuovo la chiave come mostrato qui:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];