# Flutter 相容性政策

> Flutter 如何處理破壞性變更的相關政策說明。



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

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

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

[flutter/tests repository]: https://github.com/flutter/tests
[flutter-tests-readme]: https://github.com/flutter/tests#adding-more-tests

## 公告與遷移指南

在實作重大的破壞性變更之前，
Flutter 團隊會透過 [`flutter/rfc` repository][flutter-rfc] 中的
意見徵求（Requests for Comments，RFC）公開提出並審查設計。
如果我們確實進行了破壞性變更（定義為導致一個或多個已提交測試需要修改的變更），我們會在 [flutter-announce][flutter-announce]
郵件論壇以及版本發行說明中公告此變更。

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

[flutter-rfc]: https://github.com/flutter/rfc
[flutter-announce]: https://groups.google.com/forum/#!forum/flutter-announce
[guides for migrating code]: /release/breaking-changes

## 停用（Deprecation）政策

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

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


## Dart 及 Flutter 所使用的其他函式庫

Dart 語言本身有[獨立的破壞性變更政策][separate breaking-change policy]，
相關公告會發佈於 [Dart announce][Dart announce]。

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

[separate breaking-change policy]: https://github.com/dart-lang/sdk/blob/main/docs/process/breaking-changes.md
[Dart announce]: https://groups.google.com/a/dartlang.org/g/announce

