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 mobile.
A quale versione eseguire il collegamento?
-
Per le app mission-critical, esegui il collegamento all'ultima release secondaria della versione principale che stai utilizzando (X.*) ed esegui l'upgrade annuale alla nuova versione principale.
Quando rilasci nuove versioni della tua applicazione durante l'anno, potresti iniziare a utilizzare versioni secondarie più recenti di Maps SDK for Android. Non sarà necessario aggiornare l'applicazione, poiché le nuove versioni secondarie sono compatibili con le versioni precedenti.
Vantaggi:
- Se riscontri 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 alle norme di assistenza per dispositivi mobile. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatibile per usufruire delle correzioni.
- È facile adottare i miglioramenti e le funzionalità più recenti quando l'app è già basata sull' ultima versione.
- 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 delle modifiche incompatibili con le versioni precedenti introdotte in più release di versioni principali.
Per le app non critiche, esegui il collegamento a una versione fissa. Quando ricevi un avviso di ritiro per la versione fissa, avrai 12 mesi di tempo per rendere disponibile agli utenti il codice dell'app aggiornato.
Vantaggi:
- Lavoro di manutenzione meno frequente.
- Le nuove versioni dell'app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi mobile meno recenti (finché non devi 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. Rimani aggiornato su aggiornamenti principali, ritiri e altre modifiche.
Installazione
Nel file build.gradle.kts o build.gradle a livello di app, specifica sempre
una versione anziché un intervallo di prefissi (+) o latest, poiché questi possono portare
a build imprevedibili e non ripetibili. Maps SDK for Android rispetta il
controllo delle versioni semantico e le nuove
release di versioni principali potrebbero includere modifiche che causano interruzioni. Il livello API minimo supportato è 23.
Specifica la dipendenza Maps all'interno di Google Play Services utilizzando la sintassi Gradle.
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
Consulta ulteriori indicazioni per la gestione del controllo delle versioni di Google Play Services.
Manutenzione ed upgrade
Android Studio verifica automaticamente la disponibilità di versioni più recenti e mostra 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 le modifiche incompatibili con le versioni precedenti e per scoprire come aggiornare il codice.
Oltre a eseguire il polling per le versioni più recenti, i proprietari dei progetti Google Cloud ricevono email relative a 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.