Flutter 相容性政策

Flutter 團隊致力於在 API 穩定性與持續演進 API（以修復錯誤、提升 API 易用性，以及有條理地提供新功能）之間取得平衡。

為此，我們建立了一個測試註冊機制，讓你可以提供自己的應用程式或函式庫的單元測試。我們會在每次變更時執行這些測試，以協助追蹤可能導致現有應用程式失效的變更。我們的承諾是：在未與這些測試的開發者合作（a）判斷此變更是否具有足夠價值，以及（b）針對程式碼提供修正以確保測試持續通過之前，不會進行任何會導致這些測試失敗的變更。

如果你希望參與此計畫並提供測試，請提交 PR 至 flutter/tests repository。 該儲存庫的 README 詳細說明了相關流程。

如果我們確實進行了破壞性變更（定義為導致一個或多個已提交測試需要修改的變更），我們會在 flutter-announce 郵件論壇以及版本發行說明中公告此變更。

我們也會提供受破壞性變更影響的程式碼遷移指南列表。

我們有時會選擇將某些 API 標記為已停用，而非直接在短時間內移除。這與我們的相容性政策無關，後者僅根據上述提交測試是否失敗來判斷。

Flutter 團隊不會依照固定時程移除已停用的 API。 若團隊決定移除已停用的 API，會遵循與破壞性變更相同的程序。

Dart 語言本身有獨立的破壞性變更政策， 相關公告會發佈於 Dart announce。

一般而言，Flutter 團隊目前對於其他相依套件的破壞性變更沒有特別承諾。 例如，若新版 Flutter 採用新版 Skia （某些 Flutter 平台所使用的圖形引擎） 或 Harfbuzz（Flutter 所使用的字型排版引擎）， 可能會導致影響已提交測試的變更。 這類變更未必會附帶遷移指南。