
# ビルド

`dart run spring_boot_starter_edge:build` はアプリケーションをコンパイルし (`dart compile js -O2 -DSPRING_ALL_PLATFORMS=true`)、その隣にプラットフォームのエントリーファイルを書きます。どれも手で書くものではなく、コミットするものでもありません。

```bash
dart run build_runner build
dart run spring_boot_starter_edge:build --platform supabase --name api
```

## 書かれるもの

| `--platform` | 書き込み先 | ファイル | デプロイ |
|---|---|---|---|
| `supabase` | `supabase/functions/<name>/` | `index.ts`、`main.js`、`prelude.js` | `supabase functions deploy <name>` |
| `cloudflare` | `build/cloudflare/` | `worker.mjs`、`main.js`、`prelude.js`。`wrangler.toml` はアプリケーションのディレクトリに (一度だけ) | `npx wrangler deploy` |
| `aws` | `build/aws/` | `index.mjs`、`main.cjs`、`prelude.js` | ディレクトリを zip にする。ランタイムは Node.js 22、ハンドラーは `index.handler` |
| `deno` | `build/deno/` | `main.ts`、`main.js`、`prelude.js` | `main.ts` をエントリーポイントにして Deno Deploy へ。それ以外では `deno run -A main.ts` (`PORT`) |
| `netlify` | `netlify/edge-functions/<name>/` | `index.js`、`main.js`、`prelude.js` | Netlify のビルドがコマンドを実行する |
| `vercel` | `build/vercel/` | `index.mjs`、`main.cjs`、`prelude.js` | Vercel プロジェクトの関数 (その `fetch` エクスポート) |

## オプション

| オプション | |
|---|---|
| `--name`、`-n` | 関数の名前。デフォルトは `api`。Supabase と Netlify ではそのディレクトリ名、Supabase ではさらにパスの最初のセグメント、新しい `wrangler.toml` ではワーカーの名前 |
| `--target`、`-t` | `js` (デフォルト) または `wasm` |
| `--entry` | `main` のある Dart ファイル。デフォルトは `bin/main.dart` |
| `--output`、`-o` | 関数のディレクトリ |
| `--optimization` | コンパイラーの `-O` レベル。0 から 4 で、デフォルトは 2 |
| `--dart` | コンパイルに使う `dart`。デフォルトは PATH 上の `dart`。Supabase 向けの WebAssembly には Dart 3.13 のものが必要 |
| `--streaming` | AWS: レスポンスストリーミングのハンドラー ([AWS Lambda](aws.md) を参照) |
| `--path` | Netlify: 関数が応答するパス。デフォルトは `/*` |
| `-D<name>=<value>` | コンパイラーへの定義 |

## サイズ

Web スターターとセキュリティスターターを持つ関数は、約 1.8 MB の JavaScript (gzip で 0.6 MB) です。コンテキストは、プラットフォームによって 50 から 250 ms で起動します。

## WebAssembly

`--target wasm` は `dart compile wasm` (WasmGC) でコンパイルします。`app.wasm` (約 1.7 MB) とその `app.mjs`、そしてスクリプトの代わりに小さなローダーが書かれ、エントリーファイルは同じです。アプリケーションのコードは変わりません。

> [!WARNING]
> **Supabase の WebAssembly は、当面 Dart 3.13 でコンパイルしたものだけ動きます。** Supabase の Edge Runtime は Deno 2.1 で、その V8 (13.0) には、Dart 3.14 (Flutter 3.50) 以降の `dart compile wasm` が使う WebAssembly の例外処理 (`exnref`) がありません。Supabase が更新するまでは、関数を Dart 3.13 でコンパイルしてください: `--dart <Dart 3.13 SDK の dart>`。新しい Dart でのビルドは理由とともに拒否されます。JavaScript はどの Dart でも動き、WebAssembly もほかのプラットフォームではどの Dart でも動きます。

| プラットフォーム | WebAssembly |
|---|---|
| Supabase | Supabase が Edge Runtime を更新するまでは、Dart 3.13 でコンパイルしたものだけ。Edge Runtime は Deno 2.1 で、その V8 (13.0) には、Dart 3.14 以降の `dart compile wasm` が使う WebAssembly の例外処理 (`exnref`) がありません。`--dart <Dart 3.13 SDK の dart>` でビルドし (ビルド自体はどの Dart でも動きます。新しい Dart は理由とともに拒否されます)、`config.toml` にモジュールを列挙します: `[functions.<name>] static_files = ["./functions/<name>/*.wasm"]` |
| Cloudflare | 対応。wrangler がデプロイ時にモジュールをコンパイルする (ワーカーは実行時にはできない) |
| AWS Lambda (Node.js 22) | 対応 |
| Deno Deploy | 対応 |
| Netlify、Vercel | 未確認 |

## デプロイのワークフロー

```bash
dart run spring_boot_starter_edge:workflow --platform supabase --name api
```

アプリケーションのリポジトリに `.github/workflows/deploy-<name>.yml` を書きます。`main` (`--branch`) への push のたびに、ジェネレーターを実行し、関数をビルドし (`--target`)、デプロイします。対象は `supabase` (`supabase functions deploy`)、`cloudflare` (`wrangler deploy`)、`aws` (`aws lambda update-function-code`、GitHub の OIDC を使用) です。

必要なものはファイルの最初の数行に書かれ、リポジトリのシークレットと変数から取られます。秘密の値は書かれません。

| プラットフォーム | 必要なもの |
|---|---|
| `supabase` | シークレット `SUPABASE_ACCESS_TOKEN`、`SUPABASE_PROJECT_REF` |
| `cloudflare` | シークレット `CLOUDFLARE_API_TOKEN`、`CLOUDFLARE_ACCOUNT_ID` |
| `aws` | シークレット `AWS_ROLE_ARN`。変数 `AWS_REGION`、`AWS_LAMBDA_FUNCTION` |

その後、ファイルはあなたのものです (`--force` で置き換えます)。手作業の手順、各プラットフォームのシークレット、デプロイした関数の確認は[関数のデプロイ](deploying.md)にあります。Deno Deploy、Netlify、Vercel は、リポジトリから自分でデプロイします。ビルドコマンドを渡してください。

## コードとして

`package:spring_boot_starter_edge/build.dart` には、同じビルドがコード (`EdgeBuild`) として用意されています。ビルドスクリプトとテスト用です。

## 関連項目

- [Supabase Edge Functions](supabase.md)
- [Cloudflare Workers](cloudflare.md)
- [AWS Lambda](aws.md)
- [Deno Deploy、Netlify、Vercel](other-platforms.md)
