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 esistenti di Places SDK for iOS.

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 estrarre 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 deprecato

   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 del pacchetto 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 deprecato

   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 del pacchetto 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 il GooglePlaces.bundle da GooglePlacesResources 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).
   
   Se stai installando Places Swift SDK, copia il file GooglePlacesSwift.bundle da GooglePlacesSwiftResources 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).
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 (Tutti).

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