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
| Begriff | Was er bedeutet |
|---|---|
| Komposition | Komponenten so verbinden, dass eine den Import einer anderen liefert |
| Instanziieren | eine laufende Kopie einer Komponente anlegen |
| Linker | der Teil einer Laufzeitumgebung, der Importe liefert |
| Erfüllen | einen Import mit einem passenden Export versorgen |
| Bindings | Code 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
docker exec wasm wasmtime run --invoke 'double(21)' doubler.watHier 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
docker exec tools tail -4 app.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die zusammengesetzte Komponente starten
docker exec wasm wasmtime run --invoke 'double(21)' app.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: was jede Komponente braucht und bietet
| Komponente | Importe | Exporte | Läuft allein? |
|---|---|---|---|
| calc.wat | nichts | demo:calc/[email protected] | Ja |
| doubler.wat | demo:calc/[email protected] | double | Nein, der Import fehlt |
| app.wat | nichts | double | Ja, 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
# 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.