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 dagli SDK mobile.

  • Per le app mission-critical, crea un link all'ultima versione secondaria della versione principale che stai utilizzando (X.*) ed esegui l'upgrade annuale alla nuova versione principale.

    Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, potresti iniziare a utilizzare versioni secondarie più recenti di Places SDK for Android. Ciò non richiederà aggiornamenti nella tua applicazione, poiché le nuove versioni secondarie sono compatibili con le versioni precedenti.

    Vantaggi:

    • Se riscontri problemi in Places SDK for Android, le correzioni verranno fornite in modo retrocompatibile per 12 mesi dopo la release iniziale della versione principale, in conformità alle norme di assistenza per il mobile. Non dovrai eseguire l'upgrade urgente a una versione dell'SDK incompatibile per usufruire delle correzioni.
    • I miglioramenti e le funzionalità più recenti sono facili da adottare 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 di modifiche non compatibili con le versioni precedenti introdotte in più release di versioni principali.

  • Per le app non critiche, collega una versione corretta. Quando ricevi una notifica di ritiro per quella versione corretta, hai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato ai tuoi utenti.

    Vantaggi:

    • Lavoro di manutenzione meno frequente.
    • Le nuove versioni della tua app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi mobili 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 influenzano ciascuno dei loro progetti. Rimani al corrente di aggiornamenti importanti, 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. Places SDK for Android rispetta il versioning semantico e le nuove versioni principali potrebbero includere modifiche che causano interruzioni. Il livello API minimo supportato è 24.

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:4.3.1")
}

Manutenzione e 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 all'ultima versione disponibile il prima possibile. Se esegui l'aggiornamento a una nuova versione principale, controlla le note di rilascio per le modifiche incompatibili con le versioni precedenti e 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 influire sui 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.

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 (New) nella chiave API utilizzata nella tua app. Per saperne di più, consulta 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.5.0'
  }

    Per saperne di più sulla dipendenza kotlin-bom, consulta Utilizzo dell'ultima versione di kotlin-stdlib nelle dipendenze transitive.

  3. Aggiorna l'app esistente per chiamare il nuovo metodo Places.initializeWithNewPlacesApiEnabled() per inizializzare l'app. Per maggiori informazioni, consulta Inizializzare il client dell'API Places.

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