NoWayOS
JA
GitHub
メニュー閉じる

ここから始める

自分のアプリケーションを始める

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なコードがないこと。そして、デバイスを構成するもののソフトウェア部品表です。

次に読むもの