SDK Places per le versioni Android

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 sui kit di sviluppo software mobile.

A quale versione collegarsi?

• Per le app mission critical, inserisci un link alla versione più recente dei punti delle principali versione che stai utilizzando (X.*) ed esegui ogni anno l'upgrade alla nuova versione principale.

  Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, puoi iniziare a utilizzare le versioni con punti più recenti di Places SDK for Android. In questo modo Non richiedono aggiornamenti nell'applicazione, in quanto le nuove versioni DOT sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se vengono rilevati problemi in Places SDK for Android, le correzioni verranno fornite in modo compatibile con le versioni precedenti per 12 mesi dopo la release iniziale della versione principale, in base alle norme relative al supporto mobile. Non è necessario eseguire l'upgrade urgente a una versione dell'SDK incompatibile per usufruire delle correzioni.
  • Le funzionalità e i miglioramenti più recenti sono facili da adottare quando la tua app è già basata su all'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 non compatibili con le versioni precedenti introdotte in più release della versione principale.

• Per le app non critiche, fai il collegamento a qualsiasi versione corretta. Quando ricevi una notifica di ritiro per la versione corretta, avrai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato per i tuoi utenti.

  Vantaggi:

  • Lavori di manutenzione meno frequenti.
  • Le nuove versioni della tua app continuano a supportare i dispositivi degli utenti che utilizzano sistemi operativi mobile meno recenti per più tempo (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 influiscono su ciascuno dei loro progetti. Rimani informati in merito ad aggiornamenti importanti, ritiri e altri cambiamenti.

Installazione

Nel file build.gradle.kts o build.gradle a livello di app, specifica sempre una versione anziché un intervallo di prefisso (+) o latest, poiché questi possono portare a build imprevedibili e irripetibili. Places SDK per Android aderisce controllo delle versioni semantico e nuovo delle versioni principali possono includere modifiche che provocano un errore. Il livello API minimo supportato è 23.

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 controlla automaticamente se sono disponibili versioni più recenti e fornisce un avviso quando è disponibile una versione più recente di una dipendenza. Per ridurre al minimo i debiti 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 conoscere le modifiche non compatibili con le versioni precedenti e come aggiornare il codice.

Oltre a eseguire il polling per le versioni più recenti, i proprietari di progetti Google Cloud ricevono email relative a modifiche non compatibili con le versioni precedenti che potrebbero colpire i loro progetti. Per ricevere notifiche proattive in caso di incompatibilità con le versioni precedenti modifiche, assegna il ruolo di proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.

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

Non è necessaria alcuna migrazione per il passaggio al nuovo SDK. È sufficiente:

1. Attiva l'API Places (nuova) sulla chiave API utilizzata nell'app. Per ulteriori informazioni, consulta la sezione Utilizzo delle chiavi API.

2. Nella sezione dependencies del modulo a livello di modulo build.gradle file, 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.5.0'
     }

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

3. Aggiorna l'app esistente per chiamare la nuova Places.initializeWithNewPlacesApiEnabled() per inizializzare l'app. Per ulteriori informazioni, vedi Inizializza il client API Places.

Le tue app esistenti continueranno a funzionare invariato, ma ora puoi usufruire di tutte le nuove funzionalità dell'SDK.