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 dei pacchetti).
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).

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 > Aggiorna alle versioni più recenti dei pacchetti).
3. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze dei pacchetti) 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 l' 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 come configurare le impostazioni di build in Xcode. Un XCFramework è un pacchetto binario che utilizzi su più piattaforme, incluse le macchine 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 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.
4. Apri la scheda 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 dal navigatore del progetto e scegli il 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". Se queste impostazioni non sono visibili, cambia il filtro nella barra Build Settings (Impostazioni di build) da Basic (Di base) a All (Tutti).

9. Per installare Places SDK for iOS XCFramework, consulta la guida introduttiva a Places SDK for iOS.

CocoaPods

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

Se non hai 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 Maps SDK for 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 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 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 il Maps SDK for iOS:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '10.14.0'
   end

   Esegui pod outdated regolarmente per rilevare quando esiste una versione più recente e assicurarti di utilizzare sempre l'ultima versione. 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 they have.

   pod install

7. Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. D'ora in poi, utilizza 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 il Podfile.
2. Esegui il comando pod update. Vengono aggiornate tutte le API specificate nel Podfile all'ultima versione.

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