Configurazione e demo

Seleziona la piattaforma: Android iOS

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

Per provare queste utilità, puoi:

Aggiungi la libreria di utilità di Maps SDK for iOS a un progetto Xcode

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

Utilizzare Swift Package Manager

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai familiarità con lo sviluppo per iOS, crea un nuovo progetto e seleziona l'app per iOS modello. Su Xcode 11.7 o versioni precedenti, crea un'applicazione a visualizzazione singola.
  2. Aggiungi Maps SDK for iOS come dipendenza. Consulta Installa l'SDK per visualizzare le opzioni.
  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 ti potrebbe essere chiesto di autenticarti con il tuo account GitHub. Segui le istruzioni per creare GitHub token di accesso personale per continuare la procedura.
  5. Nella finestra successiva, seleziona l'opzione di opzione Version (Versione) e scegli Up to Next Major Version. dall'elenco a discesa e inserisci la versione più recente della libreria di utilità di Maps SDK for iOS (ad esempio "6.0.0").
  6. Fai clic sul menu a discesa accanto ad Aggiungi al progetto, seleziona il progetto e seleziona Aggiungi pacchetto.

Utilizza CocoaPods

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo della macchina locale. Se non hai esperienza di sviluppo iOS, crea un Single Visualizza applicazione.)
  2. Se non hai ancora un file del pod per il tuo progetto, crea un file denominato Podfile nella directory del progetto. Questo file definisce delle dipendenze del progetto.
  3. Modifica il file del pod del progetto e aggiungi una dipendenza Google-Maps-iOS-Utils pod. Ecco un che include le dipendenze necessarie Maps SDK for iOS e la libreria di utilità:
    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '9.0.0'
      pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
    end
  4. Esegui pod install.
  5. Chiudi Xcode, quindi apri (doppio clic) la sezione .xcworkspace per avviare Xcode. D'ora in poi, devi usare il file .xcworkspace per aprire il progetto.

Nota: l'utilità di clustering degli indicatori dipende dalla quadtree, ma puoi utilizzarla senza clustering di indicatori. Se vuoi solo l'utilità quadtree, puoi modificare Da pod 'Google-Maps-iOS-Utils' a 'Google-Maps-iOS-Utils/QuadTree' nel file del pod.

Aggiungi la chiave API all'app

Consulta Configurare un progetto Xcode per istruzioni sulla generazione una chiave API e aggiungerla al progetto Xcode.

Crea ed esegui il progetto

Dopo aver aggiunto la chiave API, crea ed esegui il progetto.

Utilizzare un'utilità nell'app

Per ulteriori informazioni sull'utilizzo nell'app di ciascuna utilità, consulta la documentazione:

Installa ed esegui l'app demo

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

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

Usa i file di GitHub

  1. Scarica l'archivio degli esempi di codice GitHub e apri l'archivio.
  2. Apri una finestra del terminale, passa alla directory in cui hai espanso i file di esempio e visualizza in dettaglio la directory di esempio appropriata per il linguaggio che vuoi utilizzare:
    • Per Swift, corri cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • Per Objective-C, esegui cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. Esegui questo comando:
    pod install
  4. Chiudi Xcode, quindi apri (doppio clic) la sezione .xcworkspace per avviare Xcode. D'ora in poi, devi usare il file .xcworkspace per aprire il progetto.

Uso di 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 richiesto, scegli Swift o Objective-C. CocoaPods aggiorna i repository delle tue specifiche, 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 l'app. Ora aggiungi quella chiave al progetto Xcode per l'app demo.

Swift

Aggiungi la chiave API a AppDelegate.swift nel seguente modo:

  1. Aggiungi la seguente istruzione di importazione:
    import GoogleMaps
  2. Modifica la riga seguente per aggiungere la tua 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 nel seguente modo:

  1. Aggiungi la seguente istruzione di importazione:
    @import GoogleMaps;
  2. Modifica la riga seguente per aggiungere la tua 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 utilizzi la versione Objective-C della demo, vedrai la demo del per il 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 di seguito.