Questa sezione descrive come verificare che il sistema soddisfi i requisiti minimi, come configurare il tuo gruppo Workspace e come ottenere 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 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:
Crea un gruppo Workspace. Per saperne di più, vedi Gruppo di Workspace.
Ad esempio, come best practice, ti consigliamo di assegnare un nome al gruppo
google-maps-platform-sdk-users@workspacedomain.com
durante l'onboarding.Fornisci il nome a Google per aggiungere il tuo gruppo Workspace a una lista consentita che concede l'accesso ai repository CocoaPods corretti.
Verifica che gli indirizzi email degli utenti e quelli degli account di servizio che richiedono l'accesso siano inclusi 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.
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 un 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 fornito di metodi per utilizzare un account di servizio per eseguire l'autenticazione nelle API e nei servizi Google. Per maggiori dettagli, consulta la sezione sull'account di servizio nella pagina Metodi di autenticazione in Google.
Se il processo viene eseguito all'interno di 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 ulteriori dettagli, consulta 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
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.
Crea un podfile per l'SDK Driver: utilizzerai il podfile per installare l'API e le sue dipendenze.
Crea un file denominato
Podfile
nella directory del progetto. Questo file definisce le dipendenze del progetto.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 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
Salva il Podfile: apri un terminale e vai alla cartella con il Podfile:
cd <path-to-project>
Esegui il comando pod install: questo comando installerà le API specificate nel Podfile, insieme a eventuali dipendenze.
pod install
Apri il progetto in Xcode: chiudi Xcode, quindi apri (doppio clic) il file .xcworkspace del tuo 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 esistenti dell'SDK del driver.
Per aggiungere l'SDK a un progetto nuovo o esistente:
-
Apri Xcode
project
oworkspace
, quindi vai a File > Aggiungi dipendenze del pacchetto. - Inserisci https://github.com/googlemaps/ios-driver-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
-
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 package
per un progetto esistente:
- Per verificare l'installazione, vai alla sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.
Per rimuovere l'SDK Driver esistente installato manualmente:
Dalle impostazioni di configurazione del progetto Xcode, individua Framework, libraries e Embedded Content. Utilizza il segno meno
(-)
per rimuovere il seguente framework:GoogleRidesharingDriver.xcframework
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 dei driver e configurare le impostazioni di build in Xcode.
Prima di seguire questa guida, svolgi i seguenti passaggi:
Scarica XCFramework, un pacchetto binario che puoi utilizzare per installare l'SDK Driver. Puoi utilizzare questo pacchetto su più piattaforme, tra cui le macchine che utilizzano Apple Silicon
Installa l'SDK di navigazione.
Per installare manualmente l'SDK dei driver, segui questi passaggi:
Scarica il programma binario e le risorse dell'SDK:
Decomprimi i file compressi per accedere a XCFramework e alle risorse.
Avvia Xcode e apri un progetto esistente o creane uno nuovo. Se è la prima volta che utilizzi iOS, crea un nuovo progetto e seleziona il modello di app per iOS.
Se il gruppo di progetti non contiene un gruppo Framework, creane uno.
Per installare l'SDK Driver, trascina il
GoogleRidesharingDriver.xcframework
file nel progetto in Framework, librerie e contenuti incorporati. Se richiesto, seleziona Copia elementi.Trascina l'oggetto
GoogleRidesharingDriver.bundle
scaricato nella directory di primo livello del tuo progetto Xcode. Se richiesto, seleziona Copia elementi.Seleziona il tuo progetto dal navigatore dei progetti e scegli il target della tua applicazione.
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
Scegli il tuo progetto, anziché una destinazione specifica, e apri la scheda Impostazioni build. Nella sezione Altri flag linker, aggiungi
-ObjC
sia per il debug che per la release.Se queste impostazioni non sono visibili, modifica il filtro nella barra Impostazioni build da Di 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 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.