Android Consumer SDK 3.0 遷移指南

遷移至 Kotlin 2.0

如果您使用的是 Consumer SDK for Android 3.0 以上版本，則必須升級至 Kotlin 2.0。本頁面提供指南，協助您輕鬆轉換至新的 Kotlin 版本。

Gradle 和 AGP 相容性

Kotlin 2.0 對 Gradle 和 Android Gradle 外掛程式 (AGP) 版本有最低和最高版本需求。請確認專案符合 Kotlin 2.0 的這些需求。

消費者 SDK 3.0 以上版本的 AGP 最低版本

消費者 SDK 3.0 需要使用 AGP 7.3 以上版本。

完整 R8 模式

Consumer SDK 3 以下版本不支援 Full R8 模式。如果應用程式指定 AGP 8.0 以上版本，則必須明確停用 Full R8 模式。

# settings.gradle
android.enableR8.fullMode=false

Kotlin 版本相容性

Kotlin 支援與前三個語言版本的回溯相容性。也就是說，如果您已使用 Consumer SDK 搭配 Kotlin 1.7 以上版本，應該就能升級至 Kotlin 2.0，而無須解決所有重大變更。不過，Kotlin 相容性僅適用於穩定的語言功能。如果您使用的是 Kotlin 語言的 Alpha 版、Beta 版或實驗性功能，則在升級時可能需要進行其他變更。

Kotlin 相容性標記

如前文所述，Kotlin 在升級時最多可支援 3 個舊版語言。Kotlin 提供兩個旗標，可協助限制破壞性變更：

language-version X.Y

這個標記會將破壞變更還原為舊版 Kotlin 的行為。舉例來說，如果您使用的是 Kotlin 1.7，可以指定 [ - language-version 1.7]，這樣就不會再套用新的重大異動：

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

這個標記可防止在依附的下游程式碼準備好納入 Kotlin 2.0 之前，使用新的 API。

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

更精準的做法

除了使用 Kotlin 相容性標記之外，我們建議您查看 Kotlin 發布說明，並選擇要從要升級的版本保留哪些行為。Kotlin 在各個版本的相容性指南中，提供重大變更清單和可設定的標記，以便保留原始行為：