Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Composer des composants WebAssembly

Après cette leçon: Je peux expliquer comment deux composants se composent en reliant un import à un export.

Leçon de 60 min3 commandesLab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Deux pièces, un programme, tous les langages

Composer des composants WebAssembly, c’est brancher l’export d’un composant sur l’import d’un autre, pour n’en faire qu’un seul. Les pièces peuvent être écrites dans des langages différents, car elles ne se rencontrent que par une interface WIT.

Aujourd’hui, vous voyez un import échouer, puis vous composez deux composants et lancez le résultat.

À la fin de cette leçon

Remarque

Je peux expliquer comment deux composants se composent en reliant un import à un export.

Mots-clés

MotCe que ça veut direExemple
Compositionassembler des composants pour que l’un fournisse l’import d’un autre
Instanciercréer une copie en marche d’un composant
Éditeur de liensla partie du runtime qui fournit les importslinker
Satisfairefournir un import avec un export qui correspond
Bindingsdu code généré à partir de WIT pour un langage

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Un import que personne ne fournit bloque tout

doubler.wat est dans le monde doubler. Il importe demo:calc/[email protected] et se sert de son add pour doubler un nombre.

Lancé seul, il est refusé par Wasmtime avant que le moindre code tourne. L’éditeur de liens a cherché cette interface, n’a rien trouvé et a nommé l’import manquant. Un hôte vérifie chaque import d’abord : voilà pourquoi un composant n’atteint rien qu’on ne lui ait donné.

Lancer doubler sans rien à brancher

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

La composition branche un export sur un import

app.wat contient les deux composants. Il crée d’abord calc, puis crée doubler en branchant le demo:calc/[email protected] de calc sur l’import du même nom. Il exporte double.

Le résultat n’importe plus rien, donc Wasmtime peut le lancer seul. Des outils comme wac font le même travail avec deux fichiers .wasm et écrivent un nouveau composant.

Lire les lignes qui les composent

Commande
docker exec tools tail -4 app.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lancer le composant composé

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Exemple travaillé : besoins et fournitures

ComposantImportsExportsTourne seul ?
calc.watriendemo:calc/[email protected]Oui
doubler.watdemo:calc/[email protected]doubleNon, l’import manque
app.watriendoubleOui, il a affiché 42

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Comment les autres langages font des composants

Un vrai projet écrit chaque pièce dans son langage. wit-bindgen transforme un fichier WIT en bindings pour Rust, C et d’autres, et cargo-component construit un composant à partir de Rust. componentize-py fait de même pour Python, et jco pour JavaScript.

Aucune de ces chaînes d’outils n’est dans le labo, qui ne télécharge rien. Les composants y sont donc écrits à la main, et les octets produits sont de la même sorte.

Erreur fréquente

Attention

On croit souvent que composer revient à fusionner le code source et à le recompiler. On assemble des composants déjà construits. Chacun garde sa mémoire, et les valeurs ne passent que par l’interface : une pièce Python ne peut pas fouiller dans les données d’une pièce Rust.

À vous : relier les imports par nom

Code: python
# Ce que fournit chaque composant, par nom d’interface.
exports = {
    "demo:calc/[email protected]": "calc",
}

# Ce dont doubler a besoin avant de pouvoir démarrer.
besoins = ["demo:calc/[email protected]", "wasi:cli/[email protected]"]

for nom in besoins:
    if nom in exports:
        print("brancher", nom, "depuis", exports[nom])
    else:
        print("manquant", nom, ": personne ne le fournit")
# Ajoutez "wasi:cli/[email protected]": "hote" aux exports et relancez.

À propos de ce labo et de sa source: Lab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.