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 SDK Navigation.
• 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.

• Sul dispositivo mobile deve essere installato 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 [e-mail] 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.

Nota: i gruppi Workspace non sono uguali ai gruppi Google, che terminano con @googlegroups.com. Sono supportati solo i gruppi Workspace.

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 build 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 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 dell'account di servizio 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 seguente comando.

   sudo gem install cocoapods
   

   Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.

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

   Nota: esegui periodicamente pod outdated per rilevare quando è disponibile una versione più recente dell'SDK. Per saperne di più, vedi Versioni di Driver SDK per iOS.

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.
2. Inserisci https://github.com/googlemaps/ios-driver-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Add Package".
3. Per installare uno specifico version, imposta il campo Dependency Rule su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente e di utilizzare l'opzione "Exact Version". Al termine, fai clic su "Add Package".
4. Nella finestra Choose Package Products, verifica che GoogleRidesharingDriver venga aggiunto al tuo main target designato. Al termine, fai clic su "Add Package".
5. Per verificare l'installazione, vai al riquadro General del target. In Frameworks, Libraries, and Embedded Content dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" di "Project Navigator" per verificare il pacchetto e la relativa versione.

Per aggiornare il package di un progetto esistente:

1. Da Xcode, vai a File > Packages > Update To Latest Package Versions.
2. Per verificare l'installazione, vai alla sezione Package Dependencies di Project Navigator per verificare il pacchetto e la relativa versione.

Importante: a volte gli artefatti non possono essere risolti o possono verificarsi errori. In questo caso, seleziona "File > Packages > Reset Package Cache".

Per rimuovere Driver SDK esistente installato manualmente:

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 l'XCFramework contenente Driver SDK al progetto e configurare le impostazioni di build in Xcode.

Attenzione: come best practice, utilizza Cocoapods per installare Driver SDK, se possibile.

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 SDK Navigation.

Per installare manualmente Driver SDK:

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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 Frameworks, crealo.

5. Per installare Driver SDK, trascina il file GoogleRidesharingDriver.xcframework nel progetto in Frameworks, Libraries, and Embedded Content. 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 il target dell'applicazione.

8. Apri la scheda Build Phases e, in Link Binary with Libraries, 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 Build Settings. Nella sezione Other Linker Flags, aggiungi -ObjC sia per il debug sia per la release.

   Se queste impostazioni non sono visibili, modifica il filtro nella barra Build Settings da Basic a All.

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 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