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, potresti iniziare a utilizzare versioni .dotte più recenti di Maps SDK for Android. Questa operazione non richiederà aggiornamenti nell'applicazione poiché le nuove versioni .dotte sono compatibili con le versioni precedenti.
Vantaggi:
- Se rilevi problemi in Maps SDK for Android, 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 mobile. 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
Nel file build.gradle a livello di app, specifica sempre una versione anziché un
intervallo di prefisso (+) o latest, poiché ciò può portare
a build imprevedibili e non ripetibili. Maps SDK for Android rispetta il
controllo delle versioni semantico e le nuove
versioni principali potrebbero includere modifiche che provocano un errore. Il livello API minimo supportato è 21.
Specificare la dipendenza di Maps in Google Play Services utilizzando la sintassi di Gradle.
dependencies {
// Maps SDK for Android
implementation 'com.google.android.gms:play-services-maps:19.0.0'
}
Leggi ulteriori indicazioni sulla gestione del controllo delle versioni di Google Play Services.
Manutenzione e upgrade
Android Studio verifica automaticamente la presenza di versioni più recenti e mostra un avviso quando è disponibile una versione più recente di una dipendenza. Per ridurre al minimo i problemi tecnici, esegui l'aggiornamento all'ultima versione il prima possibile. Se stai eseguendo l'aggiornamento a una nuova versione principale, controlla le note di rilascio per verificare se sono presenti modifiche incompatibili con le versioni precedenti e come aggiornare il codice.
Oltre al polling per le versioni più recenti, i proprietari del progetto Google Cloud ricevono email sulle modifiche incompatibili con le versioni precedenti che possono interessare i loro progetti. Per ricevere notifiche proattive sulle modifiche incompatibili con le versioni precedenti, assegna al ruolo di proprietario un indirizzo email monitorato per ciascuno dei tuoi progetti.