Empiece aquí
Empiece su propia aplicación
Clone el starter, ejecute tres comandos y tenga su propia aplicación en una ventana del navegador, siguiendo sus cambios, y después arrancando sobre seL4 en QEMU.
La forma más rápida de empezar es el starter: una pequeña aplicación sobre NoWayOS lista para ejecutarse y para cambiarse. Tiene dos pantallas escritas en React, unas sesenta líneas de Rust que las unen y un sistema seL4 sobre el que arrancar. Para empezar no necesita saber Rust ni seL4.
NoWayOS está en desarrollo, y el starter también: sirve para aprender y construir.
Qué necesita
- git y GNU Make.
- Podman. Docker también sirve: añada
ENGINE=dockera cada comando. - Nada más. Las cadenas de herramientas de Rust, el Microkit SDK de seL4 y QEMU están dentro del contenedor de desarrollo, fijados a versiones exactas.
En macOS, cree e inicie una vez la máquina virtual de Podman:
podman machine init --cpus 4 --memory 8192
podman machine start
Tres comandos
git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev
make setup trae NoWayOS y el Screen Compiler a la carpeta, en los commits que el starter indica, y construye el contenedor de desarrollo: unos minutos y unos 5 GB, una sola vez. Le dice si a su máquina le falta algo, y puede ejecutarlo de nuevo sin riesgo.
make dev ejecuta la aplicación y la muestra en http://localhost:8017/. Es el mismo Rust que se ejecuta en el dispositivo, compilado para su máquina. Escriba un nombre y pulse Continue.
Cámbiela
Abra app/starter-app/tsx/welcome.tsx, cambie algo de texto y guarde. La pantalla se comprueba, se convierte a Rust, se recompila y vuelve a mostrarse aproximadamente un segundo después, en la pantalla en la que estaba. Cambie la lógica en app/starter-app/src/lib.rs y la ventana también lo sigue.
Si escribe algo que el Screen Compiler no convierte, lo dice encima de la pantalla, con la línea y lo que debe usar en su lugar, y la última versión correcta sigue a la vista.
Añada una pantalla
make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks
El primer comando escribe una pantalla nueva a partir de una plantilla e imprime las líneas que la conectan con la lógica. El segundo la dibuja como imagen con el propio renderizador de NoWayOS; añada WATCH=1 y la redibuja cada vez que guarde. El tercero abre la aplicación en esa pantalla.
Arránquela sobre seL4
make qemu VNC=1
Esto construye un sistema seL4 real de cuatro dominios de protección y lo arranca en QEMU. Abra vnc://localhost:5900 con la contraseña que imprime y use la aplicación con el teclado y el ratón. make qemu-test lo arranca sin pantalla y comprueba lo que imprime y muestra.
Cada capacidad que tiene una parte figura en app/systems/starter.grants, y la compilación falla si el sistema da a una parte algo que ese archivo no enumera. La parte de su aplicación tiene sus anillos de mensajes y el framebuffer: ningún dispositivo, ninguna interrupción, ninguna red.
Hágala suya
make rename NAME=my-product
make check
make rename cambia el nombre de los crates, los programas y el sistema en todas partes. make check ejecuta los lints, las pruebas, la comprobación de pantallas y la prueba en QEMU: ejecútelo antes de compartir un cambio.
make ci va más allá: ejecuta sobre su aplicación las comprobaciones de seguridad que NoWayOS ejecuta sobre sí mismo. Ninguna clave ni credencial en el árbol ni en ningún commit; cada dependencia con una licencia permisiva, procedente de crates.io y sin avisos de seguridad conocidos; nada de código unsafe; y una lista de materiales de software de aquello con lo que se construye el dispositivo.
Qué sigue
- Pantallas desde React: qué se convierte.
- Portar desde React: una interfaz existente, y cada diagnóstico explicado.
- Cómo encaja un sistema: dominios de protección, anillos y grants.
- Ejecución en una Raspberry Pi 5: el starter se ejecuta en QEMU; esta página trata de la placa.