<

flutter互換性ポリシー

Flutter チームは、API の安定性の必要性と、 バグを修正し、API の人間工学を改善するために API を進化させ続ける必要がある 一貫した方法で新機能を提供します。

この目的のために、私たちはテスト レジストリを作成しました。 弊社が実行する独自のアプリケーションまたはライブラリの単体テスト すべての変更について、壊れる可能性のある変更を追跡するのに役立ちます 既存のアプリケーション。私たちの約束は、何もしないことです 開発者と協力せずにこれらのテストを壊すような変更は、 これらのテストは、(a) 変更が十分に価値があるかどうかを判断するためのものです。 (b) テストが引き続き合格できるようにコードを修正します。

このプログラムの一部としてテストを提供したい場合は、 PR を次の宛先に提出します。 flutter/テストリポジトリ。 README.md ファイル そのリポジトリにはプロセスが詳細に記載されています。

お知らせと移行ガイド

重大な変更 (重大な変更を引き起こす変更として定義) を行った場合、 またはこれらの提出されたテストの一部に変更が必要な場合は、発表します。 私たちの変化 flutterアナウンスメーリング リストおよびリリース ノートに記載されています。

のリストを提供しますコードを移行するためのガイド影響を受ける 重大な変更。

非推奨ポリシー

場合によっては、完全に廃止するのではなく、特定の API を廃止することがあります。 一晩で壊してください。これは互換性ポリシーとは無関係です これは、送信されたテストが失敗するかどうかのみに基づいています。 上で説明した。

非推奨の API は、移行猶予期間後に削除されます。この恵み 期間は安定したチャネルでリリースされてから 1 暦年です。 または 4 つの安定版リリース後のいずれか長い方です。

非推奨がサポート終了になった場合も、同じ手順に従います。 非推奨の API を削除する際に重大な変更を加えるために上記にリストしたものを参照してください。

Flutter で使用される Dart およびその他のライブラリ

Dart 言語自体には、個別の重大な変更ポリシー、 アナウンスありダーツアナウンス。

一般に、Flutter チームには現在何のコミットメントもありません 他の依存関係の重大な変更について。 たとえば、新しいバージョンの 新しいバージョンの Skia を使用した Flutter (Flutter の一部のプラットフォームで使用されるグラフィックス エンジン) または Harfbuzz (Flutter で使用されるフォント整形エンジン) 提供されたテストに影響を与える変更が含まれる可能性があります。 このような変化には必ずしも次のような変化が伴うとは限りません。 移行ガイド。