Questa pagina descrive come configurare la libreria di utilità per Maps SDK for iOS.
Per provare queste utilità, puoi:
- Installare la libreria di utilità in un progetto Xcode esistente. Aggiungere queste utilità al tuo progetto.
- Installare ed eseguire l'app demo. L'app demo è un progetto autonomo che contiene tutto il codice necessario per provare le utilità.
Aggiungere la libreria di utilità di Maps SDK for iOS a un progetto Xcode
Segui questi passaggi per aggiungere la libreria di utilità al tuo workspace Xcode:
Utilizzare Swift Package Manager
- Se non hai ancora un progetto Xcode, creane uno ora e salvalo sul computer locale. Se non hai familiarità con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS template. Su Xcode 11.7 o versioni precedenti, crea un'applicazione a visualizzazione singola.
- Aggiungi Maps SDK for iOS come dipendenza. Per le opzioni, consulta Installare l'SDK.
- Nel progetto Xcode, vai a File -> Swift Packages -> Add Package Dependency (File > Pacchetti Swift > Aggiungi dipendenza pacchetto).
- Nella finestra visualizzata, inserisci l'URL del repository della libreria di utilità di Maps SDK for iOS
https://github.com/googlemaps/google-maps-ios-utilse seleziona Avanti. - A questo punto, potrebbe esserti chiesto di autenticarti con il tuo account GitHub. Segui le istruzioni per creare un token di accesso personale GitHub per continuare la procedura.
- Nella finestra successiva, seleziona l'opzione radio Versione, seleziona Fino alla prossima versione principale dall'elenco a discesa e inserisci l'ultima versione della libreria di utilità di Maps SDK for iOS (ad esempio "6.0.0").
- Fai clic sul menu a discesa accanto a Aggiungi al progetto, seleziona il tuo progetto e poi Aggiungi pacchetto.
Aggiungere la chiave API all'app
Per istruzioni su come generare una chiave API e aggiungerla al progetto Xcode, consulta Configurare un progetto Xcode.Creare ed eseguire il progetto
Dopo aver aggiunto la chiave API, crea ed esegui il progetto.
Utilizzare un'utilità nell'app
Per saperne di più su come utilizzare ogni utilità nella tua app, consulta la documentazione relativa:
Installare ed eseguire l'app demo
La libreria di utilità include un'app demo che puoi installare e poi provare ogni utilità.
Installa l'app demo:Utilizzare i file di GitHub
- Scarica
l'archivio dell'esempio di codice da
GitHub
ed estrailo. In alternativa, clona il repository in una directory locale:
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- Apri una finestra del terminale, vai alla directory in cui hai espanso i file di esempio e
approfondisci la directory degli esempi appropriata per la lingua che vuoi utilizzare:
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj
Aggiungere la chiave API all'app demo
In Ottenere una chiave API, generi una chiave API per la tua app. Ora aggiungi questa chiave al progetto Xcode per l'app demo. , consulta Ottenere una chiave API.Swift
Aggiungi la chiave API a AppDelegate.swift nel seguente modo:
- Aggiungi la seguente istruzione di importazione:
import GoogleMaps
- Modifica la riga seguente per aggiungere la chiave API tra le virgolette doppie:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Aggiungi la chiave API a AppDelegate.m nel seguente modo:
- Aggiungi la seguente istruzione di importazione:
@import GoogleMaps;
- Modifica la riga seguente per aggiungere la chiave API tra le virgolette doppie:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Creare ed eseguire l'app demo
Dopo aver aggiunto la chiave API, crea ed esegui il progetto:
- Se esegui la versione Swift della demo, puoi selezionare l'utilità da visualizzare nell'app.
- Se esegui la versione Objective-C della demo, vedrai la demo dell' utilità di clustering dei marker. Puoi quindi modificare la versione Objective-C della demo per provare ogni utilità. Per saperne di più, consulta la sezione Aggiungere un'utilità all'app di seguito.