Scarica l'SDK Driver

Questa sezione descrive come verificare che il sistema soddisfi i requisiti minimi. configura il tuo gruppo Workspace e scarica l'SDK Driver.

Prima di iniziare

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

• Disporre dell'SDK di navigazione.
• Attiva Maps SDK per iOS nella console Google Cloud e ottieni una chiave API.

Verifica i requisiti minimi di sistema

Consulta le note di rilascio per conoscere i requisiti minimi per la versione dell' L'SDK del driver in uso. Vedi le Note di rilascio.

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

Accedi a Google Workspace

Se sei un cliente Google Workspace,segui questi passaggi:

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

   Ad esempio, come best practice, assegna un nome al gruppo [e-mail] 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 gli indirizzi email degli utenti e degli account di servizio che richiedono l'accesso 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 di utenti e servizi che necessitano dell'accesso a questi artefatti.

Nota: i gruppi Workspace non sono come i gruppi Google, che terminano con @googlegroups.com. 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 Cloud SDK.

gcloud

gcloud auth login

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

Configura gli host di automazione

Per i sistemi di build o l'integrazione continua, configura gli host di automazione in base nell'elenco fornito di metodi per usare un account di servizio per l'autenticazione API e servizi Google. Per maggiori dettagli, consulta la sezione relativa all'account di servizio nella pagina Metodi di autenticazione su Google.

• Se il tuo processo viene eseguito all'interno di un ambiente Google Cloud, utilizza rilevamento automatico delle credenziali. Per maggiori informazioni, consulta la sezione Rilevamento automatico delle credenziali.

• In caso contrario, archivia il file della chiave dell'account di servizio in una posizione sicura e impostare il file system GOOGLE_APPLICATION_CREDENTIALS la variabile di ambiente in modo appropriato. Per ulteriori dettagli, consulta GOOGLE_APPLICATION_CREDENTIALS.

L'indirizzo email dell'account di servizio associato alle credenziali deve essere un membro di gruppo Workspace.

Scarica Driver SDK

Installa e configura l'SDK Driver.

CocoaPods

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

   sudo gem install cocoapods
   

   Per ulteriori dettagli, consulta la guida introduttiva a CocoaPods.

2. Crea un podfile per l'SDK Driver: utilizzerai il podfile per installare l'API e le sue dipendenze.

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

   2. Modifica il podfile e aggiungi le tue 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 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 Podfile:

      cd <path-to-project>
      

3. Esegui il comando pod install: questo comando installerà le API nel podfile, insieme alle eventuali dipendenze.

   pod install
   

4. Apri il progetto in Xcode: chiudi Xcode, quindi apri fai doppio clic sul file .xcworkspace del tuo progetto per avviare Xcode. Per aprire dal progetto, usa il file .xcworkspace.

   Nota: esegui periodicamente pod outdated per rilevare quando è disponibile una nuova versione dell'SDK. Per ulteriori informazioni, vedi SDK Driver per le versioni iOS.

Gestore pacchetti Swift

L'SDK Driver può essere installato tramite Gestore pacchetti Swift. Per aggiungere l'SDK, assicurati di avere rimosso eventuali dipendenze esistenti dell'SDK del driver.

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 il file Xcode project o workspace, quindi seleziona File > Aggiungi dipendenze pacchetto.
2. Inserisci https://github.com/googlemaps/ios-driver-sdk come URL e premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
3. Per installare un'entità version specifica, imposta il campo Regola di dipendenza su uno dei le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente con la "versione esatta" . Al termine, fai clic su "Aggiungi pacchetto".
4. Nella finestra Scegli i prodotti del pacchetto, verifica che verrà aggiunto GoogleRidesharingDriver il target main designato. Al termine, fai clic su "Aggiungi pacchetto".
5. Per verificare l'installazione, vai al riquadro General di destinazione. In Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare le "Dipendenze pacchetto" sezione di "Project Navigator" per verificare il pacchetto e la sua versione.

Per aggiornare package per un progetto esistente:

1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le dipendenze seguenti: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per ulteriori informazioni, consulta Note di rilascio della versione 9.0.0.

   Dalle impostazioni di configurazione del progetto Xcode, individua Framework, Libraries, e Contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

   • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
2. Da Xcode, vai su "File > Pacchetti > Aggiorna alle ultime versioni del pacchetto".
3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la sua versione.

di Gemini Advanced.

Importante:a volte gli artefatti non possono essere risolti o possono verificarsi errori. in questo caso seleziona "File > Pacchetti > Reimposta cache pacchetto".

Per rimuovere le dipendenze esistenti dell'SDK del driver aggiunte utilizzando CocoaPods, segui questi passaggi:

1. Chiudi l'area di lavoro Xcode. Apri il terminale ed esegui questo comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Rimuovi Podfile, Podfile.resolved e Esegui l'Xcode workspace se non lo utilizzi per scopi diversi da CocoaPods.

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

1. Dalle impostazioni di configurazione del tuo progetto Xcode, individua Frameworks, Librerie e contenuti incorporati. Utilizza il segno meno(-) per rimuovere l'elemento. il seguente framework:

   • GoogleRidesharingDriver.xcframework

2. Dalla directory di primo livello del tuo progetto Xcode, rimuovi Set GoogleRidesharingDriver.

Installazione manuale

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

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

Prima di seguire questa guida, segui questi passaggi:

• Scarica XCFramework, un pacchetto binario da usare per installare SDK driver. Puoi utilizzare questo pacchetto su più piattaforme, tra cui utilizzando Apple Silicon

• Installa l'SDK di navigazione.

Per installare manualmente l'SDK dei driver, segui questi passaggi:

1. Scarica il file binario 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 nuovo utente di iOS, creare un nuovo progetto e selezionare il modello di app per iOS.

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

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

6. Trascina l'elemento GoogleRidesharingDriver.bundle scaricato nell'area di primo livello del tuo progetto Xcode. Se richiesto, seleziona Copia elementi.

7. Seleziona il tuo progetto dal navigatore dei progetti e scegli target dell'applicazione.

8. Apri la scheda Fasi di creazione e, in Collega file binario con le librerie, aggiungi la 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 tuo progetto, anziché un target specifico, e apri lo strumento Crea Impostazioni. Nella sezione Altri flag linker, aggiungi -ObjC per sia di debug che di release.

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

Esamina il file manifest della privacy di Apple

Apple richiede informazioni sulla privacy per le app disponibili 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 per la privacy sia stato incluso e per controllarne i contenuti, crea un archivio della tua app e genera una segnalazione sulla privacy dall'archivio.

Passaggi successivi

Configura un progetto nella console Google Cloud