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 dagli SDK per i dispositivi mobili.
Quale versione collegare?
-
Per le app mission critical, collegati all'ultima release di punti della versione principale che stai utilizzando (X.*) ed esegui l'upgrade alla nuova versione principale ogni anno.
Man mano che rilasci nuove versioni dell'applicazione nel corso dell'anno, potresti iniziare a utilizzare le versioni più recenti del programma Maps SDK for Android. Ciò non richiederà aggiornamenti nell'applicazione, poiché le nuove versioni dei punti sono compatibili con le versioni precedenti.
Vantaggi:
- In caso di problemi nell'SDK Maps per Android, le correzioni saranno 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 i dispositivi mobili. Non sarà necessario eseguire urgentemente l'upgrade a una versione SDK incompatibile per beneficiare delle correzioni.
- Gli aggiornamenti e le funzionalità più recenti sono facili da adottare quando la tua app è già basata sull'ultima versione.
- Gli aggiornamenti annuali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare l'applicazione rispetto a dover gestire le modifiche incompatibili con le versioni precedenti introdotte in più release di versioni principali.
Per le app non critiche, inserisci un link a qualsiasi versione fissa. Quando ricevi un avviso di ritiro per la versione corretta, avrai 12 mesi di tempo per rendere il tuo codice aggiornato disponibile per gli utenti.
Vantaggi:
- Lavori di manutenzione meno frequenti.
- Le nuove versioni della tua app continuano a supportare gli utenti' i dispositivi con sistemi operativi per dispositivi mobili meno recenti rimangono più a lungo (fino a quando non dovrai eseguire l'upgrade a una nuova versione dell'SDK).
I proprietari di progetti con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Rimani al corrente dei principali aggiornamenti, ritiri e altre modifiche.
Installazione
Nel file build.gradle a livello di app, specifica sempre una versione anziché un intervallo di prefissi (+) o latest, in quanto ciò può causare build imprevedibili e non ripetibili. L'SDK Maps per Android è conforme al controllo delle versioni semantico e le nuove versioni principali potrebbero includere modifiche che provocano errori. Il livello minimo di API supportato è 19.
Specifica la dipendenza Maps all'interno di Google Play Services utilizzando la sintassi Gradle.
dependencies {
implementation 'com.google.android.gms:play-services-maps:18.1.0'
// ...
}
Consulta indicazioni aggiuntive per la gestione del controllo delle versioni di Google Play Services.
Manutenzione e upgrade
Android Studio controlla automaticamente la disponibilità di versioni più recenti e visualizza un avviso quando è disponibile una versione più recente di una dipendenza. Per ridurre al minimo il debito tecnico, esegui l'aggiornamento alla versione più recente disponibile il prima possibile. Se esegui l'aggiornamento a una nuova versione principale, consulta le note di rilascio per verificare che non siano presenti modifiche incompatibili con le versioni precedenti e come aggiornare il codice.
Oltre ai sondaggi per le versioni più recenti, i proprietari dei progetti 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 il ruolo di proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.