Hier beginnen
Ihre eigene Anwendung beginnen
Klonen Sie den Starter, führen Sie drei Befehle aus, und Ihre eigene Anwendung läuft in einem Browserfenster, folgt Ihren Änderungen und bootet dann auf seL4 in QEMU.
Am schnellsten beginnen Sie mit dem Starter: einer kleinen Anwendung auf NoWayOS, die sofort läuft und sich sofort ändern lässt. Sie hat zwei in React geschriebene Screens, etwa sechzig Zeilen Rust, die sie verbinden, und ein seL4-System, auf dem sie bootet. Für den Anfang brauchen Sie weder Rust- noch seL4-Kenntnisse.
NoWayOS ist in Entwicklung, der Starter ebenso: Er ist zum Lernen und Bauen gedacht.
Was Sie brauchen
- git und GNU Make.
- Podman. Docker funktioniert auch: Ergänzen Sie jeden Befehl um
ENGINE=docker. - Sonst nichts. Die Rust-Toolchains, das Microkit SDK von seL4 und QEMU stecken im Dev-Container, festgelegt auf exakte Versionen.
Unter macOS legen Sie die virtuelle Maschine von Podman einmal an und starten sie:
podman machine init --cpus 4 --memory 8192
podman machine start
Drei Befehle
git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev
make setup holt NoWayOS und den Screen Compiler in den Ordner, in den Commits, die der Starter nennt, und baut den Dev-Container: einige Minuten und etwa 5 GB, einmalig. Fehlt Ihrem Rechner etwas, sagt es Ihnen das, und Sie können es gefahrlos erneut ausführen.
make dev startet die Anwendung und zeigt sie unter http://localhost:8017/. Es ist dasselbe Rust, das auf dem Gerät läuft, für Ihren Rechner gebaut. Tippen Sie einen Namen ein und drücken Sie Continue.
Ändern Sie sie
Öffnen Sie app/starter-app/tsx/welcome.tsx, ändern Sie etwas Text und speichern Sie. Der Screen wird geprüft, in Rust umgewandelt, neu gebaut und ist etwa eine Sekunde später wieder zu sehen, auf dem Screen, auf dem Sie waren. Ändern Sie die Logik in app/starter-app/src/lib.rs, und das Fenster folgt auch dem.
Schreiben Sie etwas, das der Screen Compiler nicht umwandelt, sagt er es über dem Screen, mit der Zeile und dem, was Sie stattdessen verwenden können, und die letzte funktionierende Fassung bleibt stehen.
Einen Screen hinzufügen
make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks
Der erste Befehl schreibt einen neuen Screen aus einer Vorlage und gibt die Zeilen aus, die ihn mit der Logik verbinden. Der zweite zeichnet ihn als Bild mit dem eigenen Renderer von NoWayOS; mit WATCH=1 zeichnet er bei jedem Speichern neu. Der dritte öffnet die Anwendung auf diesem Screen.
Auf seL4 booten
make qemu VNC=1
Das baut ein echtes seL4-System aus vier Schutzdomänen und bootet es in QEMU. Öffnen Sie vnc://localhost:5900 mit dem Passwort, das ausgegeben wird, und bedienen Sie die Anwendung mit Tastatur und Maus. make qemu-test bootet es ohne Bildschirm und prüft, was es ausgibt und anzeigt.
Jede Capability, die ein Teil hält, steht in app/systems/starter.grants, und der Build schlägt fehl, wenn das System einem Teil etwas gibt, das diese Datei nicht aufführt. Der Teil Ihrer Anwendung hält seine Nachrichtenringe und den Framebuffer: kein Gerät, keinen Interrupt, kein Netzwerk.
Machen Sie sie zu Ihrer
make rename NAME=my-product
make check
make rename benennt die Crates, die Programme und das System durchgehend um. make check führt die Lints, die Tests, die Screen-Prüfung und den QEMU-Test aus: Führen Sie es aus, bevor Sie eine Änderung weitergeben.
make ci geht weiter: Es wendet die Sicherheitsprüfungen, die NoWayOS auf sich selbst anwendet, auf Ihre Anwendung an. Kein Schlüssel und keine Zugangsdaten im Verzeichnisbaum oder in einem Commit; jede Abhängigkeit unter einer permissiven Lizenz, von crates.io, ohne bekannten Sicherheitshinweis; kein unsafe-Code; und eine Software-Stückliste dessen, woraus das Gerät gebaut wird.
Wie es weitergeht
- Screens aus React: was umgewandelt wird.
- Von React portieren: eine bestehende Oberfläche, und jede Diagnose erklärt.
- Wie ein System zusammenspielt: Schutzdomänen, Ringe und Grants.
- Betrieb auf einem Raspberry Pi 5: Der Starter läuft in QEMU; diese Seite behandelt das Board.