SDK Places per le versioni Android

Seleziona la piattaforma: Android iOS JavaScript

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.

A quale versione collegarti?

• Per le app mission critical, collegati alla release più recente della versione principale che utilizzi (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 più recenti dei punti dell'SDK Places for Android. Questo non richiederà aggiornamenti nella tua applicazione poiché le nuove versioni dei punti sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se riscontri problemi nell'SDK Places per 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 relative all'assistenza per dispositivi mobili. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatible per usufruire delle correzioni.
  • Le funzionalità e i miglioramenti più recenti 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 l'applicazione rispetto alla necessità di gestire modifiche incompatibili con le versioni precedenti introdotte in più release della versione principale.

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

  Vantaggi:

  • Lavori di manutenzione meno frequenti.
  • Le nuove versioni della tua app continuano a supportare i dispositivi degli utenti con sistemi operativi mobile meno recenti (fino a quando non devi eseguire l'upgrade a una nuova versione dell'SDK).

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

Installazione

Nel tuo file build.gradle a livello di app, specifica sempre una versione anziché un intervallo di prefissi (+) o latest, poiché questi possono generare build imprevedibili e non ripetibili. L'SDK Places per Android rispetta il controllo delle versioni semantico e le nuove versioni principali potrebbero includere modifiche che provocano errori. Il livello API minimo supportato è 21.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

Manutenzione e upgrade

Android Studio verifica automaticamente la presenza di versioni più recenti disponibili e invia un avviso quando è disponibile una versione più recente di una dipendenza. Per ridurre al minimo il debito tecnico, esegui l'aggiornamento il prima possibile. Se stai eseguendo l'aggiornamento a una nuova versione principale, consulta le note di rilascio per conoscere le modifiche incompatibili con le versioni precedenti e sapere come aggiornare il codice.

Oltre al polling per le versioni più recenti, i proprietari del progetto Google Cloud ricevono email relative a modifiche incompatibili con le versioni precedenti che potrebbero interessare i loro progetti. Per ricevere notifiche proattive sulle modifiche incompatibili con le versioni precedenti, assegna il ruolo di proprietario con un indirizzo email monitorato per ogni progetto.

Se esegui l'upgrade da Places SDK for Android versione 3.2.0 o precedenti

Non è necessaria alcuna migrazione quando si passa al nuovo SDK. Devi solo:

1. Attiva l'API Places (nuova) sulla chiave API utilizzata nella tua app. Per ulteriori informazioni, consulta la pagina relativa all'utilizzo delle chiavi API.

2. Nella sezione dependencies del file build.gradle a livello di modulo, aggiorna la dipendenza places e aggiungi la dipendenza kotlin-bom:

     dependencies {
         implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
         implementation 'com.google.android.libraries.places:places:3.3.0'
     }

   Per maggiori informazioni sulla dipendenza kotlin-bom, consulta Utilizzo della versione di kotlin-stdlib più recente nelle dipendenze transitive.

3. Aggiorna l'app esistente per chiamare il nuovo metodo Places.initializeWithNewPlacesApiEnabled() per inizializzare l'app. Per saperne di più, consulta Inizializzare il client API Places.

Le app esistenti continuano a funzionare senza modifiche, ma ora puoi usufruire di tutte le nuove funzionalità dell'SDK.