Scarica l'SDK consumer per iOS

Swift Package Manager

Consumer SDK può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze di Consumer SDK esistenti.

Per aggiungere l'SDK a un progetto nuovo o esistente:

1. Apri il tuo project o workspace Xcode, quindi vai a File > Add Package Dependencies.
2. Inserisci https://github.com/googlemaps/ios-consumer-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
3. Per installare un version specifico, imposta il campo Dependency Rule su una delle opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente e di utilizzare l'opzione "Exact Version" (Versione esatta). Al termine, fai clic su "Add Package" (Aggiungi pacchetto).

Per aggiornare il package di un progetto esistente:

1. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator per verificare il pacchetto e la relativa versione.

Per rimuovere Consumer SDK esistente installato manualmente:

1. Nelle impostazioni di configurazione del progetto Xcode, trova Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati). Utilizza il segno meno(-) per rimuovere il seguente framework:

   • GoogleRidesharingConsumer.xcframework

2. Dalla directory di primo livello del progetto Xcode, rimuovi il bundle GoogleRidesharingConsumer.

Utilizza 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 Consumer SDK: utilizzi 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 '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 a eventuali dipendenze.

   pod install
   

4. Apri il progetto in Xcode: chiudi Xcode e poi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Per aprire il progetto in un secondo momento, utilizza il file .xcworkspace.

Installazione manuale

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

Prima di seguire questa guida:

• Scarica XCFramework, un pacchetto binario che utilizzi per installare Consumer SDK. Puoi utilizzare questo pacchetto su più piattaforme, incluse le macchine che utilizzano il chipset M1.

• Installa il Maps SDK.

1. Scarica i file binari e le risorse dell'SDK:

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

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

3. Avvia Xcode e apri o crea un progetto. Se non hai familiarità con iOS, crea un nuovo progetto e seleziona il modello App iOS.

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

5. Trascina il file gRPCCertificates.bundle scaricato nella directory di primo livello del progetto Xcode. Se richiesto, seleziona Copia elementi.

6. Per installare Consumer SDK, trascina il file GoogleRidesharingConsumer.xcframework nel progetto in Frameworks, Libraries, and Embedded Content (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 navigatore progetto e scegli la destinazione dell'applicazione.

9. Apri la scheda Build Phases (Fasi di build) e, in Link Binary with Libraries (Collega file binari 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é una destinazione specifica, 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 di build) da Basic (Di base) a All (Tutte).