Configurare un progetto Xcode

Dopo aver attivato la fatturazione e creato una chiave API, puoi configurare il progetto Xcode che utilizzi per sviluppare l'app.

Per ogni release sono disponibili note di rilascio.

Passaggio 1: installa il software necessario

Per creare un progetto utilizzando l'SDK Places per iOS, devi disporre di:

  • Xcode versione 15.0 o successive

Passaggio 2: crea il progetto Xcode e installa l'SDK Places per iOS

Swift Package Manager

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

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

  1. Apri Xcode project o workspace, quindi vai a File > Aggiungi dipendenze del pacchetto.
  2. Inserisci https://github.com/googlemaps/ios-places-sdk come URL, premi Invio per importare il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un version specifico, imposta il campo Regola di dipendenza su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli i prodotti del pacchetto, verifica che GooglePlaces, GooglePlacesSwift o entrambi vengano aggiunti al target principale designato. Al termine, fai clic su Aggiungi pacchetto.

    Se stai aggiornando Google Places Swift dall'URL GitHub deprecato

    Importante: l'URL di GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui è stato 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 Generale del target. In Framework, librerie e contenuti incorporati, dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione. Xcode mostra la versione di GitHub, che corrisponde alla versione di GooglePlaces (ad esempio 9.2.0), ma non alla versione di GooglePlacesSwift (ad esempio 0.3.0).

Per aggiornare il package di un progetto esistente:

  1. In Xcode, vai a "File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti".

    Se stai aggiornando Google Places Swift dall'URL GitHub deprecato

    Importante: l'URL di GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui è stato 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 Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

Per rimuovere l'SDK Places per iOS esistente installato manualmente: segui questi passaggi:

  1. Nelle impostazioni di configurazione del progetto Xcode, individua 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 bundle GooglePlaces.

Installazione manuale

Questa guida mostra come aggiungere manualmente gli XCFramework contenenti l'SDK Places per iOS e l'SDK Places Swift per iOS (anteprima) al progetto e configurare le impostazioni di compilazione in Xcode. Un XCFramework è un pacchetto binario che puoi utilizzare su più piattaforme, incluse le macchine che utilizzano Apple Silicon. Puoi scegliere di aggiungere l'SDK Places per iOS, l'SDK Places Swift per iOS (anteprima) o entrambi.

  1. Scarica i seguenti file di risorse e binari dell'SDK:
  2. Se stai installando l'SDK Places Swift per iOS (anteprima), installa i seguenti file:
  3. Estrai i file per accedere a XCFramework e alle risorse.
  4. Avvia Xcode e apri un progetto esistente o creane uno nuovo. 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 di release precedenti.
  6. Apri la scheda Generale. Trascina il seguente XCFramework nel progetto in Framework, librerie e contenuti incorporati. Assicurati di selezionare Non incorporare:
    • GooglePlaces.xcframework
    Se stai installando l'SDK Swift di Places per iOS (anteprima), trascina il seguente XCFramework nel progetto in Framework, librerie e contenuti incorporati. Assicurati di selezionare Non incorporare:
    • GooglePlacesSwift.xcframework
  7. Copia GooglePlaces.bundle da GooglePlacesResources che hai scaricato nella directory di primo livello del progetto Xcode. Assicurati di selezionare Copia gli elementi nella cartella del gruppo di destinazione quando richiesto.

    Se stai installando Places Swift SDK per iOS (anteprima), copia GooglePlacesSwift.bundle da GooglePlacesSwiftResources che hai scaricato nella directory di primo livello del progetto Xcode. Assicurati di selezionare Copia elementi nella cartella del gruppo di destinazione quando richiesto.
  8. Seleziona il progetto dal Navigatore progetti e scegli la destinazione dell'applicazione.
  9. Apri la scheda Fasi di compilazione. In Collega il file binario alle 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 compilazione. Nella sezione Linking - General -> Other Linker Flags, aggiungi -ObjC a "Debug" e "Release". Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni di compilazione da Base a Tutte.

CocoaPods

Places SDK for iOS e Places Swift SDK for iOS (anteprima) sono disponibili come pod CocoaPod, GooglePlaces e GooglePlacesSwift.

CocoaPods è un gestore delle dipendenze open source per progetti Cocoa in Swift e Objective-C. Se non hai già 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 tua 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 con le relative versioni. Ecco un esempio che specifica il nome target dell'applicazione e i nomi dei pod GooglePlaces e GooglePlacesSwift: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end
     Assicurati di eseguire regolarmente pod outdated per rilevare se è disponibile una versione più recente e assicurarti di avere sempre la versione più recente.
  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 file Podfile, insieme a eventuali dipendenze.

    pod install

  7. Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Da questo momento in poi, dovrai utilizzare 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 Podfile.
  2. Esegui il comando pod update. In questo modo, tutte le API specificate in Podfile verranno aggiornate alla versione più recente.

Passaggio 3: aggiungi la chiave API all'app

Negli esempi riportati di seguito, sostituisci YOUR_API_KEY con la tua chiave API.

Swift

Aggiungi la chiave API a AppDelegate.swift come segue:

  • 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 tua chiave API a AppDelegate.m come segue:

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

GooglePlacesSwift

Aggiungi la tua chiave API a AppDelegate.swift come segue:

  • 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")

(Facoltativo) Passaggio 4: controlla il file manifest della privacy di Apple

Apple richiede dettagli sulla privacy delle app per le app nell'App Store. Per aggiornamenti e ulteriori informazioni, visita la pagina Dettagli sulla privacy dell'App Store di Apple.

Il file manifest della privacy di Apple è incluso nel bundle di risorse per l'SDK. Per verificare che il file manifest della privacy sia stato incluso e per ispezionarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Passaggi successivi