Android Driver SDK 6.0 遷移指南

遷移至 DriverStatusListener 介面

在 Driver 5.0 中，我們宣布 StatusListener 介面已淘汰，改用 DriverStatusListener。今年，我們將正式刪除 StatusListener 介面。如需新介面遷移指南，請參閱 StatusListener 淘汰公告。

遷移至 Kotlin 2.0

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

Gradle 和 AGP 相容性

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

Driver SDK 6.0 以上版本的 AGP 最低版本

建議您搭配使用 AGP 7.3 以上版本和 Driver SDK 6.0。

完整 R8 模式

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

# settings.gradle
android.enableR8.fullMode=false

Kotlin 版本相容性

Kotlin 支援與前三個語言版本的回溯相容性。也就是說，如果您已使用 Driver 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 在各個版本的相容性指南中，提供重大變更清單和可設定的標記，以便保留原始行為：