Scarica l'SDK Driver

gcloud

gcloud auth login

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

Il Driver SDK 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, segui questi passaggi:

1. Apri il tuo Xcode project o workspace, 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 estrarre 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 i prodotti del pacchetto, verifica che GoogleRidesharingDriver verrà aggiunto al target main designato. Al termine, fai clic su "Aggiungi pacchetto".
5. Per verificare l'installazione, vai al riquadro Generale della destinazione. Nella sezione Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" (Dipendenze del pacchetto) di "Project Navigator" (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Per aggiornare package per un progetto esistente, segui questi passaggi:

1. In Xcode, vai a File > Packages > Update To Latest Package Versions (File > Pacchetti > Aggiorna alle ultime versioni dei pacchetti).
2. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze del pacchetto) di Project Navigator (Navigatore progetto) 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, individua 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 l'SDK Driver al tuo progetto e configurare le impostazioni di build in Xcode.

Prima di seguire questa guida, completa queste operazioni:

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

• Installa l'SDK Navigation.

Per installare manualmente l'SDK Driver, segui questi passaggi:

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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 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 Build Phases (Fasi di build) e in Link Binary with Libraries (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 tuo progetto, anziché un target specifico, 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 build) da Basic (Di base) ad All (Tutte).