Configurare un progetto Xcode

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

Le note di rilascio sono disponibili per ogni versione.

Passaggio 1: installa il software richiesto

Per creare un progetto utilizzando Places SDK for iOS, devi:

  • Xcode versione 16.0 o successive

Passaggio 2: crea il progetto Xcode e installa Places SDK 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 esistenti dell'SDK Places per iOS.

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

  1. Apri Xcode project o workspace, poi vai a File > Add Package Dependencies (File > Aggiungi dipendenze 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 l'ultima versione e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli 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 ritirato

    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 dei pacchetti di Xcode.

  5. Per verificare l'installazione, vai al riquadro Generale della destinazione. 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.

Per aggiornare il package di un progetto esistente:

  1. In 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 ritirato

    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 dei pacchetti di Xcode.

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

Per rimuovere Places SDK for iOS esistente installato manualmente, segui questi passaggi:

  1. Nelle impostazioni di configurazione del progetto Xcode, trova 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 al tuo progetto gli XCFrameworks contenenti Places SDK per iOS e Places Swift SDK per iOS 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 per iOS, Places Swift SDK per iOS o entrambi.

  1. Scarica i seguenti file binari e di risorse dell'SDK:
  2. Se stai installando Places Swift SDK per iOS, 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 hai poca 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 Generale. Trascina il seguente XCFramework nel progetto in Framework, librerie e contenuti incorporati. Assicurati di selezionare Non incorporare:
    • GooglePlaces.xcframework
    Se stai installando Places Swift SDK, 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 tuo progetto Xcode. Assicurati di selezionare Copia gli elementi nella cartella del gruppo di destinazione quando richiesto.

    Se stai installando Places Swift SDK, copia GooglePlacesSwift.bundle da GooglePlacesSwiftResources che hai scaricato nella directory di primo livello del tuo progetto Xcode. Quando richiesto, assicurati di selezionare Copia elementi nella cartella del gruppo di destinazione.
  8. Seleziona il progetto dal navigatore del progetto e scegli la destinazione dell'applicazione.
  9. Apri la scheda Fasi di creazione. In Link Binary with Libraries, 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 build. 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 build da Base a Tutti.

CocoaPods

Places SDK per iOS e Places Swift SDK per iOS sono disponibili come pod CocoaPod GooglePlaces e GooglePlacesSwift.

CocoaPods è un gestore di dipendenze open source per progetti Swift e Objective-C Cocoa. Se non hai ancora 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 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 hai poca 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 Podfile e aggiungi le dipendenze insieme alle relative versioni. Ecco un esempio che specifica il nome di destinazione 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.1.0'
  pod 'GooglePlacesSwift', '10.1.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 Podfile.

  5. Apri un terminale e vai alla directory contenente Podfile:

    cd <path-to-project>

  6. Esegui il comando pod install. Verranno installate le API specificate in Podfile, insieme a eventuali dipendenze che potrebbero avere.

    pod install

  7. Chiudi Xcode e poi 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 per un progetto esistente:

  1. Apri un terminale e vai alla directory del progetto contenente Podfile.
  2. Esegui il comando pod update. Verranno aggiornate tutte le API specificate in Podfile all'ultima versione.

Passaggio 3: aggiungi la chiave API alla tua app

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

GooglePlacesSwift

Aggiungi la chiave API al tuo 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 al tuo AppDelegate.swift nel seguente modo:

  • Aggiungi la seguente istruzione di importazione: 
    import GooglePlaces
  • Aggiungi quanto segue al tuo metodo application(_:didFinishLaunchingWithOptions:), sostituendo YOUR_API_KEY con la tua chiave API: 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Aggiungi la chiave API al tuo 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"];

Passaggio 4 (facoltativo): esamina il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app nell'App Store. Visita la pagina dei dettagli sulla privacy dell'App Store di Apple per aggiornamenti e ulteriori informazioni.

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 esaminarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Passaggi successivi