From f0322b573c56fdc2db84396b86d1e1708f0d8d2b Mon Sep 17 00:00:00 2001 From: Jun Shindo <46585162+jay-es@users.noreply.github.com> Date: Thu, 6 Nov 2025 19:31:58 +0900 Subject: [PATCH] docs(features): add license section --- config/build-options.md | 23 +++-------------------- guide/features.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 20 deletions(-) diff --git a/config/build-options.md b/config/build-options.md index 651d9e24..72143457 100644 --- a/config/build-options.md +++ b/config/build-options.md @@ -189,28 +189,11 @@ export default defineConfig({ - **型:** `boolean | { fileName?: string }` - **デフォルト:** `false` +- **関連:** [License](/guide/features#license) -`true` に設定すると、ビルドによってバンドルされたすべての依存関係のライセンスを含む `.vite/license.md` ファイルが生成されます。これをホストして、アプリで使用されている依存関係を表示および承認できます。`fileName` を渡すと、`outDir` からの相対パスでライセンスファイル名として使用されます。出力例は次のようになります: +`true` に設定すると、ビルドによってバンドルされたすべての依存関係のライセンスを含む `.vite/license.md` ファイルが生成されます。 -```md -# Licenses - -The app bundles dependencies which contain the following licenses: - -## dep-1 - 1.2.3 (CC0-1.0) - -CC0 1.0 Universal - -... - -## dep-2 - 4.5.6 (MIT) - -MIT License - -... -``` - -`fileName` が `.json` で終わる場合、代わりに生の JSON メタデータが生成され、さらなる処理に使用できます。たとえば: +`fileName` を渡すと、`outDir` からの相対パスでライセンスファイル名として使用されます。これが `.json` で終わる場合、代わりに生の JSON メタデータが生成され、さらなる処理に使用できます。たとえば: ```json [ diff --git a/guide/features.md b/guide/features.md index 6f0bc9f7..ad502d14 100644 --- a/guide/features.md +++ b/guide/features.md @@ -789,6 +789,42 @@ CSP をデプロイするには、Vite 内部の理由により、特定のデ [`script-src`](https://developer.mozilla.org/ja/docs/Web/HTTP/Headers/Content-Security-Policy/script-src) に対して `data:` を許可してはいけません。任意のスクリプトのインジェクションを許してしまうことになります。 ::: +## License + +Vite は [`build.license`](/config/build-options.md#build-license) オプションを使用して、ビルドで使用されるすべての依存関係のライセンスのファイルを生成できます。これをホストして、アプリで使用されている依存関係を表示および承認できます。 + +```js twoslash [vite.config.js] +import { defineConfig } from 'vite' + +export default defineConfig({ + build: { + license: true, + }, +}) +``` + +これにより、次のような出力の `.vite/license.md` ファイルが生成されます: + +```md +# Licenses + +The app bundles dependencies which contain the following licenses: + +## dep-1 - 1.2.3 (CC0-1.0) + +CC0 1.0 Universal + +... + +## dep-2 - 4.5.6 (MIT) + +MIT License + +... +``` + +異なるパスでファイルを提供するには、たとえば `{ fileName: 'license.md' }` を渡すことで、`https://example.com/license.md` で提供されるようになります。詳細については、[`build.license`](/config/build-options.md#build-license) ドキュメントを参照してください。 + ## ビルドの最適化 {#build-optimizations} > 以下にリストされている機能は、ビルドプロセスの一部として自動的に適用され、無効にする場合を除いて、明示的に設定する必要はありません。