Pour commencer
Démarrer votre propre application
Clonez le starter, lancez trois commandes et votre propre application tourne dans une fenêtre de navigateur, suit vos modifications, puis démarre sur seL4 dans QEMU.
Le moyen le plus rapide de commencer est le starter : une petite application sur NoWayOS, prête à tourner et à être modifiée. Elle a deux écrans écrits en React, une soixantaine de lignes de Rust qui les relient, et un système seL4 sur lequel démarrer. Vous n’avez besoin d’aucune connaissance de Rust ni de seL4 pour commencer.
NoWayOS est en développement, et le starter aussi : il sert à apprendre et à construire.
Ce qu’il vous faut
- git et GNU Make.
- Podman. Docker convient aussi : ajoutez
ENGINE=dockerà chaque commande. - Rien d’autre. Les chaînes d’outils Rust, le Microkit SDK de seL4 et QEMU sont dans le conteneur de développement, fixés à des versions exactes.
Sous macOS, créez et démarrez une fois la machine virtuelle de Podman :
podman machine init --cpus 4 --memory 8192
podman machine start
Trois commandes
git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev
make setup récupère NoWayOS et le Screen Compiler dans le dossier, aux commits que nomme le starter, et construit le conteneur de développement : quelques minutes et environ 5 Go, une seule fois. Il vous dit ce qui manque à votre machine, et vous pouvez le relancer sans risque.
make dev lance l’application et l’affiche à http://localhost:8017/. C’est le même Rust que celui qui tourne sur l’appareil, compilé pour votre machine. Saisissez un nom et appuyez sur Continue.
Modifiez-la
Ouvrez app/starter-app/tsx/welcome.tsx, changez un peu de texte et enregistrez. L’écran est vérifié, converti en Rust, recompilé et de nouveau affiché environ une seconde plus tard, sur l’écran où vous étiez. Modifiez la logique dans app/starter-app/src/lib.rs et la fenêtre suit aussi.
Si vous écrivez quelque chose que le Screen Compiler ne convertit pas, il le dit au-dessus de l’écran, avec la ligne et ce qu’il faut utiliser à la place, et la dernière version correcte reste affichée.
Ajouter un écran
make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks
La première commande écrit un nouvel écran à partir d’un modèle et affiche les lignes qui le relient à la logique. La deuxième le dessine en image avec le moteur de rendu de NoWayOS ; ajoutez WATCH=1 et elle le redessine à chaque enregistrement. La troisième ouvre l’application sur cet écran.
La démarrer sur seL4
make qemu VNC=1
Cela construit un vrai système seL4 de quatre domaines de protection et le démarre dans QEMU. Ouvrez vnc://localhost:5900 avec le mot de passe affiché, et utilisez l’application au clavier et à la souris. make qemu-test le démarre sans écran et vérifie ce qu’il imprime et affiche.
Chaque capacité détenue par une partie figure dans app/systems/starter.grants, et la construction échoue si le système donne à une partie quoi que ce soit que ce fichier ne mentionne pas. La partie de votre application détient ses anneaux de messages et le framebuffer : aucun périphérique, aucune interruption, aucun réseau.
Faites-en la vôtre
make rename NAME=my-product
make check
make rename renomme partout les crates, les programmes et le système. make check lance les lints, les tests, la vérification des écrans et le test QEMU : lancez-le avant de partager une modification.
make ci va plus loin : il applique à votre application les vérifications de sécurité que NoWayOS s’applique à lui-même. Aucune clé ni aucun identifiant dans l’arborescence ou dans un commit ; chaque dépendance sous licence permissive, issue de crates.io, sans avis de sécurité connu ; aucun code unsafe ; et une nomenclature logicielle de ce dont l’appareil est construit.
Et ensuite
- Des écrans issus de React : ce qui est converti.
- Porter depuis React : une interface existante, et chaque diagnostic expliqué.
- Comment s’assemble un système : domaines de protection, anneaux et grants.
- Exécuter sur un Raspberry Pi 5 : le starter tourne dans QEMU ; cette page traite de la carte.