
# 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 アプリは、クライアントを持ち、サーバーは持ちません。すべてのモジュールとそのプラットフォームの表は [一つのプラットフォームだけのモジュール](../components/spring-core-dart-generator/optimizations/build-conditions.md#どのモジュールに指定があるか) にあります。

リポジトリの Flutter ガイド（`flutter build web --wasm`、Flutter 3.47）で測定しました。このアプリが持つサーバー側のコードは WebSocket スターターのサーバー部分だけで、この条件によって 4,966,120 バイトの `main.dart.wasm` から 1,154 バイトが減ります。サーバーとコードを共有し、web、security、actuator のスターターを依存関係に持つアプリケーションでは、除かれるコードはもっと多くなります。リポジトリにそのような例はないため、その場合は測定していません。

タスクエグゼキューター (`IsolateTaskExecutor`) はすべてのビルドに含まれます。ブラウザーは isolate を起動できないので、そこではタスクを呼び出し元の isolate で実行し、ビルドに isolate のコードはありません。[タスクエグゼキューター](../components/spring-core-dart/isolates/task-executor.md#ブラウザーでは) を参照してください。

## 別スレッドでの描画

これは任意です。次のヘッダーを付けてページを配信すると、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'` が必要です。フレームワークが生成するポリシーには、すでに含まれています。

## 関連項目

- [Web](../components/spring-boot-starter-flutter/web.md)
- [一つのプラットフォームだけのモジュール](../components/spring-core-dart-generator/optimizations/build-conditions.md#一つのプラットフォームだけのモジュール)
- [スターター](starters.md)
