Scarica l'SDK consumer per iOS

Seleziona la piattaforma: Android iOS JavaScript

Per seguire i percorsi on demand nelle tue app per utenti finali iOS, utilizza l'SDK Consumer. Per ulteriori informazioni e un'introduzione al monitoraggio dei percorsi, consulta Monitora un percorso in iOS.

Per configurare l'SDK Consumer per la tua app per utenti finali 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 della console Google Cloud.
  5. Ottieni i token di autenticazione.
  6. Inizializza l'SDK Consumer.

Verifica i requisiti minimi di sistema

Consulta le note di rilascio per i requisiti minimi della versione dell'SDK Consumer che stai utilizzando. Consulta le note di rilascio.

  • Il dispositivo mobile deve avere iOS 16 o versioni successive.
  • Apple Xcode versione 26 o successive.

Scarica l'SDK Consumer

Installa e configura l'SDK Consumer con CocoaPods.

Swift Package Manager

L'SDK Consumer può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze dell'SDK Consumer esistenti.

Per aggiungere l'SDK a un progetto nuovo o esistente, segui questi passaggi:

  1. Apri il tuo project o workspace Xcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
  2. Inserisci https://github.com/googlemaps/ios-consumer-sdk come URL, premi Invio per inserire il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un version specifico, imposta il campo Regola di dipendenza su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare l'ultima versione e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli i prodotti del pacchetto, verifica che GoogleRidesharingConsumer verrà aggiunto alla destinazione main designata. Al termine, fai clic su "Aggiungi pacchetto".
  5. Per verificare l'installazione, vai al riquadro General (Generale) della destinazione. Nella sezione Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Dipendenze del pacchetto" di "Navigatore progetto" per verificare il pacchetto e la relativa versione.

Per aggiornare package per un progetto esistente, segui questi passaggi:

  1. In Xcode, vai a File > Packages > Update To Latest Package Versions (File > Pacchetti > Aggiorna alle ultime versioni dei pacchetti).
  2. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Per rimuovere l'SDK Consumer esistente installato manualmente, segui questi passaggi:

  1. Nelle impostazioni di configurazione del progetto Xcode, individua Framework, librerie e contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

    • GoogleRidesharingConsumer.xcframework

  2. Dalla directory di primo livello del progetto Xcode, rimuovi il bundle GoogleRidesharingConsumer.

Utilizza CocoaPods

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

    sudo gem install cocoapods

    Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.

  2. Crea un Podfile per l'SDK Consumer: utilizza il Podfile per installare l'API e le relative dipendenze.

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

    2. Modifica il Podfile e aggiungi le 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 specificate nel Podfile, insieme alle eventuali dipendenze.

    pod install

  4. Apri il progetto in Xcode: chiudi Xcode e poi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Per aprire il progetto in un secondo momento, utilizza il file .xcworkspace.

Installazione manuale

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

Prima di seguire questa guida, completa queste operazioni:

  • Scarica XCFramework, un pacchetto binario che utilizzi per installare l'SDK Consumer. Puoi utilizzare questo pacchetto su più piattaforme, incluse le macchine che utilizzano il chipset M1.

  • Installa Maps SDK.

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

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

  3. Avvia Xcode e apri o crea un progetto. Se non hai mai utilizzato iOS, crea un nuovo progetto e seleziona il modello di app per iOS.

  4. Se il gruppo di progetti non contiene un gruppo Frameworks, crealo.

  5. Trascina il file gRPCCertificates.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copia elementi.

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

  7. Trascina il file GoogleRidesharingConsumer.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copia elementi.

  8. Seleziona il progetto dal navigatore del progetto e scegli la destinazione dell'applicazione.

  9. Apri la scheda Build Phases (Fasi di build) e in Link Binary with Libraries (Collega binario con librerie), aggiungi i seguenti framework e librerie se non sono già presenti:

    • 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é un target specifico, e apri la scheda Build Settings (Impostazioni build). Nella sezione Other Linker Flags, aggiungi -ObjC sia per il debug che per la release.

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

Esamina il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app per le app presenti nell'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 della privacy sia stato incluso e per esaminarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Passaggi successivi

Configura un progetto della console Google Cloud