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

  • 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 rilevi 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 per il supporto mobile. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK non compatibile per usufruire delle correzioni.
    • I miglioramenti e le funzionalità più recenti sono facili da adottare quando la tua 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, collega a qualsiasi versione fissa. Quando ricevi una notifica di ritiro per la versione fissa, avrai 12 mesi di tempo per rendere disponibile agli utenti il codice dell'app aggiornato.

    Vantaggi:

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

I Project Owner con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Rimani al corrente di 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, perché questi possono portare a build imprevedibili e non ripetibili. Places SDK for Android rispetta il controllo delle versioni semantico e le nuove versioni principali potrebbero includere modifiche che provocano un errore. Il livello API minimo supportato è 24.

dependencies {

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

Manutenzione e upgrade

Android Studio controlla automaticamente la disponibilità di versioni più recenti e fornisce 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 stai eseguendo l'aggiornamento a una nuova versione principale, controlla le note di rilascio per verificare la presenza di modifiche incompatibili con le versioni precedenti e scoprire come aggiornare il codice.

Oltre a eseguire il polling per le versioni più recenti, i Project Owner di Google Cloud ricevono email relative alle 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 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 passare al nuovo SDK. Devi solo:

  1. Abilita l'API Places (novità) sulla 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 saperne di più, consulta Inizializza il client API Places.

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