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 negli SDK mobile.
Quale versione collegare?
-
Per le app mission critical, collegati alla release più recente della versione principale che stai utilizzando (X.*) ed esegui l'upgrade annuale alla nuova versione principale.
Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, puoi iniziare a utilizzare versioni con punti più recenti dell'SDK Maps per iOS. Ciò non richiederà aggiornamenti nella tua applicazione poiché le nuove versioni a punti sono compatibili con le versioni precedenti.
Vantaggi:
- Se rilevi problemi nell'SDK Maps 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 alle Norme relative all'assistenza per dispositivi mobili. Per usufruire delle correzioni, non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatible.
- Gli ultimi miglioramenti e funzionalità sono facili da adottare quando la tua app è già integrata nella versione più recente.
- Gli aggiornamenti incrementali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare la tua applicazione rispetto a dover gestire modifiche incompatibili con le versioni precedenti introdotte in più release della versione principale.
Per le app non fondamentali, inserisci un link a una versione corretta. Quando ricevi un avviso di deprecazione per la versione corretta, hai 12 mesi di tempo per rendere disponibile il codice aggiornato dell'app agli utenti.
Vantaggi:
- Lavori di manutenzione meno frequenti.
- Le nuove versioni della tua app continuano a supportare i dispositivi degli utenti che eseguono sistemi operativi per dispositivi mobili meno recenti per più tempo (fino a quando non dovrai eseguire l'upgrade a una nuova versione dell'SDK).
I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che influiscono su ciascuno dei loro progetti. Ricevi aggiornamenti su importanti aggiornamenti, ritiri e altre modifiche.
Installazione
Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>
) poiché questo può generare build imprevedibili e non ripetibili. Maps SDK for iOS è conforme al controllo delle versioni semantico e le nuove versioni principali includono modifiche che provocano errori.
Un esempio di dipendenza Podfile che utilizza la sintassi Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.3.1' end
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, controlla le note di rilascio per verificare se sono state apportate modifiche incompatibili con le versioni precedenti e per sapere come aggiornare il codice.
Utilizzo di Cocoapods
Apri un terminale e vai alla directory contenente
Podfile
:cd <path-to-project>
- Esegui
pod outdated
per verificare se è disponibile una versione più recente dell'SDK Maps per iOS. - Se viene rilevata una versione più recente dell'SDK, aggiorna
Podfile
con questa nuova versione. Consulta la sezione Specifica delle versioni dei pod per scoprire come impostare una versione specifica inPodfile
. - Esegui
pod update
. - Apporta le modifiche necessarie in seguito all'upgrade. Consulta le Note di rilascio per un elenco delle modifiche apportate a ogni release.
- Pulisci e ricrea il progetto selezionando Prodotto > Pulisci, quindi Prodotto > Build.
Manuale
Ottieni il link ai file di origine più recenti nella pagina di installazione dell'SDK.
Oltre al polling per le versioni più recenti, i proprietari dei progetti di Google Cloud ricevono email sulle modifiche incompatibili con le versioni precedenti che potrebbero influire sui loro progetti. Per ricevere una notifica proattiva sulle modifiche incompatibili con le versioni precedenti, assegna il ruolo di proprietario con un indirizzo email monitorato per ogni progetto.