Skip to content

Kotlin 組件的穩定性 ​

Kotlin 語言和工具集被劃分為許多組件,例如針對 JVM、JS 和 Native 目標的編譯器、標準庫(Standard Library)、各種附帶工具等等。 這些組件中的許多已經正式發佈為 Stable,這意味著它們遵循_舒適升級_與_保持語言現代化_的原則以回溯相容的方式演進。

遵循_回饋循環(Feedback Loop)_原則,我們會提早發佈許多內容供社群試用, 因此許多組件尚未作為 Stable 發佈。 其中一些處於非常早期的階段,一些則相對成熟。 我們根據每個組件的演進速度以及使用者採用時所承擔的風險程度,將它們標記為 Experimental、Alpha 或 Beta。

穩定性級別說明 ​

以下是有關這些穩定性級別及其含義的快速指南:

Experimental 意味著「僅在實驗性(toy)專案中試用」:

  • 我們只是在測試一個想法及其可行性。我們希望一些使用者能夠試用並分享他們的回饋。 其範圍是最小限度的,且該功能可能隨時更改或消失。我們不保證穩定性或相容性。

Alpha 意味著「我們正在測試這是否應該達到生產就緒(production-ready)狀態」:

  • 我們打算將其轉化為產品,並正在驗證其使用者價值和市場適配度以塑造其最終形式。 功能集仍不完整,預計會有破壞性變更(breaking changes)。如果假設不成立, 我們可能會大幅更改或中止該功能。

Beta 意味著「你可以使用它,我們將盡最大努力為你將遷移問題降至最低」:

  • 它幾乎已經完成,現在使用者回饋尤其重要。
  • 不過,它尚未 100% 完成,因此仍可能會發生變更(包括根據你自己的回饋進行的變更)。
  • 請提前關注棄用警告,以獲得最佳的更新體驗。

我們統稱 Experimental、Alpha 和 Beta 為 pre-stable 級別。

Stable 意味著「即使在最保守的情境下也可以使用」:

請注意,穩定性級別並不代表該組件多快會以 Stable 形式發佈。同樣地,它們也不代表組件在發佈前會做多大程度的修改。它們僅表示組件變化的速度,以及使用者面臨更新問題的風險程度。

Kotlin 組件的 GitHub 徽章 ​

Kotlin GitHub 組織託管著各類與 Kotlin 相關的專案。 其中一些專案我們全職進行開發,而另一些則是附屬專案。

每個 Kotlin 專案都有兩個描述其穩定性與支援狀態的 GitHub 徽章:

  • Stability(穩定性)狀態。這顯示了每個專案演進的速度,以及使用者採用它時所承擔的風險。 穩定性狀態與 Kotlin 語言特性及其組件的穩定性級別完全一致:

    • Experimental stability level 代表 Experimental
    • Alpha stability level 代表 Alpha
    • Beta stability level 代表 Beta
    • Stable stability level 代表 Stable
  • Support(支援)狀態。這表明我們維護專案以及協助使用者解決問題的承諾程度。 所有 JetBrains 產品的支援級別都是統一的。
    詳細資訊請參閱 JetBrains 開源文件。

子組件的穩定性 ​

一個穩定的組件可能包含實驗性的子組件,例如:

  • 穩定的編譯器可能包含實驗性功能;
  • 穩定的 API 可能包含實驗性的類別或函式;
  • 穩定的命令列工具可能具有實驗性選項。

我們會確保精確地記錄哪些子組件不是 Stable。 我們還會盡最大努力在可能的情況下向使用者發出警告,並要求顯式啟用(opt in)它們, 以避免意外使用未作為穩定版發佈的功能。

Kotlin 組件目前的穩定性 ​

預設情況下,所有新組件的狀態均為 Experimental。

Kotlin 編譯器 ​

組件狀態起始版本備註
Kotlin/JVMStable1.0.0
Kotlin/NativeStable1.9.0
Kotlin/JSStable1.3.0
Kotlin/WasmBeta2.2.20
Analysis APIStable

核心編譯器外掛程式 ​

組件狀態起始版本備註
All-openStable1.3.0
No-argStable1.3.0
SAM-with-receiverStable1.3.0
kaptStable1.3.0
LombokAlpha2.3.20
Power-assertExperimental2.0.0

Kotlin 程式庫 ​

組件狀態起始版本備註
kotlin-stdlib (JVM)Stable1.0.0
kotlinx-coroutinesStable1.3.0
kotlinx-serializationStable1.0.0
kotlin-metadata-jvmStable2.0.0
kotlin-reflect (JVM)Beta1.0.0
kotlinx-datetimeAlpha0.2.0
kotlinx-ioAlpha0.2.0
kotlinx-collections-immutableAlpha0.3.5

Kotlin Multiplatform ​

組件狀態起始版本備註
Kotlin MultiplatformStable1.9.20
Kotlin Multiplatform IDE pluginStable0.9與語言版本獨立分開管理

Kotlin/Native ​

組件狀態起始版本備註
Kotlin/Native RuntimeStable1.9.20
Kotlin/Native interop with C and Objective-CBeta1.3.0C 與 Objective-C 程式庫匯入的穩定性
klib 二進位檔Stable1.9.20不包含 cinterop klib,詳見下方說明
cinterop klib 二進位檔Beta1.3.0C 與 Objective-C 程式庫匯入的穩定性
CocoaPods 整合Stable1.9.20

有關不同目標支援級別的更多資訊,請參閱 Kotlin/Native 支援的目標與主機。

建置工具 ​

組件狀態起始版本備註
Kotlin Gradle pluginStable1.1.1Kotlin Multiplatform Gradle plugin 自 Kotlin 1.9.20 起達到穩定狀態。
Kotlin Maven pluginStable1.0.0

建置工具 API (BTA) ​

組件狀態起始版本備註
BTA for JVMBeta2.4.20
BTA for JSAlpha2.4.20
BTA for WasmAlpha2.4.20

建置工具 API 目前不支援 Kotlin/Native。

語言工具 ​

組件狀態起始版本備註
指令碼語法與語意Alpha1.2.0
指令碼嵌入與擴充 APIBeta1.5.0
指令碼 IDE 支援Beta自 IntelliJ IDEA 2023.1 及更新版本起提供支援
CLI 指令碼Alpha1.2.0

語言特性與設計提案 ​

有關語言特性和新設計提案,請參閱 Kotlin 語言特性與提案。