WebAssembly
アプリがブラウザーで実行できるパッケージは、すべて WebAssembly にコンパイルできます。spring_core_dart、spring_boot_dart、ロギング、スケジューリング、キャッシュ、Feign、WebSocket、データ、Supabase の各スターター、spring_security_core、spring_search_dart、そして 6 つの Flutter スターター (spring_boot_starter_flutter、spring_boot_starter_flutter_material、spring_boot_starter_flutter_cupertino、spring_boot_starter_flutter_navigation、spring_boot_starter_flutter_scene、spring_boot_starter_flutter_security) です。そのため、Flutter の Web アプリは次のようにビルドできます。
flutter build web --wasm
得られるもの
アプリの Dart のコードは WebAssembly として実行されます。JavaScript ビルドより高速で、Dart のコードでは通常 1.5 倍から 2 倍です。起動時の処理 (設定の読み込み、Bean の作成)、Markdown、検索インデックスなどが対象です。また、エンジンは CanvasKit の代わりに Skwasm で描画します。
WasmGC に対応していないブラウザーには、自動的に JavaScript ビルドが渡されます。両方のビルドが build/web に入り、各ブラウザーは自分用のものだけをダウンロードします。
このサイトは --wasm でビルドされています。起動時間は同じ (スプラッシュのアニメーションの時間) で、大きなページへのページ遷移で、ドロップしたフレームによる損失が 2 倍から 3 倍小さくなりました。
ルール
フレームワークのライブラリが Wasm にコンパイルできるよう、フレームワークは次のルールを守っています。
dart:html、dart:js、dart:js_util、package:jsは使いません。ブラウザーにはdart:js_interopを通して触れます。dart:ffiとdart:ioは、条件付きインポートまたはプラットフォームの確認の背後でだけ使います。
リポジトリーの CI は、これらのパッケージのすべての公開ライブラリを Wasm にコンパイルし (tool/check_wasm.dart)、コンパイルできないものがあれば失敗します。サーバーのパッケージもそのチェックに含まれます (Web、セキュリティ、Actuator、OAuth2 クライアントの各スターターと spring_boot_actuator)。それらのモジュールはブラウザービルドから外されますが、それらを列挙するアプリケーションの生成ファイルは、それでもそのライブラリをインポートするので、コンパイルできなければなりません。
同じルールが、あなた自身のコードと依存関係にも当てはまります。Wasm にコンパイルできないライブラリが 1 つあるだけで、flutter build web --wasm は失敗します。通常の Web ビルドでは、そのことが「Wasm dry run」の警告として表示されます。
ブラウザービルドにサーバーのコードは入らない
アプリケーションの依存関係は、ブラウザーが使える以上のものを持ち込むことがよくあります。HTTP もサーブする共有パッケージや、クライアント側の半分とサーバー側の半分を持つスターターです。dart:io が存在する場所でしか動かないモジュールには、その指定があります (AutoConfigurationModule(platform: ModulePlatform.native))。Web サーバー、そのセキュリティ、Actuator のエンドポイント、WebSocket スターターのサーバーのエンドポイントです。生成されたアプリケーションは、ブラウザービルドでは false になる定数の下にそれらを列挙するので、コンパイラーはそれらと、それらだけが到達するすべてのものを落とします。手で除外するものは何もなく、JavaScript ビルドでも WebAssembly ビルドでも外されます。
そのため、@WebSocketClient のために spring_boot_starter_websocket を使う Flutter の Web アプリは、クライアントを持ち、サーバーは持ちません。すべてのモジュールとそのプラットフォームの表は 一つのプラットフォームだけのモジュール にあります。
リポジトリの Flutter ガイド(flutter build web --wasm、Flutter 3.47)で測定しました。このアプリが持つサーバー側のコードは WebSocket スターターのサーバー部分だけで、この条件によって 4,966,120 バイトの main.dart.wasm から 1,154 バイトが減ります。サーバーとコードを共有し、web、security、actuator のスターターを依存関係に持つアプリケーションでは、除かれるコードはもっと多くなります。リポジトリにそのような例はないため、その場合は測定していません。
タスクエグゼキューター (IsolateTaskExecutor) はすべてのビルドに含まれます。ブラウザーは isolate を起動できないので、そこではタスクを呼び出し元の isolate で実行し、ビルドに isolate のコードはありません。タスクエグゼキューター を参照してください。
別スレッドでの描画
これは任意です。次のヘッダーを付けてページを配信すると、Skwasm は別のスレッドで描画できます。
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
2 つ目には credentialless も使えます。これらのヘッダーは、許可していない別オリジンのリソース (他のサイトのフォントや画像など) もブロックするので、有効にする前にアプリをテストしてください。ヘッダーがなくても Wasm は動作し、アプリはメインスレッドで描画します。
Content Security Policy
Content-Security-Policy の script-src には 'wasm-unsafe-eval' が必要です。フレームワークが生成するポリシーには、すでに含まれています。