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.wat | demo:calc/[email protected] | double | 動かない。インポートが足りない |
| app.wat | なし | double | 動く。42と出た |
学生が入力するセルは、このプレビューでは空白です。
ほかの言語でのコンポーネントの作り方
実際のプロジェクトでは、部品ごとに言語を選びます。wit-bindgen は、WIT ファイルから Rust や C などのバインディングを作ります。cargo-component は Rust をコンポーネントにビルドします。Python には componentize-py、JavaScript には jco があります。
ラボは何もダウンロードしないので、どのツールチェーンも入っていません。そのため、ここのコンポーネントは手書きです。できるバイトは同じ種類のものです。
よくある間違い
注意
「合成はソースコードをつないでコンパイルし直すことだ」と考える人がいます。合成するのは、ビルド済みのコンポーネントです。それぞれ自分のメモリーを持ち、値はインターフェースだけを通ります。だから Python の部品が Rust の部品のデータに手を入れることはできません。
試そう: 名前を合わせるリンカー
# それぞれのコンポーネントが差し出すもの (インターフェース名で)。
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" を足して、もう一度実行しましょう。