ここから始める
自分のアプリケーションを始める
starterをクローンし、3つのコマンドを実行すると、自分のアプリケーションがブラウザーのウィンドウで動き、編集に追従し、続いてQEMUのseL4上で起動します。
いちばん早く始める方法はstarterです。NoWayOS上の小さなアプリケーションで、すぐに動かせ、すぐに変更できます。Reactで書かれた2つの画面、それらをつなぐ約60行の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
3つのコマンド
git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev
make setupは、starterが指定するコミットのNoWayOSとScreen Compilerをこのフォルダーに取得し、開発コンテナをビルドします。数分と約5 GBで、一度だけです。お使いのマシンに足りないものがあれば知らせ、何度実行しても安全です。
make devはアプリケーションを実行し、http://localhost:8017/に表示します。デバイス上で動くのと同じRustを、お使いのマシン向けにビルドしたものです。名前を入力してContinueを押してください。
変更する
app/starter-app/tsx/welcome.tsxを開き、文言を少し変えて保存します。画面はチェックされ、Rustに変換され、再ビルドされて、約1秒後に、いた画面のまま再び表示されます。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
1つ目のコマンドは、テンプレートから新しい画面を書き、それをロジックにつなぐ行を表示します。2つ目は、NoWayOS自身のレンダラーでその画面を画像として描きます。WATCH=1を付けると、保存のたびに描き直します。3つ目は、アプリケーションをその画面で開きます。
seL4上で起動する
make qemu VNC=1
これは4つの保護ドメインからなる本物の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で動きます。このページはボードを扱います。