Configurazione e demo

Seleziona la piattaforma: Android iOS

In questa pagina viene descritto come configurare la libreria di utilità per Maps SDK for iOS.

Per provare queste utilità, puoi:

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

  1. Scarica l'archivio di esempio di codice da GitHub e decomprimi l'archivio.
  2. 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
  3. Esegui questo comando:
    pod install
  4. 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

  1. Apri una finestra del terminale e installa la versione 1.6.1:
    sudo gem install cocoapods -v1.6.1
  2. 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 o ObjCDemoApp.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:

  1. Aggiungi la seguente istruzione di importazione:
    import GoogleMaps
  2. 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:

  1. Aggiungi la seguente istruzione di importazione:
    @import GoogleMaps;
  2. 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

  1. 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.
  2. 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.
  3. 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
  4. Esegui pod install.
  5. 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

  1. Installa Cartagine. Esistono diversi metodi, quindi consulta il file README di Cartagine per i passaggi esatti.
  2. 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.
  3. Crea un file denominato Cartfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
  4. Modifica Cartfile e aggiungi la dipendenza dalla libreria di utilità di Maps SDK for iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Salva Cartfile.
  6. In una finestra del terminale, vai alla directory contenente Cartfile:
    cd <path-to-project>
  7. Esegui il comando di aggiornamento:
    carthage update --platform iOS

    Verranno installate le API specificate in Cartfile, oltre alle eventuali dipendenze.
  8. Nel Finder, nella directory del progetto, vai ai file del framework scaricati in Carthage/Build/iOS.
  9. 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
  10. Fai clic con il pulsante destro del mouse su GoogleMaps.framework nel progetto e seleziona Mostra nel Finder.
  11. Trascina Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle dalla cartella Resources nel progetto. Quando richiesto, assicurati che l'opzione Copia elementi nella cartella del gruppo di destinazione non sia selezionata.
  12. Seleziona il progetto dal Navigatore progetti e scegli il target dell'applicazione.
  13. 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
  14. 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

  1. 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.
  2. Aggiungi Maps SDK for iOS come dipendenza. Consulta la pagina relativa all'installazione dell'SDK per conoscere le opzioni a tua disposizione.
  3. Nel progetto Xcode, vai a File -> Pacchetti Swift -> Aggiungi dipendenza pacchetto.
  4. 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.
  5. 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: