Configurare un progetto Xcode

Swift Package Manager

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

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-places-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 GooglePlaces, GooglePlacesSwift o entrambi vengano aggiunti al target principale designato. Al termine, fai clic su Add Package (Aggiungi pacchetto).

   Se stai aggiornando Google Places Swift dall'URL GitHub obsoleto

   Importante: l'URL GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui hai eseguito l'accesso tramite il vecchio URL, https://github.com/googlemaps/ios-places-swift-sdk, rimuovila dalla sezione delle dipendenze dei pacchetti di Xcode.

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 (Navigatore progetto) 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" (File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti).

   Se stai aggiornando Google Places Swift dall'URL GitHub obsoleto

   Importante: l'URL GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui hai eseguito l'accesso tramite il vecchio URL, https://github.com/googlemaps/ios-places-swift-sdk, rimuovila dalla sezione delle dipendenze dei pacchetti di Xcode.

2. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator per verificare il pacchetto e la relativa versione.

Per rimuovere Places SDK for iOS esistente installato manualmente, seguire 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 i seguenti framework:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Dalla directory di primo livello del progetto Xcode, rimuovi il GooglePlaces bundle.

Installazione manuale

Questa guida mostra come aggiungere manualmente gli XCFramework contenenti Places SDK for iOS e Places Swift 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 Apple Silicon. Puoi scegliere di aggiungere Places SDK for iOS, Places Swift SDK for iOS o entrambi.

1. Scarica i seguenti file binari e di risorse dell'SDK:
   • GooglePlaces
   • GooglePlacesResources
2. Se stai installando Places Swift SDK for iOS, installa i seguenti file:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Estrai i file per accedere a XCFramework e alle risorse.
4. Avvia Xcode e apri un progetto esistente o creane uno nuovo progetto. Se non hai molta esperienza con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
5. Rimuovi dal progetto eventuali bundle di Maps delle release precedenti.
6. Apri la scheda General (Generale). Trascina il seguente XCFramework nel progetto in Frameworks, Libraries, and Embedded Content. Assicurati di selezionare Do Not Embed:
   • GooglePlaces.xcframework
   Se stai installando Places Swift SDK, trascina il seguente XCFramework nel progetto in Frameworks, Libraries, and Embedded Content. Assicurati di selezionare Do Not Embed:
   • GooglePlacesSwift.xcframework
7. Copia GooglePlaces.bundle da GooglePlacesResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando richiesto, assicurati di selezionare Copy items into destination group's folder (Copia gli elementi nella cartella del gruppo di destinazione).
   
   Se stai installando Places Swift SDK, copia GooglePlacesSwift.bundle da GooglePlacesSwiftResources che hai scaricato nella directory di primo livello del progetto Xcode. Quando richiesto, assicurati di selezionare Copy items into destination group's folder (Copia gli elementi nella cartella del gruppo di destinazione).
8. Seleziona il progetto nel navigatore del progetto e scegli il target dell'applicazione.
9. Apri la scheda Build Phases (Fasi di build). In Link Binary with Libraries (Collega binario con librerie), aggiungi i seguenti framework e librerie:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. Scegli il progetto, anziché un target specifico, e apri la scheda Impostazioni di build. 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, cambia il filtro nella barra Build Settings (Impostazioni di build) da Basic (Di base) a All (Tutte).

CocoaPods

Places SDK for iOS e Places Swift SDK for iOS sono disponibili come CocoaPod, GooglePlaces e GooglePlacesSwift.

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 di CocoaPods.

sudo gem install cocoapods

Crea un Podfile per installare gli SDK e le relative dipendenze:

1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla macchina locale. Se non hai molta esperienza con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
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 specifica il nome del target dell'applicazione e i nomi dei pod GooglePlaces e GooglePlacesSwift:

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

   Assicurati di eseguire regolarmente pod outdated per rilevare quando è disponibile una versione più recente e assicurarti di avere sempre l'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. Verranno installate le API specificate nel Podfile, insieme a eventuali dipendenze they may have.

   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. Verrà eseguito l'aggiornamento di tutte le API specificate nel Podfile all'ultima versione.

GooglePlacesSwift

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

• Aggiungi la seguente istruzione di importazione:

  import GooglePlacesSwift

• Aggiungi quanto segue al metodo application(_:didFinishLaunchingWithOptions:), sostituendo YOUR_API_KEY con la tua chiave API:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

• Aggiungi la seguente istruzione di importazione:

  import GooglePlaces

• Aggiungi quanto segue al metodo application(_:didFinishLaunchingWithOptions:), sostituendo YOUR_API_KEY con la tua chiave API:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

• Aggiungi la seguente istruzione di importazione:

  @import GooglePlaces;

• Aggiungi quanto segue al metodo application:didFinishLaunchingWithOptions:, sostituendo YOUR_API_KEY con la tua chiave API:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];