Scarica l'SDK consumer per iOS

Seleziona la piattaforma: Android iOS JavaScript

Per seguire i viaggi on demand nelle tue app consumer per iOS, utilizza l'SDK consumer. Per ulteriori informazioni e per un'introduzione ai seguenti viaggi utilizzando la condivisione dei percorsi, consulta Seguire un percorso su iOS.

Per configurare l'SDK consumer per la tua app consumer per iOS, segui questi passaggi:

  1. Verifica i requisiti minimi di sistema.
  2. Scarica l'SDK consumer.
  3. Esamina il file manifest della privacy di Apple.
  4. Configura un progetto nella console Google Cloud.
  5. Recuperare i token di autenticazione.
  6. Inizializza l'SDK consumer.

Verifica i requisiti minimi di sistema

Consulta le note di rilascio per conoscere i requisiti minimi per la versione dell' l'SDK consumer che stai utilizzando. Vedi le Note di rilascio.

  • Sul dispositivo mobile deve essere installato iOS 14 o versioni successive.
  • Apple Xcode versione 15 o successive.

Scarica l'SDK consumer

Installi e configuri l'SDK consumer con CocoaPods.

Gestore pacchetti Swift

L'SDK consumer può essere installato tramite Gestore pacchetti Swift. Per aggiungere l'SDK, assicurati di avere rimosso eventuali dipendenze dell'SDK consumer esistenti.

Per aggiungere l'SDK a un progetto nuovo o esistente:

  1. Apri il file Xcode project o workspace, quindi seleziona File > Aggiungi dipendenze pacchetto.
  2. Inserisci https://github.com/googlemaps/ios-consumer-sdk come URL e premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un'entità version specifica, imposta il campo Regola di dipendenza su uno dei le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente con la "versione esatta" . Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli i prodotti del pacchetto, verifica che verrà aggiunto GoogleRidesharingConsumer il target main designato. Al termine, fai clic su "Aggiungi pacchetto".
  5. Per verificare l'installazione, vai al riquadro General di destinazione. In Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare le "Dipendenze pacchetto" sezione di "Project Navigator" per verificare il pacchetto e la sua versione.

Per aggiornare package per un progetto esistente:

  1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le dipendenze seguenti: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per ulteriori informazioni, consulta Note di rilascio della versione 9.0.0.

    Dalle impostazioni di configurazione del progetto Xcode, individua Framework, Libraries, e Contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

    • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
  2. Da Xcode, vai su "File > Pacchetti > Aggiorna alle ultime versioni del pacchetto".
  3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la sua versione.
di Gemini Advanced.

Per rimuovere le dipendenze dell'SDK consumer esistenti aggiunte utilizzando CocoaPods, segui questi passaggi:

  1. Chiudi l'area di lavoro Xcode. Apri il terminale ed esegui questo comando:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. Rimuovi Podfile, Podfile.resolved e Esegui l'Xcode workspace se non lo utilizzi per scopi diversi da CocoaPods.

Rimuovere l'SDK consumer esistente installato manualmente, segui questi passaggi:

  1. Dalle impostazioni di configurazione del tuo progetto Xcode, individua Frameworks, Librerie e contenuti incorporati. Utilizza il segno meno(-) per rimuovere l'elemento. il seguente framework:

    • GoogleRidesharingConsumer.xcframework
  2. Dalla directory di primo livello del tuo progetto Xcode, rimuovi Set GoogleRidesharingConsumer.

Usa CocoaPods

  1. Installa lo strumento CocoaPods: apri una finestra del terminale e esegui questo comando:

    sudo gem install cocoapods
    

    Per ulteriori dettagli, consulta Guida introduttiva a CocoaPods.

  2. Crea un podfile per l'SDK consumer: utilizzare il podfile per installare l'API e le sue dipendenze.

    1. Crea un file denominato Podfile nella directory del tuo progetto. Questo file definisce le dipendenze del progetto.

    2. Modifica il podfile e aggiungi le tue dipendenze. Ecco un esempio che include le dipendenze:

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      
    3. Salva il podfile: apri un terminale e vai alla cartella con il podfile:

      cd <path-to-project>
      
  3. Esegui il comando pod install: questo comando installa le API. nel podfile, insieme alle eventuali dipendenze.

    pod install
    
  4. Apri il progetto in Xcode: chiudi Xcode e poi aprilo (fai doppio clic). il file .xcworkspace del tuo progetto per avviare Xcode. Per aprire il progetto in seguito, usa il file .xcworkspace.

Installazione manuale

Questa guida mostra come aggiungere manualmente l'XCFramework contenente SDK consumer al progetto e configurare le impostazioni di build in Xcode.

Prima di seguire questa guida, segui questi passaggi:

  • Scarica XCFramework, un pacchetto binario da usare per installare SDK consumer. Puoi utilizzare questo pacchetto su più piattaforme, tra cui che utilizzano il chipset M1.

  • Installa il SDK Maps.

  1. Scarica il file binario e le risorse dell'SDK:

  2. Decomprimi i file compressi per accedere a XCFramework e alle risorse.

  3. Avvia Xcode e apri o crea un progetto. Se è la prima volta che utilizzi iOS, creare un nuovo progetto e selezionare il modello di app per iOS.

  4. Se il gruppo di progetto non contiene un gruppo Framework, crealo.

  5. Trascina il file gRPCCertificates.bundle scaricato nell'elenco di primo livello del tuo progetto Xcode. Se richiesto, seleziona Copia elementi.

  6. Per installare l'SDK consumer, trascina il GoogleRidesharingConsumer.xcframework nel tuo progetto in Framework, librerie e contenuti incorporati. Se richiesto, seleziona Copia elementi.

  7. Trascina l'oggetto GoogleRidesharingConsumer.bundle scaricato nell'elenco di primo livello del tuo progetto Xcode. Se richiesto, seleziona Copia elementi.

  8. Seleziona il tuo progetto dal navigatore dei progetti e scegli target dell'applicazione.

  9. Apri la scheda Fasi di creazione e in Collega file binario con le librerie, aggiungere i seguenti framework e librerie, se non sono già attuale:

    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  10. Scegli il tuo progetto, anziché una destinazione specifica, e apri Scheda Impostazioni build. Nella sezione Altri flag linker, aggiungi -ObjC sia per il debug che per la release.

    Se queste impostazioni non sono visibili, modifica il filtro nella Barra delle Impostazioni build da Di base a Tutte.

Ispeziona il file manifest della privacy di Apple

Apple richiede informazioni sulla privacy per le app disponibili sull'App Store. Visita la pagina dei dettagli sulla privacy dell'App Store di Apple per aggiornamenti e ulteriori informazioni.

Il file manifest della privacy di Apple è incluso nel bundle di risorse per l'SDK. Per verificare che il file manifest per la privacy sia stato incluso e per controllarne i contenuti, crea un archivio della tua app e genera una segnalazione sulla privacy dall'archivio.

Passaggi successivi

Configura un progetto nella console Google Cloud