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 release.
Passaggio 1: installa il software richiesto
Per creare un progetto utilizzando Places SDK for iOS, devi disporre di:
- Xcode versione 26.0 o successive
Passaggio 2: crea il progetto Xcode e installa Places SDK for iOS
Swift Package Manager
Places SDK for iOS può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso tutte le dipendenze esistenti di Places SDK for iOS.
Per aggiungere l'SDK a un progetto nuovo o esistente, segui questi passaggi:
-
Apri il tuo
projectoworkspaceXcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto). - Inserisci https://github.com/googlemaps/ios-places-sdk come URL, premi Invio per inserire il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
-
Per installare un
versionspecifico, 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 pacco". - Nella finestra Scegli i prodotti del pacchetto, verifica che
GooglePlaces,GooglePlacesSwifto 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 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. - Per verificare l'installazione, vai al riquadro Generali della destinazione. In Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati), dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione Package Dependencies (Dipendenze del pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.
Per aggiornare package per un progetto esistente, segui questi passaggi:
-
In Xcode, vai a File > Packages > Update To Latest Package Versions (File > Pacchetti > Aggiorna alle ultime versioni dei pacchetti).
Se stai aggiornando Google Places Swift dall'URL GitHub ritirato
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. - Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.
Per rimuovere l'SDK Places for iOS esistente installato manualmente, segui questi passaggi:
-
Nelle impostazioni di configurazione del progetto Xcode, individua Framework, librerie e contenuti incorporati. Utilizza il segno meno (-) per rimuovere i seguenti framework:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Dalla directory di primo livello del tuo progetto Xcode, rimuovi il bundle
GooglePlaces.
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 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.
- Scarica i seguenti file binari e di risorse dell'SDK:
- Se stai installando Places Swift SDK for iOS, installa i seguenti file:
- Estrai i file per accedere a XCFramework e alle risorse.
- Avvia Xcode e apri un progetto esistente o creane uno nuovo. Se non hai esperienza con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
- Rimuovi dal progetto eventuali bundle di Maps delle release precedenti.
-
Apri la scheda Generale. Trascina il seguente XCFramework nel tuo progetto in Framework, librerie e contenuti incorporati. Assicurati di selezionare Non incorporare:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Copia il file
GooglePlaces.bundleda 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 l'SDK Places Swift, copiaGooglePlacesSwift.bundleda GooglePlacesSwiftResources 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. - Seleziona il progetto da Project Navigator e scegli la destinazione dell'applicazione.
-
Apri la scheda Build Phases (Fasi di build). In Link Binary with
Libraries, aggiungi i seguenti framework e librerie:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Scegli il tuo progetto, anziché un target specifico, e apri la scheda Build Settings. Nella sezione Linking - General -> Other Linker Flags, aggiungi
-ObjCa "Debug" e "Release". Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni build da Base a Tutte.
Passaggio 3: aggiungi la chiave API alla tua app
Negli esempi riportati di seguito, sostituisci YOUR_API_KEY con la tua chiave API.
Aggiungi la chiave API al tuo 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")
Swift
Aggiungi la chiave API al tuo 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 chiave API al tuo 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"];
(Facoltativo) Passaggio 4: esamina il file manifest della privacy di Apple
Apple richiede i dettagli sulla privacy delle app per le app presenti 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
- Inizia a scrivere il codice. Un punto di partenza consigliato è l'implementazione di un'app di base che recuperi il luogo attuale dell'utente.
- Dopo aver configurato il progetto, puoi esplorare le app di esempio.
- Utilizza App Check per proteggere la tua chiave API.