Scarica l'SDK consumer per iOS

Gestore pacchetti Swift

L'SDK Consumer può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso tutte le dipendenze dell'SDK consumer esistenti.

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

1. 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 consumer esistente installato manualmente, segui questi passaggi:

1. Dalle impostazioni di configurazione del progetto Xcode, individua Framework, libraries e Embedded Content. 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 questo comando:

   sudo gem install cocoapods
   

   Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.

2. Crea un podfile per l'SDK consumer: utilizzerai il podfile per installare l'API e le sue 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 podfile, insieme alle 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 in un secondo momento, usa il file .xcworkspace.

Installazione manuale

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

Prima di seguire questa guida, segui questi passaggi:

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

• Installa l'SDK Maps.

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 è la prima volta che utilizzi iOS, crea un nuovo progetto e seleziona il modello di app per iOS.

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

5. Trascina il file gRPCCertificates.bundle scaricato nella directory di primo livello del tuo 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 il file GoogleRidesharingConsumer.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copia elementi.

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

9. Apri la scheda Fasi di compilazione e in Esegui il collegamento del file binario con le 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 build da Di base a Tutte.