クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

WebAssembly コンポーネントの合成

このレッスンのあとで: インポートをエクスポートに合わせて、2つのコンポーネントを合成する仕組みを説明できる。

60分のレッスンコマンド3件WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

2つの部品で1つのプログラム

WebAssembly のコンポーネントを合成するとは、あるコンポーネントのエクスポートを、別のもののインポートにつなぐことです。2つは1つのコンポーネントになります。部品どうしは WIT のインターフェースでしか出会わないので、別々の言語で書けます。

今日はインポートが失敗する様子を見てから、2つのコンポーネントを合成して動かします。

このレッスンのゴール

メモ

インポートをエクスポートに合わせて、2つのコンポーネントを合成する仕組みを説明できる。

キーワード

ことばいみ
合成あるコンポーネントが別のもののインポートを満たすようにつなぐこと
インスタンス化コンポーネントの動くコピーを作ること
リンカーランタイムの中で、インポートを用意する部分
満たす合うエクスポートでインポートを用意すること
バインディングWIT から1つの言語向けに生成したコード

学生が入力するセルは、このプレビューでは空白です。

用意されないインポートは全体を止める

doubler.wat はワールド doubler に属します。demo:calc/[email protected] をインポートし、その add を使って数を2倍にします。

これだけで動かすと、Wasmtime はコードを1行も動かす前に断ります。リンカーがそのインターフェースを探し、見つからず、足りないインポートの名前を出したのです。ホストは最初にインポートをすべて確かめます。だから、コンポーネントは渡されていないものに届きません。

つなぐものなしで doubler を動かす

コマンド
docker exec wasm wasmtime run --invoke 'double(21)' doubler.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

合成はエクスポートをインポートにつなぐ

app.wat は2つのコンポーネントを両方持っています。まず calc を作り、次に doubler を作ります。そのとき、calc の demo:calc/[email protected] を、同じ名前のインポートにつなぎます。そして double をエクスポートします。

できあがったものは何もインポートしないので、Wasmtime はそれだけで動かせます。wac などの道具は、2つの .wasm ファイルで同じことをして、新しいコンポーネントを1つ書き出します。

合成している行を読む

コマンド
docker exec tools tail -4 app.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

合成したコンポーネントを動かす

コマンド
docker exec wasm wasmtime run --invoke 'double(21)' app.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

例: 必要なものと差し出すもの

コンポーネントインポートエクスポート単独で動くか
calc.watなしdemo:calc/[email protected]動く
doubler.watdemo:calc/[email protected]double動かない。インポートが足りない
app.watなしdouble動く。42と出た

学生が入力するセルは、このプレビューでは空白です。

ほかの言語でのコンポーネントの作り方

実際のプロジェクトでは、部品ごとに言語を選びます。wit-bindgen は、WIT ファイルから Rust や C などのバインディングを作ります。cargo-component は Rust をコンポーネントにビルドします。Python には componentize-py、JavaScript には jco があります。

ラボは何もダウンロードしないので、どのツールチェーンも入っていません。そのため、ここのコンポーネントは手書きです。できるバイトは同じ種類のものです。

よくある間違い

注意

「合成はソースコードをつないでコンパイルし直すことだ」と考える人がいます。合成するのは、ビルド済みのコンポーネントです。それぞれ自分のメモリーを持ち、値はインターフェースだけを通ります。だから Python の部品が Rust の部品のデータに手を入れることはできません。

試そう: 名前を合わせるリンカー

コード: python
# それぞれのコンポーネントが差し出すもの (インターフェース名で)。
exports = {
    "demo:calc/[email protected]": "calc",
}

# doubler が始まる前に必要なもの。
needs = ["demo:calc/[email protected]", "wasi:cli/[email protected]"]

for name in needs:
    if name in exports:
        print("つなぐ:", name, "<-", exports[name])
    else:
        print("足りない:", name, "(差し出すものがない)")
# exports に "wasi:cli/[email protected]": "host" を足して、もう一度実行しましょう。

このラボとソースについて: WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。