从这里开始
开始您自己的应用
克隆 starter,运行三条命令,您自己的应用就会出现在浏览器窗口中,跟随您的修改,随后在 QEMU 中的 seL4 上启动。
最快的入门方式是 starter:一个运行在 NoWayOS 上的小应用,可以立即运行,也可以立即修改。它有两个用 React 编写的屏幕、约六十行把它们连接起来的 Rust,以及一个用来启动它的 seL4 系统。入门时您无需了解 Rust 或 seL4。
NoWayOS 仍在开发中,starter 也是如此:它用于学习和构建。
您需要什么
- git 和 GNU Make。
- Podman。Docker 也可以:在每条命令后加上
ENGINE=docker。 - 别无其他。Rust 工具链、seL4 的 Microkit SDK 和 QEMU 都在开发容器内,固定为确切的版本。
在 macOS 上,请创建并启动一次 Podman 的虚拟机:
podman machine init --cpus 4 --memory 8192
podman machine start
三条命令
git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev
make setup 会把 NoWayOS 和 Screen Compiler 获取到该文件夹中,使用 starter 指定的提交,并构建开发容器:需要几分钟和约 5 GB,只需一次。如果您的机器缺少什么,它会告诉您,并且可以放心地再次运行。
make dev 运行应用,并在 http://localhost:8017/ 显示它。它与设备上运行的是同一份 Rust,只是为您的机器构建。输入一个名字,然后按 Continue。
修改它
打开 app/starter-app/tsx/welcome.tsx,改动一些文字并保存。屏幕会被检查、转换为 Rust、重新构建,并在大约一秒后重新显示,仍停留在您所在的屏幕。修改 app/starter-app/src/lib.rs 中的逻辑,窗口同样会跟随。
如果您写了 Screen Compiler 不转换的内容,它会在屏幕上方指出,给出所在行以及应改用什么,而上一个正确的版本会继续显示。
添加一个屏幕
make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks
第一条命令根据模板写出一个新屏幕,并打印把它接入逻辑的那几行代码。第二条命令用 NoWayOS 自己的渲染器把它绘制成图片;加上 WATCH=1,每次保存都会重新绘制。第三条命令在该屏幕上打开应用。
在 seL4 上启动
make qemu VNC=1
这会构建一个由四个保护域组成的真实 seL4 系统,并在 QEMU 中启动它。用它打印的密码打开 vnc://localhost:5900,然后用键盘和鼠标使用应用。make qemu-test 在没有屏幕的情况下启动它,并检查它打印和显示的内容。
每个部分所持有的每一项能力都列在 app/systems/starter.grants 中;如果系统给了某个部分该文件未列出的任何东西,构建就会失败。您的应用所在的部分持有它的消息环和帧缓冲区:没有设备,没有中断,没有网络。
把它变成您的
make rename NAME=my-product
make check
make rename 会在各处重命名 crate、程序和系统。make check 运行 lint、测试、屏幕检查和 QEMU 测试:在分享改动之前请运行它。
make ci 更进一步:它在您的应用程序上运行 NoWayOS 对自身运行的安全检查。代码树和任何提交中都没有密钥或凭据;每个依赖都采用宽松许可证、来自 crates.io,且没有已知的安全公告;没有 unsafe 代码;并为构成设备的内容生成一份软件物料清单。
接下来
- 用 React 制作屏幕:哪些内容会被转换。
- 从 React 移植:已有的界面,以及每条诊断的说明。
- 系统如何组成:保护域、环和授权。
- 在 Raspberry Pi 5 上运行:starter 在 QEMU 中运行;本页介绍开发板。