Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

WebAssembly-Komponenten zusammensetzen

Nach dieser Lektion: Ich kann erklären, wie zwei Komponenten zusammengesetzt werden, indem ein Import zu einem Export passt.

Lektion, 60 Min.3 BefehleWebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Zwei Teile, ein Programm, beliebige Sprachen

Beim Zusammensetzen von WebAssembly-Komponenten steckt man den Export einer Komponente in den Import einer anderen. Aus beiden wird dann eine einzige Komponente. Die Teile können in verschiedenen Sprachen geschrieben sein, denn sie treffen sich nur an einer WIT-Schnittstelle.

Heute sehen Sie einen Import scheitern, setzen dann zwei Komponenten zusammen und starten das Ergebnis.

Am Ende dieser Lektion

Notiz

Ich kann erklären, wie zwei Komponenten zusammengesetzt werden, indem ein Import zu einem Export passt.

Schlüsselwörter

BegriffWas er bedeutet
KompositionKomponenten so verbinden, dass eine den Import einer anderen liefert
Instanziiereneine laufende Kopie einer Komponente anlegen
Linkerder Teil einer Laufzeitumgebung, der Importe liefert
Erfülleneinen Import mit einem passenden Export versorgen
BindingsCode für eine Sprache, aus WIT erzeugt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein Import, den niemand liefert, stoppt alles

doubler.wat gehört zur Welt doubler. Es importiert demo:calc/[email protected] und verdoppelt eine Zahl mit dessen add.

Starten Sie es allein, lehnt Wasmtime ab, bevor irgendein Code läuft. Der Linker hat diese Schnittstelle gesucht, nichts gefunden und den fehlenden Import genannt. Ein Host prüft jeden Import zuerst. Deshalb erreicht eine Komponente nichts, was ihr nicht gegeben wurde.

doubler ohne Gegenstück starten

Befehl
docker exec wasm wasmtime run --invoke 'double(21)' doubler.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Komposition steckt einen Export in einen Import

app.wat enthält beide Komponenten. Es legt zuerst calc an und dann doubler. Dabei steckt es demo:calc/[email protected] von calc in den gleichnamigen Import. Exportiert wird double.

Das Ergebnis importiert gar nichts, also kann Wasmtime es allein starten. Werkzeuge wie wac erledigen dasselbe mit zwei .wasm-Dateien und schreiben eine neue Komponente.

Die Zeilen lesen, die beide verbinden

Befehl
docker exec tools tail -4 app.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die zusammengesetzte Komponente starten

Befehl
docker exec wasm wasmtime run --invoke 'double(21)' app.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: was jede Komponente braucht und bietet

KomponenteImporteExporteLäuft allein?
calc.watnichtsdemo:calc/[email protected]Ja
doubler.watdemo:calc/[email protected]doubleNein, der Import fehlt
app.watnichtsdoubleJa, es gab 42 aus

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Wie andere Sprachen Komponenten bauen

Ein echtes Projekt schreibt jeden Teil in seiner eigenen Sprache. wit-bindgen macht aus einer WIT-Datei Bindings für Rust, C und weitere Sprachen, und cargo-component baut Rust zu einer Komponente. componentize-py tut das für Python, jco für JavaScript.

Keine dieser Werkzeugketten ist im Lab, denn es lädt nichts herunter. Deshalb sind die Komponenten hier von Hand geschrieben, und sie ergeben dieselbe Art von Bytes.

Ein häufiger Fehler

Warnung

Viele glauben, beim Zusammensetzen werde der Quellcode verbunden und neu übersetzt. Verbunden werden aber fertig gebaute Komponenten. Jede behält ihren eigenen Speicher, und Werte gehen nur über die Schnittstelle. Ein Python-Teil kommt also nicht an die Daten eines Rust-Teils.

Probieren Sie es: ein Linker, der Namen vergleicht

Code: python
# Was jede Komponente anbietet, nach Name der Schnittstelle.
exporte = {
    "demo:calc/[email protected]": "calc",
}

# Was doubler braucht, bevor es starten kann.
bedarf = ["demo:calc/[email protected]", "wasi:cli/[email protected]"]

for name in bedarf:
    if name in exporte:
        print("verbinde", name, "aus", exporte[name])
    else:
        print("fehlt", name, ": niemand bietet es an")
# Ergänzen Sie "wasi:cli/[email protected]": "host" in exporte und starten Sie erneut.

Über dieses Lab und seinen Quellcode: WebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.