ビルド

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

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 を参照)
--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 未確認

デプロイのワークフロー

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 で置き換えます)。手作業の手順、各プラットフォームのシークレット、デプロイした関数の確認は関数のデプロイにあります。Deno Deploy、Netlify、Vercel は、リポジトリから自分でデプロイします。ビルドコマンドを渡してください。

コードとして

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

関連項目