Scarica l'SDK Driver

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

Prima di iniziare

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

• Avere l'SDK Navigation.
• Attiva l'SDK Maps per iOS nella console Google Cloud e ottieni una chiave API.

Verifica i requisiti minimi di sistema

Consulta le note di rilascio per i requisiti minimi della versione dell'SDK Driver in uso. Consulta le note di rilascio.

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

Accedere a Google Workspace

Se sei un cliente Google Workspace,svolgi i seguenti passaggi:

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

   Ad esempio, come best practice, ti consigliamo di assegnare un nome al gruppo [e-mail] durante l'onboarding.

2. Fornisci il nome a Google per aggiungere il tuo gruppo di Workspace a una lista consentita che grants grants access to the correct CocoaPods repositories.

3. Verifica che le email degli utenti e degli account di servizio che devono accedere siano incluse in questo elenco.

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

Nota: i gruppi Workspace non sono uguali ai gruppi Google, che terminano [e-mail]. Sono supportati solo i gruppi di Workspace.

Accedi con Cloud SDK

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

Gli esempi riportati di seguito mostrano come accedere con il 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 fornito di metodi per l'utilizzo di un account di servizio per l'autenticazione alle API e ai servizi Google. Per maggiori dettagli, consulta la sezione relativa agli account di servizio nella pagina Metodi di autenticazione di Google.

• Se il processo viene eseguito in un ambiente Google Cloud, utilizza il rilevamento automatico delle credenziali. Per ulteriori informazioni, consulta il rilevamento automatico delle credenziali.

• In caso contrario, salva il file della chiave dell'account di servizio in una posizione sicura sul 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 un membro del gruppo Workspace.

Ottenere l'SDK Driver

Installa e configura l'SDK Driver.

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 file Podfile per l'SDK Driver: utilizza il file 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 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ù, consulta la sezione Versioni dell'SDK Driver per iOS.

Swift Package Manager

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

Importante: queste istruzioni presuppongono l'utilizzo di Xcode 15 o versioni successive, ma dovrebbero essere simili per le versioni precedenti di Xcode.

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

1. Apri Xcode project o workspace, quindi vai a File > Aggiungi dipendenze del 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 la versione più recente e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".

Per aggiornare il package di un progetto esistente:

1. Per verificare l'installazione, vai alla sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

Importante: a volte gli elementi non possono essere risolti o possono verificarsi errori. In questo caso, seleziona "File > Pacchetti > Ripristina cache dei pacchetti".

Per rimuovere l'SDK Driver esistente installato manualmente:

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

   • GoogleRidesharingDriver.xcframework

2. Rimuovi il bundle GoogleRidesharingDriver dalla directory di primo livello del progetto Xcode.

Installazione manuale

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

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

Prima di seguire questa guida, svolgi i seguenti passaggi:

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

• Installa l'SDK Navigation.

Per installare manualmente l'SDK Driver:

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. Estrai i file compressi 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 Framework, creane uno.

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

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

7. Seleziona il progetto dal Progetto Navigator e scegli la destinazione dell'applicazione.

8. Apri la scheda Fasi di compilazione e in 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é un target specifico e apri la scheda Impostazioni compilazione. Nella sezione 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 Impostazioni di compilazione da Base a Tutte.

Ispezionare il file manifest per la privacy di Apple

Apple richiede dettagli sulla privacy delle app per le app nell'App Store. Per aggiornamenti e ulteriori informazioni, visita la pagina Dettagli sulla privacy dell'App Store di Apple.

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 ispezionarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Passaggi successivi

Configurare un progetto della console Google Cloud