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

WIT-Schnittstellen und WebAssembly-Komponenten

Nach dieser Lektion: Ich kann eine WIT-Welt lesen und sagen, was eine Komponente importiert und exportiert.

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

Programme einigen sich auf Typen, nicht Sprachen

Eine WebAssembly-Komponente ist ein Modul mit einer typisierten Beschreibung dessen, was es importiert und exportiert. Diese Beschreibung steht in WIT, der WebAssembly Interface Type language. So kann eine Komponente in Rust einer Komponente in Python einen String oder eine Liste übergeben.

Heute lesen Sie eine WIT-Datei und rufen eine Komponente über sie auf.

Am Ende dieser Lektion

Notiz

Ich kann eine WIT-Welt lesen und sagen, was eine Komponente importiert und exportiert.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
Komponenteein Modul mit typisierten Importen und Exporten
WITdie Sprache, die diese Typen beschreibtcalc.wit
Schnittstelleeine benannte Gruppe von Funktionen und Typenmath
Weltalles, was eine Komponente importiert und exportiert
PaketName und Version einer Sammlung von Schnittstellendemo:[email protected]
Heben (lift)aus einer Kernfunktion eine typisierte Funktion machen

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

Ein Kernmodul spricht nur in Zahlen

Ein einfaches Modul, ein Kernmodul, kennt vier Arten von Werten: i32, i64, f32 und f64. Ein String muss als Stelle im Speicher und Länge reisen, und beide Seiten müssen sich einig sein, wie.

Das Component Model legt diese Einigung einmal fest, in der Canonical ABI. WIT sagt string, list oder record, und die Laufzeitumgebung bewegt die Bytes. Zwei Komponenten teilen sich nie Speicher.

Die WIT-Datei des Labs lesen

Befehl
docker exec tools cat calc.wit

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

Beispiel: die Teile von calc.wit

ZeileArtWas sie sagt
package demo:[email protected];packageNamensraum demo, Name calc, Version 0.1.0
interface math { ... }interfaceEine Funktion, add: func(a: u32, b: u32) -> u32
world calculator { export math; }worldEine Komponente, die math anbietet
world doubler { import math; export double: ... }worldBraucht math, bietet double

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

Eine Komponente ist ein Modul plus Typen

Öffnen Sie calc.wat mit docker exec tools cat calc.wat. Darin steht ein gewöhnliches Kernmodul, dessen add zwei i32 nimmt und eines zurückgibt.

Eine Zeile mit canon lift macht daraus add: func(a: u32, b: u32) -> u32, also den Typ, den WIT versprochen hat. Die Komponente exportiert die Funktion in der Instanz demo:calc/[email protected]. Wasmtime ruft sie mit --invoke beim Namen auf.

add der Komponente aufrufen

Befehl
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.wat

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

Zwei zu große Zahlen addieren

Befehl
docker exec wasm wasmtime run --invoke 'add(4000000000, 500000000)' calc.wat

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

Eine Welt ist ein Vertrag mit dem Host

Eine Welt listet, was eine Komponente braucht und was sie anbietet. Der Host muss jeden Import liefern, bevor die Komponente startet. Die Welt ist also alles, was sie überhaupt anfassen darf.

Auch WASI ist als WIT-Welten geschrieben. Eine Komponente für die Kommandozeile importiert Schnittstellen wie wasi:filesystem und wasi:cli/environment und exportiert wasi:cli/run. Ein Host kann diese Liste lesen, bevor er irgendetwas ausführt.

Ein häufiger Fehler

Warnung

Viele halten eine WIT-Datei für Code, der läuft. WIT beschreibt nur Typen und Funktionen, wie ein Vertrag. Der Code steckt in der Komponente, und dieselbe WIT-Datei können Komponenten in jeder Sprache erfüllen.

Probieren Sie es: woher kommt 205032704?

Code: python
MASKE = 2 ** 32

def addiere_u32(a, b):
    # Ein i32.add im Kernmodul behält nur die unteren 32 Bits der Summe.
    return (a + b) % MASKE

def mit_vorzeichen(n):
    # Dieselben 32 Bits, als Zahl mit Vorzeichen gelesen.
    if n >= 2 ** 31:
        return n - MASKE
    return n

for paar in [[2, 3], [4000000000, 500000000], [3000000000, 0]]:
    summe = addiere_u32(paar[0], paar[1])
    print(paar[0], "+", paar[1], "=", summe, "als u32 und", mit_vorzeichen(summe), "als s32")
# Nehmen Sie [4294967295, 1] dazu. Worauf läuft die Summe über?

Ü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.