NoWayOS
PT
GitHub
MenuFechar

Comece aqui

Comece a sua própria aplicação

Clone o starter, rode três comandos e tenha a sua própria aplicação em uma janela do navegador, acompanhando as suas edições, e depois inicializando sobre o seL4 no QEMU.

O jeito mais rápido de começar é o starter: uma pequena aplicação sobre o NoWayOS, pronta para rodar e para ser alterada. Ela tem duas telas escritas em React, cerca de sessenta linhas de Rust que as ligam e um sistema seL4 para inicializar. Você não precisa conhecer Rust nem seL4 para começar.

O NoWayOS está em desenvolvimento, e o starter também: ele serve para aprender e construir.

O que você precisa

  • git e GNU Make.
  • Podman. Docker também funciona: acrescente ENGINE=docker a cada comando.
  • Mais nada. As toolchains do Rust, o Microkit SDK do seL4 e o QEMU estão dentro do contêiner de desenvolvimento, fixados em versões exatas.

No macOS, crie e inicie uma vez a máquina virtual do Podman:

podman machine init --cpus 4 --memory 8192
podman machine start

Três comandos

git clone https://github.com/NoWayOS/starter.git my-app
cd my-app
make setup
make dev

make setup traz o NoWayOS e o Screen Compiler para a pasta, nos commits que o starter indica, e constrói o contêiner de desenvolvimento: alguns minutos e cerca de 5 GB, uma única vez. Ele avisa se falta algo na sua máquina, e é seguro rodá-lo de novo.

make dev roda a aplicação e a mostra em http://localhost:8017/. É o mesmo Rust que roda no dispositivo, compilado para a sua máquina. Digite um nome e pressione Continue.

Altere

Abra app/starter-app/tsx/welcome.tsx, mude algum texto e salve. A tela é verificada, convertida em Rust, recompilada e mostrada de novo cerca de um segundo depois, na tela em que você estava. Mude a lógica em app/starter-app/src/lib.rs e a janela acompanha também.

Se você escrever algo que o Screen Compiler não converte, ele avisa acima da tela, com a linha e o que usar no lugar, e a última versão boa continua à vista.

Adicione uma tela

make new-screen NAME=thanks
make preview FILE=starter-app/tsx/thanks.tsx
make dev SCREEN=thanks

O primeiro comando escreve uma tela nova a partir de um modelo e imprime as linhas que a ligam à lógica. O segundo a desenha como imagem com o renderizador do próprio NoWayOS; acrescente WATCH=1 e ele redesenha a cada salvamento. O terceiro abre a aplicação nessa tela.

Inicialize sobre o seL4

make qemu VNC=1

Isso constrói um sistema seL4 real de quatro domínios de proteção e o inicializa no QEMU. Abra vnc://localhost:5900 com a senha que ele imprime e use a aplicação com o teclado e o mouse. make qemu-test o inicializa sem tela e verifica o que ele imprime e mostra.

Cada capacidade que uma parte detém está listada em app/systems/starter.grants, e a compilação falha se o sistema der a uma parte algo que esse arquivo não lista. A parte da sua aplicação detém os seus anéis de mensagens e o framebuffer: nenhum dispositivo, nenhuma interrupção, nenhuma rede.

Faça dela a sua

make rename NAME=my-product
make check

make rename renomeia os crates, os programas e o sistema em todos os lugares. make check roda os lints, os testes, a verificação das telas e o teste no QEMU: rode-o antes de compartilhar uma alteração.

make ci vai além: roda na sua aplicação as verificações de segurança que o NoWayOS roda em si mesmo. Nenhuma chave ou credencial na árvore ou em qualquer commit; cada dependência sob uma licença permissiva, vinda do crates.io, sem aviso de segurança conhecido; nenhum código unsafe; e uma lista de materiais de software do que compõe o dispositivo.

Para onde ir