Scarica l'SDK Driver

Questa sezione descrive come verificare che il sistema soddisfi i requisiti minimi, configurare il gruppo Workspace e ottenere Driver SDK.

Prima di iniziare

Driver SDK per iOS richiede che la tua app soddisfi i seguenti criteri:

  • Avere Navigation SDK.
  • Abilitare Maps SDK for iOS nella console Google Cloud e ottenere una chiave API.

Controllare i requisiti minimi di sistema

Controlla le note di rilascio per i requisiti minimi della versione di Driver SDK che stai utilizzando. Vedi Note di rilascio.

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

Ottenere l'accesso a Google Workspace

Se sei un cliente Google Workspace,segui questi passaggi:

  1. Crea un gruppo Workspace. Per saperne di più, vedi Gruppo Workspace.

    Ad esempio, come best practice, assegna al gruppo il nome google-maps-platform-sdk-users@workspacedomain.com durante l'onboarding.

  2. Fornisci il nome a Google per aggiungere il gruppo Workspace a una lista consentita che concede l'accesso ai repository CocoaPods corretti.

  3. Verifica che gli indirizzi email degli utenti e degli account di servizio che devono avere accesso siano inclusi in questo elenco.

Se la tua organizzazione non può creare gruppi Workspace, invia a Google un elenco di indirizzi email di utenti e account di servizio che devono avere accesso a questi artefatti.

Accedere con Cloud SDK

Per lo sviluppo locale, accedi con Cloud SDK. Per i dettagli, vedi Installare gcloud CLI.

Gli esempi riportati di seguito mostrano come accedere con Cloud SDK.

gcloud

gcloud auth login

Devi utilizzare un indirizzo email che sia membro del gruppo Workspace.

Configurare gli host di automazione

Per i sistemi di compilazione o l'integrazione continua, configura gli host di automazione in base all'elenco di metodi fornito per l'utilizzo di un account di servizio per l'autenticazione alle API di Google e ai servizi Google. Per i dettagli, vedi la sezione relativa agli account di servizio nella pagina Metodi di autenticazione di Google.

  • Se il processo viene eseguito all'interno di un ambiente Google Cloud, utilizza il rilevamento automatico delle credenziali. Per saperne di più, vedi Rilevamento automatico delle credenziali.

  • In caso contrario, salva il file della chiave dell'account di servizio in una posizione sicura nel file system dell'host e imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS in modo appropriato. Per maggiori dettagli, vedi GOOGLE_APPLICATION_CREDENTIALS.

L'indirizzo email del service account associato alle credenziali deve essere membro del gruppo Workspace.

Ottenere Driver SDK

Installa e configura Driver SDK.

CocoaPods

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

    sudo gem install cocoapods
    

    Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.

  2. Crea un podfile per Driver SDK: 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 'GoogleRidesharingDriver'
      end
      

      Ecco un esempio che include i pod Alpha e Beta per Driver SDK come dipendenze:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      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 installerà le API specificate nel podfile, insieme a eventuali dipendenze.

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

Swift Package Manager

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

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

  1. Apri il project o il workspace di Xcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
  2. Inserisci https://github.com/googlemaps/ios-driver-sdk come URL, premi Invio per recuperare il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
  3. Per installare una version specifica, imposta il campo Dependency Rule su una delle le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente e di utilizzare l'opzione "Exact Version" (Versione esatta). Al termine, fai clic su "Add Package" (Aggiungi pacchetto).

Per aggiornare il package di un progetto esistente:

  1. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator (Navigatore del progetto) per verificare il pacchetto e la relativa versione.

Per rimuovere Driver SDK esistente installato manualmente:

  1. Nelle impostazioni di configurazione del progetto Xcode, trova Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati). Utilizza il segno meno(-) per rimuovere il seguente framework:

    • GoogleRidesharingDriver.xcframework
  2. Dalla directory di primo livello del progetto Xcode, rimuovi il bundle GoogleRidesharingDriver.

Installazione manuale

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

Prima di seguire questa guida:

  • Scarica XCFramework, un pacchetto binario che utilizzi per installare Driver SDK. Puoi utilizzare questo pacchetto su più piattaforme, incluse le macchine che utilizzano Apple Silicon

  • Installa Navigation SDK.

Per installare manualmente Driver SDK:

  1. Scarica i file binari e le risorse dell'SDK:

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

  3. Avvia Xcode e apri un progetto esistente o creane uno. Se non hai familiarità con iOS, crea un nuovo progetto e seleziona il modello App per iOS.

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

  5. Per installare Driver SDK, trascina il file GoogleRidesharingDriver.xcframework nel progetto in Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati). Se richiesto, seleziona Copy items (Copia elementi).

  6. Trascina il file GoogleRidesharingDriver.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copy items (Copia elementi).

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

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

    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • LocalAuthentication.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • WebKit.framework
  9. Scegli il progetto, anziché una destinazione specifica, e apri la scheda Build Settings (Impostazioni di build). Nella sezione Other Linker Flags (Altri flag del linker), aggiungi -ObjC sia per il debug sia per la release.

    Se queste impostazioni non sono visibili, modifica il filtro nella barra Build Settings (Impostazioni di build) da Basic (Di base) a All (Tutte).

Esaminare il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app nell'App Store. Visita la pagina 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 dell'app e genera un report sulla privacy dall'archivio.

Passaggi successivi

Configurare un progetto della console Google Cloud