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
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| Composición | unir componentes para que uno aporte la importación de otro | |
| Instanciar | crear una copia en marcha de un componente | instantiate |
| Enlazador | la parte del runtime que aporta las importaciones | linker |
| Satisfacer | cubrir una importación con una exportación que encaja | |
| Bindings | có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
docker exec wasm wasmtime run --invoke 'double(21)' doubler.watSe 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
docker exec tools tail -4 app.watSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejecuta el componente compuesto
docker exec wasm wasmtime run --invoke 'double(21)' app.watSe 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
| Componente | Importa | Exporta | ¿Corre solo? |
|---|---|---|---|
| calc.wat | nada | demo:calc/[email protected] | Sí |
| doubler.wat | demo:calc/[email protected] | double | No, falta la importación |
| app.wat | nada | double | Sí, 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
# 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.