Guida alla migrazione all'SDK consumer per Android 3.0

Esegui la migrazione a Kotlin 2.0

Se utilizzi Consumer SDK per Android 3.0 o versioni successive, devi eseguire l'upgrade a Kotlin 2.0. Questa pagina fornisce indicazioni per semplificare la transizione alla nuova versione di Kotlin.

Compatibilità di Gradle e AGP

Kotlin 2.0 ha requisiti per le versioni minima e massima di Gradle e del plug-in Android per Gradle (AGP). Assicurati che il tuo progetto soddisfi questi requisiti per Kotlin 2.0.

Versione minima di AGP per Consumer SDK 3.0 e versioni successive

Consumer SDK 3.0 richiede l'utilizzo di AGP 7.3 o versioni successive.

Modalità R8 completa

Consumer SDK v3 e versioni precedenti non supportano la modalità R8 completa. Devi disattivare esplicitamente la modalità R8 completa se la tua applicazione è destinata ad AGP 8.0 o versioni successive.

# settings.gradle
android.enableR8.fullMode=false

Compatibilità della versione di Kotlin

Kotlin supporta la compatibilità con le versioni precedenti con tre versioni precedenti della lingua versioni. Ciò significa che, se utilizzi già Kotlin 1.7 o versioni successive con Consumer SDK, dovresti essere in grado di eseguire l'upgrade a Kotlin 2.0 senza dover risolvere tutte le modifiche che provocano un errore. Tuttavia, la compatibilità di Kotlin si applica solo alle funzionalità di linguaggio stabili features. Se utilizzi funzionalità alfa, beta o sperimentali nel linguaggio Kotlin, potresti dover apportare modifiche aggiuntive durante l'upgrade.

Flag di compatibilità di Kotlin

Come indicato nella sezione precedente, Kotlin supporta fino a 3 versioni precedenti della lingua durante l'upgrade. Kotlin fornisce due flag per limitare le modifiche che causano interruzioni:

language-version X.Y

Questo flag ripristina le modifiche che causano interruzioni al comportamento di una versione precedente di Kotlin. Ad esempio, se utilizzi Kotlin 1.7, puoi specificare [ - language-version 1.7] e le nuove modifiche che provocano un errore non avranno più effetto:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

Questo flag impedisce l'utilizzo di nuove API prima che il codice downstream dipendente sia pronto per incorporare Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Un approccio più mirato

Oltre a utilizzare i flag di compatibilità di Kotlin, ti consigliamo di esaminare le note di rilascio di Kotlin e scegliere i comportamenti che vuoi conservare dalla versione da cui stai eseguendo l'upgrade. Kotlin fornisce un elenco di modifiche che causano interruzioni e i flag che possono essere impostati per mantenere il comportamento originale nelle guide alla compatibilità per ogni versione: