Scarica l'SDK consumer per iOS

Seleziona la piattaforma: Android iOS JavaScript

Per seguire i viaggi on demand nelle tue app per consumatori per iOS, utilizza l'SDK Consumer. Per ulteriori informazioni e un'introduzione al monitoraggio delle corse, consulta Monitorare una corsa su iOS.

Per esempi, consulta le app di esempio per iOS o gli esempi combinati.

Per configurare l'SDK Consumer per la tua app per consumatori iOS, segui questi passaggi:

1. Verifica i requisiti minimi di sistema.
2. Ottieni l'SDK Consumer.
3. Esamina il file manifest della privacy di Apple.
4. Configura un progetto della console Google Cloud.
5. Ottieni i token di autenticazione.
6. Inizializza l'SDK Consumer.

Verifica i requisiti minimi di sistema

Consulta le note di rilascio per i requisiti minimi della versione dell'SDK Consumer 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.

Ottenere l'SDK consumer

Installa e configura l'SDK Consumer con CocoaPods.

Swift Package Manager

L'SDK Consumer può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze dall'SDK Consumer 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-consumer-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 > Reimposta cache dei pacchetti".

Per rimuovere l'SDK Consumer 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:

   • GoogleRidesharingConsumer.xcframework

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

Utilizzare 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 Consumer: lo utilizzi 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 'GoogleRidesharingConsumer'
      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 installa le API specificate nel file Podfile, insieme a eventuali dipendenze.

   pod install
   

4. Apri il progetto in Xcode: chiudi Xcode, quindi apri (fai doppio clic) sul file .xcworkspace del progetto per avviare Xcode. Per aprire il progetto più tardi, utilizza il file .xcworkspace.

   Nota: esegui periodicamente pod outdated per rilevare quando è disponibile una versione più recente dell'SDK. Per saperne di più, consulta le note di rilascio dell'SDK per i consumatori relative alle versioni dell'SDK per i consumatori.

Installazione manuale

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

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

Prima di seguire questa guida, svolgi i seguenti passaggi:

• Scarica XCFramework, un pacchetto binario che utilizzi per installare l'SDK consumer. Puoi utilizzare questo pacchetto su più piattaforme, tra cui le macchine che utilizzano il chipset M1.

• Installa Maps SDK.

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

2. Estrai i file compressi per accedere a XCFramework e alle risorse.

3. Avvia Xcode e apri o crea un progetto. 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. Trascina il file gRPCCertificates.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copia elementi.

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

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

8. Seleziona il progetto dal Navigatore progetti e scegli la destinazione dell'applicazione.

9. 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
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Scegli il progetto anziché un target specifico e apri la scheda Impostazioni di compilazione. Nella sezione Altri flag del linker, aggiungi -ObjC sia per il debug che 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 nella console Google Cloud