From a514db4a0304fbced64f0f9774ffb02c6f625659 Mon Sep 17 00:00:00 2001 From: Jun Shindo <46585162+jay-es@users.noreply.github.com> Date: Thu, 12 Sep 2024 20:57:43 +0900 Subject: [PATCH] feat: Environment API 4/4 --- .vitepress/config.ts | 43 ++++++++++++++++++++++++++++++++++++++++ config/build-options.md | 9 ++++++++- config/shared-options.md | 9 +++++++++ guide/cli.md | 1 + 4 files changed, 61 insertions(+), 1 deletion(-) diff --git a/.vitepress/config.ts b/.vitepress/config.ts index 1c9251d7..fa98e581 100644 --- a/.vitepress/config.ts +++ b/.vitepress/config.ts @@ -272,6 +272,10 @@ export default defineConfig({ text: 'v4 からの移行', link: '/guide/migration', }, + { + text: '破壊的変更', + link: '/changes/', + }, ], }, { @@ -339,6 +343,45 @@ export default defineConfig({ ], }, ], + '/changes/': [ + { + text: '破壊的変更', + link: '/changes/', + }, + { + text: '現在', + items: [], + }, + { + text: '将来', + items: [ + { + text: 'フック内の this.environment', + link: '/changes/this-environment-in-hooks', + }, + { + text: 'HMR hotUpdate プラグインフック', + link: '/changes/hotupdate-hook', + }, + { + text: '環境ごとの API への移行', + link: '/changes/per-environment-apis', + }, + { + text: 'ModuleRunner API を使った SSR', + link: '/changes/ssr-using-modulerunner', + }, + { + text: 'ビルド時の共有プラグイン', + link: '/changes/shared-plugins-during-build', + }, + ], + }, + { + text: '過去', + items: [], + }, + ], }, outline: { diff --git a/config/build-options.md b/config/build-options.md index 6375b7b5..5b75691c 100644 --- a/config/build-options.md +++ b/config/build-options.md @@ -192,12 +192,19 @@ CSS コード分割を有効/無効にします。有効にすると、非同期 SSR 向けのビルドを生成します。この値は、SSR エントリーを直接指定する文字列か、`true` にして `rollupOptions.input` で SSR エントリーを指定する必要があります。 +## build.emitAssets + +- **型:** `boolean` +- **デフォルト:** `false` + +クライアント以外のビルド時、静的アセットはクライアントビルドの一部として生成されると仮定されているため、出力されません。このオプションは、フレームワークが他の環境のビルドで静的アセットを強制的に出力することを可能にします。ビルド後のステップでアセットをマージするのはフレームワークの責任です。 + ## build.ssrEmitAssets - **型:** `boolean` - **デフォルト:** `false` -SSR ビルドの間、静的アセットはクライアントビルドの一部として出力されると想定されているため、出力されません。このオプションを使用すると、フレームワークはクライアントと SSR ビルドの両方でアセットを出力することを強制できます。フレームワークは、ビルド後のステップでアセットをマージする責任があります。 +SSR ビルドの間、静的アセットはクライアントビルドの一部として出力されると想定されているため、出力されません。このオプションを使用すると、フレームワークはクライアントと SSR ビルドの両方でアセットを出力することを強制できます。フレームワークは、ビルド後のステップでアセットをマージする責任があります。このオプションは Environment API が安定したら `build.emitAssets` に置き換えられます。 ## build.minify diff --git a/config/shared-options.md b/config/shared-options.md index 2787e8d7..10e4a07c 100644 --- a/config/shared-options.md +++ b/config/shared-options.md @@ -490,3 +490,12 @@ define: { - `'custom'`: HTML ミドルウェアを含めない 詳細は Vite の [SSR ガイド](/guide/ssr#vite-cli) 参照してください。関連: [`server.middlewareMode`](./server-options#server-middlewaremode)。 + +## future + +- **型:** `Record` +- **関連:** [破壊的変更](/changes/) + +Vite の次期メジャーバージョンへのスムーズな移行に備え、将来的な破壊的変更を可能にします。このリストは、新機能の開発に伴い、いつでも更新、追加、削除される可能性があります。 + +設定可能なオプションの詳細については、[破壊的変更](/changes/) ページを参照してください。 diff --git a/guide/cli.md b/guide/cli.md index 44265e3b..18cfaac7 100644 --- a/guide/cli.md +++ b/guide/cli.md @@ -69,6 +69,7 @@ vite build [root] | `-f, --filter ` | デバッグログをフィルタリングする（`string`） | | `-m, --mode ` | env モードを設定する（`string`） | | `-h, --help` | 利用可能な CLI オプションを表示する | +| `--app` | すべての環境をビルドする。`builder.entireApp` と同じ。（`boolean`、実験的機能） | ## その他