Desarrolladores
Compila y ejecuta AriCodeOS
Todo pasa por cargo xtask: compilar el cargador y el kernel, montar la imagen, arrancar QEMU con OVMF y ejecutar la batería de escenarios.
Requisitos
Un equipo con Debian 13
rust-toolchain.toml fija la versión de Rust y añade automáticamente los targets x86_64-unknown-none y x86_64-unknown-uefi.
sudo apt install qemu-system-x86 ovmf nasm clang lld gdb git make
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup target add wasm32-unknown-unknown # módulos WebAssembly de ejemplocargo xtask
Órdenes de cada día
Añade --debug a cualquier orden para usar el perfil de desarrollo.
cargo xtask build # AriBoot y AriKernel (release)
cargo xtask image # ESP con BOOTX64.EFI, kernel e initrd
cargo xtask run # QEMU + OVMF, consola serie en la terminal
cargo xtask run --cmdline shell # shell interactivo (arish)
cargo xtask run --cmdline gui # compositor con dos ventanas de prueba
cargo xtask run --cpus 4 # cuatro procesadores (SMP)
cargo xtask test # pruebas unitarias + arranque básico
cargo xtask test --all # todos los escenarios QEMU; obligatorio antes de main
cargo xtask test --all --cpus 4 # toda la batería como prueba de estrés SMP
cargo xtask check # rustfmt --check + clippy -D warningsSDK
Escribe un programa
Un programa de AriCodeOS es un ELF estático de ring 3 cargado en 0x400000 que solo puede hacer lo que le permiten sus handles. aricode-rt aporta el punto de entrada, un heap, el gestor de pánico y los envoltorios de las llamadas al sistema.
#![no_std]
#![no_main]
use aricode_rt::sys;
fn main(arg: u64) -> u64 {
sys::print(b"hello\n");
0 // código de salida
}
aricode_rt::entry!(main);name = hello_app
caps = system, fs
memory = 128K
read_files = hola.txt
# se lanza desde el shell:
# ari> run hello_app 7Pruebas
290 escenarios que arrancan el sistema real
Cada librería no_std tiene pruebas unitarias en el equipo de desarrollo. Los escenarios de integración son ficheros TOML: QEMU arranca sin pantalla, se captura la salida serie y cada escenario exige líneas como ARICODEOS_KERNEL_READY, prohíbe KERNEL PANIC y comprueba el código de salida. Los escenarios de fallo provocan ELF truncados, kernels ausentes, pánicos y cortes de corriente en mitad de una escritura. Un ejecutor en paralelo pasa toda la batería, con 1 y 4 CPU, en unos doce minutos (ADR 0040).
Repositorio
Dónde está cada cosa
- boot/: AriBoot, el cargador UEFI
- kernel/: AriKernel, un ELF64 en la mitad alta
- boot-protocol/: la ABI BootInfo que comparten cargador y kernel
- libs/: 49 librerías no_std con pruebas en el equipo de desarrollo
- desktop/: las aplicaciones firmadas del escritorio: lanzador, terminal, editor, ficheros y ajustes
- services/: init, drivers, AriFS, red, compositor, shell, sshd
- sdk/: ABI, envoltorios de syscalls, protocolos IPC y runtime
- apps/: aplicaciones de ejemplo, el instalador y el actualizador
- tests/qemu/: escenarios de integración declarativos
- docs/: arquitectura, decisiones, auditorías e incidentes