NoWayOS
ZH
GitHub
菜单关闭

从这里开始

开始您自己的应用

克隆 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 代码;并为构成设备的内容生成一份软件物料清单。

接下来