Skip to content

Commit 561bf46

Browse files
jay-esjay-es
authored
docs: update environment api as release candidate (#2050)
1 parent 2ab8b33 commit 561bf46

File tree

6 files changed

+25
-16
lines changed

6 files changed

+25
-16
lines changed

‎changes/index.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,17 @@ API の非推奨、削除、変更を含む、Vite の変更点のリストで
66

77
これらの変更は Vite の次のメジャーバージョンで予定されています。非推奨または使用上の警告は、可能な限りガイドし、私たちはこれらの変更を適用するようフレームワーク、プラグイン作者、ユーザーに働きかけています。
88

9-
- _まだ変更予定はありません_
9+
- [フック内の `this.environment`](/changes/this-environment-in-hooks)
10+
- [HMR `hotUpdate` プラグインフック](/changes/hotupdate-hook)
11+
- [`ModuleRunner` API を使った SSR](/changes/ssr-using-modulerunner)
1012

1113
## 検討中
1214

1315
これらの変更は検討中であり、現在の使用パターンを改善するための実験的な API であることが多いです。すべての変更がここに記載されているわけではないので、完全なリストについては [Vite GitHub ディスカッションの experimental ラベル](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=label%3Aexperimental+category%3AFeedback) を確認してください。
1416

1517
これらの API に切り替えることはまだお勧めしません。これらの API はフィードバックを集めるために Vite に含まれています。これらの提案を確認し、あなたのユースケースでどのように機能するか、それぞれのリンク先の GitHub Discussions でお知らせください。
1618

17-
- [フック内の `this.environment`](/changes/this-environment-in-hooks)
18-
- [HMR `hotUpdate` プラグインフック](/changes/hotupdate-hook)
1919
- [環境ごとの API への移行](/changes/per-environment-apis)
20-
- [`ModuleRunner` API を使った SSR](/changes/ssr-using-modulerunner)
2120
- [ビルド時の共有プラグイン](/changes/shared-plugins-during-build)
2221

2322
## 過去

‎guide/api-environment-frameworks.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# フレームワーク向けの Environment API
22

3-
:::warning 実験的機能
4-
Environment API は実験的なものです。エコシステムでの実験と開発を可能にするため、メジャーリリース間の API の安定性は維持されます。ダウンストリームプロジェクトが新機能を実験して検証した後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
3+
:::info Release Candidate
4+
Environment API は一般的にリリース候補段階にあります。エコシステムがそれらを実験し、構築できるように、メジャーリリース間での API の安定性を維持します。ただし、[一部の特定の API](/changes/#considering) はまだ実験的であることに注意してください。
5+
6+
ダウンストリームプロジェクトが新しい機能を実験し、それらを検証する時間を持った後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
57

68
リソース:
79

‎guide/api-environment-instances.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# `Environment` インスタンスの使用
22

3-
:::warning 実験的機能
4-
Environment API は実験的なものです。エコシステムでの実験と開発を可能にするため、メジャーリリース間の API の安定性は維持されます。ダウンストリームプロジェクトが新機能を実験して検証した後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
3+
:::info Release Candidate
4+
Environment API は一般的にリリース候補段階にあります。エコシステムがそれらを実験し、構築できるように、メジャーリリース間での API の安定性を維持します。ただし、[一部の特定の API](/changes/#considering) はまだ実験的であることに注意してください。
5+
6+
ダウンストリームプロジェクトが新しい機能を実験し、それらを検証する時間を持った後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
57

68
リソース:
79

‎guide/api-environment-plugins.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# プラグイン向けの Environment API
22

3-
:::warning 実験的機能
4-
Environment API は実験的なものです。エコシステムでの実験と開発を可能にするため、メジャーリリース間の API の安定性は維持されます。ダウンストリームプロジェクトが新機能を実験して検証した後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
3+
:::info Release Candidate
4+
Environment API は一般的にリリース候補段階にあります。エコシステムがそれらを実験し、構築できるように、メジャーリリース間での API の安定性を維持します。ただし、[一部の特定の API](/changes/#considering) はまだ実験的であることに注意してください。
5+
6+
ダウンストリームプロジェクトが新しい機能を実験し、それらを検証する時間を持った後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
57

68
リソース:
79

‎guide/api-environment-runtimes.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# ランタイム向けの Environment API
22

3-
:::warning 実験的機能
4-
Environment API は実験的なものです。エコシステムでの実験と開発を可能にするため、メジャーリリース間の API の安定性は維持されます。ダウンストリームプロジェクトが新機能を実験して検証した後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
3+
:::info Release Candidate
4+
Environment API は一般的にリリース候補段階にあります。エコシステムがそれらを実験し、構築できるように、メジャーリリース間での API の安定性を維持します。ただし、[一部の特定の API](/changes/#considering) はまだ実験的であることに注意してください。
5+
6+
ダウンストリームプロジェクトが新しい機能を実験し、それらを検証する時間を持った後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
57

68
リソース:
79

‎guide/api-environment.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# Environment API
22

3-
:::warning 実験的機能
4-
Environment API は実験的なものです。エコシステムでの実験と開発を可能にするため、メジャーリリース間の API の安定性は維持されます。ダウンストリームプロジェクトが新機能を実験して検証した後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
3+
:::info Release Candidate
4+
Environment API は一般的にリリース候補段階にあります。エコシステムがそれらを実験し、構築できるように、メジャーリリース間での API の安定性を維持します。ただし、[一部の特定の API](/changes/#considering) はまだ実験的であることに注意してください。
5+
6+
ダウンストリームプロジェクトが新しい機能を実験し、それらを検証する時間を持った後、将来のメジャーリリースでこれらの新しい API を安定化する予定です（破壊的変更を含む可能性あり）。
57

68
リソース:
79

@@ -13,7 +15,7 @@ Environment API は実験的なものです。エコシステムでの実験と
1315

1416
## 環境の形式化 {#formalizing-environments}
1517

16-
Vite 6 では、環境の概念が正式化されました。Vite 5 までは、暗黙的な環境が 2 つ（`client` と省略可能な `ssr`）が存在していました。新しい Environment API を使用すると、ユーザーは必要な数の環境を作成して、アプリが本番環境でどのように動作するかをマッピングできます。この新しい機能には大規模な内部リファクタリングが必要でしたが、後方互換性にも多大な努力が払われました。Vite 6 の当初の目標は、エコシステムをできるだけスムーズに新しいメジャーに移行することであり、十分な数のユーザーが移行し、フレームワークとプラグインの作成者が新しい設計を検証するまで、これらの新しい実験的な API の採用を遅らせます。
18+
Vite 6 では、環境の概念が正式化されました。Vite 5 までは、暗黙的な環境が 2 つ（`client` と省略可能な `ssr`）が存在していました。新しい Environment API を使用すると、ユーザーは必要な数の環境を作成して、アプリが本番環境でどのように動作するかをマッピングできます。この新しい機能には大規模な内部リファクタリングが必要でしたが、後方互換性にも多大な努力が払われました。Vite 6 の当初の目標は、エコシステムをできるだけスムーズに新しいメジャーに移行することであり、十分な数のユーザーが移行し、フレームワークとプラグインの作成者が新しい設計を検証するまで、これらの API の採用を遅らせます。
1719

1820
## ビルドと開発中のギャップを埋める {#closing-the-gap-between-build-and-dev}
1921

@@ -117,7 +119,7 @@ export default {
117119

118120
## 後方互換性 {#backward-compatibility}
119121

120-
現在の Vite サーバーAPI はまだ非推奨ではなく、Vite 5 との後方互換性があります。新しい Environment API は実験的なものです。
122+
現在の Vite サーバーAPI はまだ非推奨ではなく、Vite 5 との後方互換性があります。
121123

122124
`server.moduleGraph` はクライアントと ssr のモジュールグラフの混合ビューを返します。後方互換性のある混合モジュールノードがすべてのメソッドから返されます。同じスキームが `handleHotUpdate` に渡されるモジュールノードにも使用されます。
123125

0 commit comments

Comments
 (0)