NoWayOS
ES
GitHub
MenúCerrar

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=docker a 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