¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Componer componentes de WebAssembly

Después de esta lección: Puedo explicar cómo se componen dos componentes emparejando una importación con una exportación.

Lección de 60 min3 comandosLaboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

Dos piezas, un programa, cualquier lenguaje

Componer componentes de WebAssembly es enchufar la exportación de un componente a la importación de otro. Así los dos pasan a ser un solo componente. Las piezas pueden estar escritas en lenguajes distintos, porque solo se encuentran en una interfaz WIT.

Hoy ves fallar una importación, y después compones dos componentes y ejecutas el resultado.

Al terminar esta lección

Nota

Puedo explicar cómo se componen dos componentes emparejando una importación con una exportación.

Palabras clave

PalabraQué significaEjemplo
Composiciónunir componentes para que uno aporte la importación de otro
Instanciarcrear una copia en marcha de un componenteinstantiate
Enlazadorla parte del runtime que aporta las importacioneslinker
Satisfacercubrir una importación con una exportación que encaja
Bindingscódigo generado desde WIT para un lenguaje

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Una importación sin aportar lo detiene todo

doubler.wat pertenece al mundo doubler. Importa demo:calc/[email protected] y usa su add para duplicar un número.

Ejecútalo solo y Wasmtime se niega antes de que corra nada de código. Su enlazador buscó esa interfaz, no encontró nada y nombró la importación que faltaba. Un anfitrión comprueba primero cada importación, y por eso un componente no alcanza nada que no le hayan dado.

Ejecuta doubler sin nada que enchufar

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Componer enchufa una exportación a una importación

app.wat contiene los dos componentes. Primero crea calc, y después crea doubler con el demo:calc/[email protected] de calc enchufado a la importación del mismo nombre. Exporta double.

El resultado no importa nada, así que Wasmtime puede ejecutarlo solo. Herramientas como wac hacen el mismo trabajo con dos archivos .wasm y escriben un componente nuevo.

Lee las líneas que los componen

Comando
docker exec tools tail -4 app.wat

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejecuta el componente compuesto

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: qué necesita y qué da cada componente

ComponenteImportaExporta¿Corre solo?
calc.watnadademo:calc/[email protected]Sí
doubler.watdemo:calc/[email protected]doubleNo, falta la importación
app.watnadadoubleSí, imprimió 42

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Cómo hacen componentes otros lenguajes

Un proyecto real escribe cada pieza en su propio lenguaje. wit-bindgen convierte un archivo WIT en bindings para Rust, C y otros, y cargo-component compila Rust a un componente. componentize-py lo hace para Python, y jco para JavaScript.

Ninguna de esas herramientas está en el laboratorio, que no descarga nada. Por eso los componentes de aquí están escritos a mano, y los bytes que producen son del mismo tipo.

Un error frecuente

Advertencia

Mucha gente cree que componer junta el código fuente y lo vuelve a compilar. Junta componentes ya construidos. Cada uno conserva su memoria y los valores solo cruzan por la interfaz. Una pieza en Python no puede meterse en los datos de una pieza en Rust.

Pruébalo: un enlazador que empareja nombres

Código: python
# Lo que da cada componente, por nombre de interfaz.
exports = {
    "demo:calc/[email protected]": "calc",
}

# Lo que necesita doubler para poder arrancar.
needs = ["demo:calc/[email protected]", "wasi:cli/[email protected]"]

for name in needs:
    if name in exports:
        print("enchufa", name, "desde", exports[name])
    else:
        print("falta", name, ": nadie lo da")
# Añade "wasi:cli/[email protected]": "host" a exports y ejecuta otra vez.

Sobre este laboratorio y su código: Laboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.