Scarica l'SDK Driver

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

Prima di iniziare

Per utilizzare l'SDK Driver per iOS, la tua app deve soddisfare i seguenti criteri:

  • Disporre dell'SDK Navigation.
  • Abilita Maps SDK for iOS nella console Google Cloud e ottieni una chiave API.

Controllare i requisiti minimi di sistema

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

  • Sul dispositivo mobile deve essere installato iOS 16 o versioni successive.
  • Apple Xcode versione 26 o successive.

Accedi a Google Workspace

Se sei un cliente Google Workspace,segui questi passaggi:

  1. Crea un gruppo di aree di lavoro. Per saperne di più, consulta Gruppo di aree di lavoro.

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

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

  3. Verifica che le email utente e le email del service account che devono accedere siano incluse in questo elenco.

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

Accedi con Cloud SDK

Per lo sviluppo locale, accedi con Cloud SDK. Per maggiori dettagli, vedi Installa gcloud CLI.

Gli esempi seguenti mostrano come accedere con Cloud SDK.

gcloud

gcloud auth login

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

Configura gli host di automazione

Per i sistemi di compilazione o l'integrazione continua, configura gli host di automazione in base all'elenco fornito di metodi per utilizzare un service account per l'autenticazione alle API e ai servizi Google. Per maggiori dettagli, consulta la sezione relativa al service account 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ù, consulta Rilevamento automatico delle credenziali.

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

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

Scarica l'SDK Driver

Installa e configura Driver SDK.

CocoaPods

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

    sudo gem install cocoapods
    

    Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.

  2. Crea un Podfile per l'SDK Driver: utilizzi 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 l'SDK Driver 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 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.

Swift Package Manager

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

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

  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-driver-sdk come URL, premi Invio per importare 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 prodotti pacchetto, verifica che GoogleRidesharingDriver 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 Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Dipendenze pacchetto" di "Project Navigator" per verificare il pacchetto e la relativa versione.

Per aggiornare il package per un progetto esistente:

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

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

  1. Nelle impostazioni di configurazione del progetto Xcode, trova Frameworks, Libraries, and Embedded Content. 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 al tuo progetto l'XCFramework contenente l'SDK Driver e 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, tra cui macchine che utilizzano silicio Apple

  • Installa l'SDK Navigation.

Per installare manualmente l'SDK Driver:

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

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

  3. Avvia Xcode e apri un progetto esistente o creane uno nuovo. 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. Per installare l'SDK Driver, trascina il file GoogleRidesharingDriver.xcframework nel tuo progetto in Framework, librerie e contenuti incorporati. Se richiesto, seleziona Copia elementi.

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

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

  8. Apri la scheda Fasi di build e, in Collega 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é un target specifico, e apri la scheda Impostazioni build. Nella sezione Altri flag del linker, aggiungi -ObjC per il debug e la release.

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

Esaminare il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app per le app 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 della privacy sia stato incluso ed 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