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 にコンパイルできるよう、フレームワークは次のルールを守っています。

リポジトリーの 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' が必要です。フレームワークが生成するポリシーには、すでに含まれています。

関連項目