Configurazione e demo

Seleziona piattaforma: Android iOS

Questa pagina descrive come configurare la libreria di utilità per l'SDK Maps per iOS.

Per provare queste utilità, puoi:

Facoltativamente, installa CocoaPods

La libreria di utilità è disponibile come pod CocoaPods Google-Maps-iOS-Utils. CocoaPods è un gestore open source di dipendenze per i progetti Swift e Objective-C Cocoa.

Se non hai ancora lo strumento CocoaPods, installalo su macOS eseguendo il comando seguente dal terminale:

sudo gem install cocoapods

Per maggiori dettagli, consulta la Guida introduttiva a CocoaPods.

Installa ed esegui l'app demo

La libreria di utilità include un'app demo che puoi installare e che puoi provare per ogni utilità.

Installa l'app demo utilizzando uno di questi due metodi:

Usa file da GitHub

  1. Scarica l'archivio di esempio del 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 (fai doppio clic) sul file .xcworkspace del progetto per avviare Xcode. Da questo momento, 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

    Scegli Swift o Objective-C quando richiesto. CocoaPods aggiorna i repository delle specifiche, quindi apre la demo in un progetto Xcode temporaneo denominato SwiftDemoApp.xcodeproj o ObjCDemoApp.xcodeproj.

Aggiungere la chiave API all'app demo

In Ottieni una chiave API, generi una chiave API per la tua app. Ora, aggiungi questa chiave al progetto Xcode per l'app demo.

Swift

Aggiungi la chiave API a AppDelegate.swift come segue:

  1. Aggiungi la seguente istruzione di importazione: 
    import GoogleMaps
  2. Modifica la riga seguente 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 chiave API a AppDelegate.m come segue:

  1. Aggiungi la seguente istruzione di importazione: 
    @import GoogleMaps;
  2. Modifica la riga seguente 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 stai eseguendo la versione Objective-C della demo, vedrai la demo dell'utilità di clustering dell'indicatore. Puoi quindi modificare la versione Objective-C della demo per provare ciascuna utilità. Per ulteriori informazioni, consulta la sezione Aggiungere un'utilità all'app di seguito.

Installa la libreria di utilità come progetto Xcode

Segui questi passaggi per aggiungere la libreria di utilità all'area di lavoro Xcode:

Utilizzare CocoaPods

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. (Se non hai mai utilizzato lo sviluppo iOS, crea un'applicazione di visualizzazione singola.)
  2. Se non disponi già di un file pod per il progetto, crea un file denominato Podfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
  3. Modifica il file del pod del tuo progetto e aggiungi una dipendenza dal pod Google-Maps-iOS-Utils. Ecco un esempio che include le dipendenze necessarie per l'SDK Maps per 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 (fai doppio clic) sul file .xcworkspace del progetto per avviare Xcode. Da questo momento, devi utilizzare il file .xcworkspace per aprire il progetto.

Nota: l'utilità di clustering degli indicatori dipende dal quadtree, ma puoi utilizzare il quadtree senza clustering 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. Installare 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 ora e salvalo sulla tua macchina locale. Se sei più recente nello sviluppo iOS, crea un nuovo progetto e seleziona il modello di app per iOS. In Xcode 11.7 o versioni precedenti, crea un'applicazione di visualizzazione singola.
  3. Crea un file denominato Cartfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
  4. Modifica il campo Cartfile e aggiungi la dipendenza Libreria Maps SDK for iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Salva il 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, insieme 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 tuo 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
    I clienti del piano Premium devono includere anche GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework.
  10. Fai clic con il tasto 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 al tuo progetto. Quando richiesto, assicurati che l'opzione Copia elementi nella cartella del gruppo di destinazione non sia selezionata.
  12. Seleziona il progetto nel navigatore dei progetti e scegli la destinazione dell'applicazione.
  13. Apri la scheda Fasi della build per la destinazione della tua applicazione e, in Collega binaria con 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 progetto, anziché un target specifico, e apri la scheda Impostazioni build. Nella sezione Altri flag del linker, aggiungi -ObjC. Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni build da Di base a Tutte.

Utilizza Swift Package Manager

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se è la prima volta che sviluppi iOS, crea un nuovo progetto e seleziona il modello di app per iOS. Su Xcode 11.7 o versioni precedenti, crea un'applicazione di visualizzazione singola.
  2. Aggiungi l'SDK Maps per iOS come dipendenza. Per ulteriori opzioni, consulta la pagina Installazione dell'SDK.
  3. Nel progetto Xcode, vai a File -> Swift Packages -> Add Package Dependency.
  4. Nella finestra presentata, inserisci l'URL del repository della libreria di strumenti Maps SDK for iOS https://github.com/googlemaps/google-maps-ios-utils e seleziona Avanti.
    • A questo punto, ti potrebbe essere chiesto di eseguire l'autenticazione con il tuo account GitHub. Segui le istruzioni per creare un token di accesso personale GitHub per continuare il processo.
  5. Nella finestra successiva, seleziona l'opzione Versione, seleziona Esatta dall'elenco a discesa, inserisci la versione più recente di Maps SDK for iOS Utility Library (ad es. "3.4.0") e seleziona Avanti.

Aggiungi la chiave API alla tua app

Consulta Configurare un progetto Xcode per istruzioni sulla generazione di una chiave API e sull'aggiunta al 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 saperne di più sull'utilizzo nella tua app, consulta la documentazione su ogni utilità: