Saltar al contenido

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.

bash
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 ejemplo

cargo xtask

Órdenes de cada día

Añade --debug a cualquier orden para usar el perfil de desarrollo.

bash
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 warnings

SDK

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.

src/main.rs
#![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);
hello_app.manifest
name       = hello_app
caps       = system, fs
memory     = 128K
read_files = hola.txt

# se lanza desde el shell:
# ari> run hello_app 7

Pruebas

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