In questa pagina viene descritto come configurare la libreria di utilità per Maps SDK for iOS.
Per provare queste utilità, puoi:
- Installa ed esegui l'app demo. L'app demo è un progetto autonomo che contiene tutto il codice necessario per provare le utilità.
- Installa la libreria dell'utilità in un progetto Xcode esistente. Aggiungi queste utilità al tuo progetto.
Installa CocoaPods facoltativamente
La libreria di utilità è disponibile come pod CocoaPods denominato
Google-Maps-iOS-Utils
. CocoaPods è un gestore delle dipendenze open source per i progetti Cocoa Swift e Objective-C.
Se non hai ancora lo strumento CocoaPods, installalo su macOS eseguendo questo comando dal terminale:
sudo gem install cocoapods
Per informazioni dettagliate, consulta la Guida introduttiva di CocoaPods.
Installa ed esegui l'app demo
che include un'app demo in cui puoi installare e provare ogni utilità.
Installa l'app demo utilizzando uno di questi due metodi:Usa file da GitHub
- Scarica l'archivio di esempio di codice da GitHub e decomprimi l'archivio.
- Apri una finestra del terminale, vai alla directory in cui hai espanso i file di esempio e
visualizza in dettaglio la directory di esempio appropriata per la lingua che vuoi utilizzare:
- Per Swift, esegui
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- Per l'obiettivo C, esegui
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- Per Swift, esegui
- Esegui questo comando:
pod install
- Chiudi Xcode, quindi apri (doppio clic) il file
.xcworkspace
del tuo progetto per avviare Xcode. Da questo momento in poi, devi utilizzare il file.xcworkspace
per aprire il progetto.
Usa CocoaPods v1.6.1
- Apri una finestra del terminale e installa la versione 1.6.1:
sudo gem install cocoapods -v1.6.1
- Recupera i file di Google Maps utilizzando Cocoapods:
pod try Google-Maps-iOS-Utils
Quando ti viene richiesto, scegli Swift o Objective-C. CocoaPods aggiorna i repository di specifiche, quindi apre la demo in un progetto Xcode temporaneo denominato
SwiftDemoApp.xcodeproj
oObjCDemoApp.xcodeproj
.
Aggiungi la chiave API all'app demo
In Ottieni una chiave API, generi una chiave API per la tua app. Ora aggiungi la chiave al progetto Xcode per l'app demo.Swift
Aggiungi la tua chiave API a AppDelegate.swift
come segue:
- Aggiungi la seguente istruzione di importazione:
import GoogleMaps
- Modifica la seguente riga per aggiungere la chiave API tra virgolette doppie:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Aggiungi la tua chiave API a AppDelegate.m
come segue:
- Aggiungi la seguente istruzione di importazione:
@import GoogleMaps;
- Modifica la seguente riga per aggiungere la chiave API tra virgolette doppie:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Crea ed esegui 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, guarda la demo dell'utilità di clustering degli indicatori. Puoi quindi modificare la versione Objective-C della demo per provare ogni utilità. Per ulteriori informazioni, consulta la sezione Aggiungere un'utilità all'app che segue.
Installa la libreria di utilità come progetto Xcode
Segui questi passaggi per aggiungere la libreria di utilità all'area di lavoro di Xcode:
Utilizzare CocoaPods
- Se non hai ancora un progetto Xcode, creane uno e salvalo nella tua macchina locale. Se non hai mai utilizzato lo sviluppo per iOS, crea un'applicazione Single View.
- Se non hai ancora un file pod per il tuo progetto, crea un file denominato
Podfile
nella directory del progetto. Questo file definisce le dipendenze del progetto. - Modifica il file dei pod del progetto e aggiungi una dipendenza al pod
Google-Maps-iOS-Utils
. Ecco un esempio che include le dipendenze necessarie per Maps SDK for iOS e la libreria di utilità:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.2.2' end
- Esegui
pod install
. - Chiudi Xcode, quindi apri (doppio clic) il file
.xcworkspace
del tuo progetto per avviare Xcode. Da questo momento in poi, devi utilizzare il file.xcworkspace
per aprire il progetto.
Nota: l'utilità di raggruppamento degli indicatori dipende dal riquadro, ma puoi utilizzarlo senza cluster degli indicatori. Se vuoi
solo l'utilità quadtree, puoi modificare
pod 'Google-Maps-iOS-Utils'
in
'Google-Maps-iOS-Utils/QuadTree'
nel file del pod.
Usa Cartagine
- Installa Cartagine. Esistono diversi metodi, quindi consulta il file README di Cartagine per i passaggi esatti.
- Se non hai ancora un progetto Xcode, creane uno e salvalo nella tua macchina locale. Se non hai mai utilizzato lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS. In Xcode 11.7 o versioni precedenti, crea un'applicazione Single View.
- Crea un file denominato
Cartfile
nella directory del progetto. Questo file definisce le dipendenze del progetto. - Modifica
Cartfile
e aggiungi la dipendenza dalla libreria di utilità di Maps SDK for iOS:
github "googlemaps/google-maps-ios-utils"
- Salva
Cartfile
. - In una finestra del terminale, vai alla directory contenente
Cartfile
:
cd <path-to-project>
- Esegui il comando di aggiornamento:
carthage update --platform iOS
Verranno installate le API specificate inCartfile
, oltre alle eventuali dipendenze. - Nel Finder, nella directory del progetto, vai ai file del framework scaricati in
Carthage/Build/iOS
. - Aggiungi i framework di Maps SDK for iOS al progetto trascinando i seguenti bundle nel progetto.
Quando richiesto, seleziona Copia elementi se necessario, utilizza la stessa versione indicata sopra.
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
- Fai clic con il pulsante destro del mouse su
GoogleMaps.framework
nel progetto e seleziona Mostra nel Finder. - Trascina
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
dalla cartellaResources
nel progetto. Quando richiesto, assicurati che l'opzione Copia elementi nella cartella del gruppo di destinazione non sia selezionata. - Seleziona il progetto dal Navigatore progetti e scegli il target dell'applicazione.
- Apri la scheda Fasi di creazione per la destinazione dell'applicazione e, in Collega file binario alle librerie, aggiungi i seguenti framework:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Scegli il tuo progetto anziché una destinazione specifica e apri la scheda Impostazioni build. Nella sezione Altri flag linker, aggiungi
-ObjC
. Se queste impostazioni non sono visibili, cambia il filtro nella barra Impostazioni build da Di base a Tutti.
Utilizzare il gestore di pacchetti Swift
- Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai mai eseguito lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS. Su Xcode 11.7 o versioni precedenti, crea un'applicazione Single View.
- Aggiungi Maps SDK for iOS come dipendenza. Consulta la pagina relativa all'installazione dell'SDK per conoscere le opzioni a tua disposizione.
- Nel progetto Xcode, vai a 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-utils
e seleziona Avanti. - A questo punto, è possibile che ti venga 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 di opzione Versione, seleziona Esatta dall'elenco a discesa, inserisci la versione più recente della libreria di utilità di Maps SDK for iOS (ad esempio "3.4.0") e seleziona Avanti.
Aggiungi la chiave API all'app
Consulta Configurazione di un progetto Xcode per istruzioni su come generare una chiave API e aggiungerla al tuo progetto Xcode.Crea ed esegui il progetto
Dopo aver aggiunto la chiave API, crea ed esegui il progetto.
Aggiungi un'utilità alla tua app
Per ulteriori informazioni sull'utilizzo di ciascuna utilità nella tua app, consulta la documentazione: