NoWayOS
IT
GitHub
MenuChiudi

Primi passi

Inizi la Sua applicazione

Cloni lo starter, esegua tre comandi e abbia la Sua applicazione in una finestra del browser, che segue le Sue modifiche e poi si avvia su seL4 in QEMU.

Il modo più rapido per iniziare è lo starter: una piccola applicazione su NoWayOS, pronta da eseguire e da modificare. Ha due schermate scritte in React, una sessantina di righe di Rust che le collegano e un sistema seL4 su cui avviarsi. Per iniziare non Le serve conoscere né Rust né seL4.

NoWayOS è in sviluppo, e così lo starter: serve per imparare e costruire.

Che cosa Le serve

  • git e GNU Make.
  • Podman. Va bene anche Docker: aggiunga ENGINE=docker a ogni comando.
  • Nient’altro. Le toolchain di Rust, il Microkit SDK di seL4 e QEMU sono dentro il container di sviluppo, fissati a versioni esatte.

Su macOS, crei e avvii una volta la macchina virtuale di Podman:

podman machine init --cpus 4 --memory 8192
podman machine start

Tre comandi

git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev

make setup scarica NoWayOS e lo Screen Compiler nella cartella, ai commit indicati dallo starter, e costruisce il container di sviluppo: qualche minuto e circa 5 GB, una volta sola. Le dice se alla Sua macchina manca qualcosa, e può rieseguirlo senza rischi.

make dev esegue l’applicazione e la mostra a http://localhost:8017/. È lo stesso Rust che gira sul dispositivo, compilato per la Sua macchina. Scriva un nome e prema Continue.

La modifichi

Apra app/starter-app/tsx/welcome.tsx, cambi un po’ di testo e salvi. La schermata viene controllata, convertita in Rust, ricompilata e mostrata di nuovo circa un secondo dopo, sulla schermata in cui si trovava. Cambi la logica in app/starter-app/src/lib.rs e la finestra segue anche quella.

Se scrive qualcosa che lo Screen Compiler non converte, lo dice sopra la schermata, con la riga e che cosa usare al suo posto, e l’ultima versione valida resta visibile.

Aggiunga una schermata

make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks

Il primo comando scrive una nuova schermata da un modello e stampa le righe che la collegano alla logica. Il secondo la disegna come immagine con il renderer di NoWayOS; aggiunga WATCH=1 e la ridisegna a ogni salvataggio. Il terzo apre l’applicazione su quella schermata.

La avvii su seL4

make qemu VNC=1

Questo costruisce un vero sistema seL4 di quattro domini di protezione e lo avvia in QEMU. Apra vnc://localhost:5900 con la password che stampa e usi l’applicazione con tastiera e mouse. make qemu-test lo avvia senza schermo e verifica che cosa stampa e mostra.

Ogni capability detenuta da una parte è elencata in app/systems/starter.grants, e la build fallisce se il sistema dà a una parte qualcosa che quel file non elenca. La parte della Sua applicazione detiene i suoi anelli di messaggi e il framebuffer: nessun dispositivo, nessun interrupt, nessuna rete.

La renda Sua

make rename NAME=my-product
make check

make rename rinomina ovunque i crate, i programmi e il sistema. make check esegue i lint, i test, il controllo delle schermate e il test in QEMU: lo esegua prima di condividere una modifica.

make ci va oltre: esegue sulla sua applicazione i controlli di sicurezza che NoWayOS esegue su sé stesso. Nessuna chiave o credenziale nell'albero o in alcun commit; ogni dipendenza con una licenza permissiva, proveniente da crates.io, senza avvisi di sicurezza noti; nessun codice unsafe; e una distinta base del software di ciò con cui è costruito il dispositivo.

Come proseguire