SDK Driver per le versioni iOS

Il team di Google Maps Platform aggiorna regolarmente gli SDK con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. Questa pagina fornisce indicazioni su come gestire le dipendenze sugli SDK per dispositivi mobili.

A quale versione eseguire il collegamento?

• Per le app mission-critical, collegati alla versione più recente della versione principale in uso (X.*) ed esegui l'upgrade ogni anno alla nuova versione principale.

  Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, puoi iniziare a utilizzare versioni .dotte più recenti dell'SDK Driver per iOS. Questa operazione non richiederà aggiornamenti nell'applicazione poiché le nuove versioni .dotte sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se rilevi problemi nell'SDK Driver per iOS, le correzioni verranno fornite in modo compatibile con le versioni precedenti per 12 mesi dopo il rilascio iniziale della versione principale, in base ai criteri relativi al supporto dei dispositivi mobili. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatible per usufruire delle correzioni.
  • Se la tua app è già basata sulla versione più recente, è facile adottare gli ultimi miglioramenti e le funzionalità.
  • Gli aggiornamenti incrementali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare l'applicazione rispetto alla gestione di modifiche incompatibili con le versioni precedenti introdotte in più release delle versioni principali.

• Per le app non critiche, inserisci un link a qualsiasi versione fissa. Quando ricevi un avviso di ritiro per la versione corretta, hai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato ai tuoi utenti.

  Vantaggi:

  • Lavori di manutenzione meno frequenti.
  • Le nuove versioni della tua app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi per dispositivi mobili meno recenti (finché non dovrai eseguire l'upgrade a una nuova versione dell'SDK).

I proprietari dei progetti con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Resta al corrente su importanti aggiornamenti, ritiri e altri cambiamenti.

Installazione

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>) poiché può portare a build imprevedibili e non ripetibili. L'SDK Driver per iOS rispetta il controllo delle versioni semantico e le nuove release principali delle versioni includono modifiche che provocano un errore.

Nota: l'SDK driver per iOS non supporta l'installazione tramite Carthage.

CocoaPods

Esempio di dipendenza del podfile che utilizza la sintassi Podfile:

      source "https://github.com/CocoaPods/Specs.git"

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Gestore pacchetti Swift

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.

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 il file Xcode project o workspace, quindi vai a 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 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".
4. Nella finestra Scegli i prodotti del pacchetto, verifica che GoogleRidesharingDriver verrà aggiunto alla destinazione main designata. Al termine, fai clic su "Aggiungi pacchetto".
5. Per verificare l'installazione, vai al riquadro General di destinazione. In Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Dipendenze pacchetto" di "Navigatore progetto" per verificare il pacchetto e la sua versione.

Per aggiornare package per un progetto esistente:

1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le seguenti dipendenze: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per maggiori informazioni, consulta le note di rilascio della versione 9.0.0.

   Nelle impostazioni di configurazione del progetto Xcode, individua Framework, librerie e contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

   • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
   • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
2. Da Xcode, seleziona "File > Packages > Update to Latest Package Versions" (File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti).
3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

Importante:a volte gli artefatti non possono essere risolti o possono verificarsi errori. In questo caso, seleziona "File > Pacchetti > Reimposta cache del pacchetto".

Per rimuovere le dipendenze esistenti dell'SDK del driver aggiunte utilizzando CocoaPods:

1. Chiudi l'area di lavoro Xcode. Apri il terminale ed esegui questo comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Rimuovi Podfile, Podfile.resolved e Xcode workspace se non li utilizzi per scopi diversi da CocoaPods.

Manutenzione e upgrade

Per creare con i miglioramenti più recenti, verifica regolarmente la presenza di versioni più recenti e aggiorna le specifiche della versione. Se stai eseguendo l'aggiornamento a una nuova versione principale, consulta le note di rilascio per verificare se sono presenti modifiche incompatibili con le versioni precedenti e come aggiornare il codice.

Cocoapodi

1. Apri un terminale e vai alla directory contenente Podfile:

   cd <path-to-project>

2. Esegui pod outdated per vedere se è disponibile una versione più recente dell'SDK Driver per iOS.
3. Se viene trovata una versione più recente dell'SDK, aggiorna Podfile con questa nuova versione. Consulta Specifica delle versioni dei pod per scoprire come impostare una versione specifica in Podfile.
4. Esegui pod update.
5. Apporta le modifiche necessarie a seguito dell'upgrade. Consulta le Note di rilascio per un elenco delle modifiche in ciascuna release.
6. Pulisci e ricrea il progetto selezionando Prodotto > Pulisci, quindi Prodotto > Crea

Installazione manuale

Ottieni il link ai file di origine più recenti durante l'installazione dell'SDK.

Oltre al polling per le versioni più recenti, i proprietari del progetto Google Cloud ricevono email sulle modifiche incompatibili con le versioni precedenti che potrebbero interessare i loro progetti. Per ricevere una notifica proattiva sulle modifiche incompatibili con le versioni precedenti, assegna al ruolo di proprietario un indirizzo email monitorato per ciascuno dei tuoi progetti.