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 su SDK per dispositivi mobili.

A quale versione eseguire il collegamento?

• 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.

  Quando rilasci nuove versioni dell'applicazione nel corso dell'anno, potrai iniziare a utilizzare versioni successive del punto più recente di Places SDK per Android. In questo modo Non richiedono aggiornamenti nell'applicazione, in quanto le nuove versioni .dotte sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se rilevi problemi in Places SDK per Android, le correzioni verranno fornite in un compatibile con le versioni precedenti per 12 mesi dopo il rilascio iniziale della versione principale, l'app Mobile support . Non sarà necessario eseguire urgentemente l'upgrade 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 annuali incrementali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro adattare, riscrivere e testare l'applicazione, anziché dover gestire apportate in più release delle versioni principali.

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

  Vantaggi:

  • Lavori di manutenzione meno frequenti.
  • Le nuove versioni della tua app continuano a supportare le funzionalità dispositivi con dispositivi mobili meno recenti sistemi più a lungo (fino a quando non dovrai eseguire l'upgrade a una nuova versione dell'SDK).

I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sui cambiamenti che impatto su ciascuno dei loro progetti. Rimani informati in merito ad aggiornamenti importanti, ritiri e altri cambiamenti.

Installazione

Nel file build.gradle a livello di app, specifica sempre una versione anziché una intervallo prefisso (+) o latest poiché possono generare a build imprevedibili e irripetibili. Places SDK per Android aderisce controllo delle versioni semantico e nuovo le principali versioni possono includere modifiche che provocano un errore. 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 disponibilità di versioni più recenti e mostra un avviso quando viene sia 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 esegui l'aggiornamento a una nuova versione principale, consulta le note di rilascio per scoprire le modifiche incompatibili con le versioni precedenti e scoprire come aggiornare il codice.

Oltre al polling per le versioni più recenti, Google Cloud progetto proprietari ricevono email relative a modifiche incompatibili con le versioni precedenti che potrebbero sui propri 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 per Android versione 3.2.0 o precedenti

Non è necessaria alcuna migrazione per passare 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, consulta 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 app esistenti continuano a funzionare senza modifiche, ma ora puoi utilizzare sfruttare tutte le nuove funzionalità dell'SDK.