X Linux
Menú de documentación

Resumen/x-arm — aarch64

Compilar X Linux para aarch64

Este repositorio es un build por overlay: clona equislinux/x en un commit fijado, aplica overlay/ y ejecuta archiso. El árbol x86_64 no se modifica.

1. Host de compilación

La ISO se compila en aarch64. En un Mac con Apple Silicon, crea una VM Arch Linux ARM (UTM, "Virtualize", 8 GiB de RAM, 20 GiB de disco) y trabaja dentro.

# dentro de la VM ALARM
pacman -Syu --needed base-devel git grub squashfs-tools libisoburn \
  dosfstools mtools erofs-utils mkinitcpio-archiso systemd-ukify \
  arch-install-scripts rsync qemu-img qemu-system-aarch64 xorriso libarchive

archiso no está empaquetado en ALARM. scripts/fetch-archiso.sh clona upstream, que ya soporta aarch64 (grub_target=arm64-efi, BOOTAA64.EFI, kernel_params_aarch64).

No compiles como root el repo: makepkg lo rechaza. Usa el usuario normal; solo build-iso.sh necesita root.

Como alternativa, el builder Docker ejecuta el mismo pipeline dentro de un contenedor Arch Linux ARM en cualquier host Docker (nativo en Apple Silicon), sin necesidad de una VM ALARM en el host.

2. Entradas

scripts/fetch-x.sh            # vendor/x en vendor/x.sha
scripts/fetch-archiso.sh      # vendor/archiso en vendor/archiso.sha
scripts/apply-overlay.sh      # reset + overlay + parches + checks

apply-overlay.sh resetea vendor/x y vendor/archiso a sus commits fijados, así el resultado es reproducible y no se cuelan ficheros viejos. Después aplica el overlay, los parches aarch64 del instalador y de mkarchiso, y ejecuta los checks estáticos.

vendor/x.sha es el contrato con x86_64: súbelo a propósito cuando quieras cambios nuevos de upstream, y vuelve a aplicar el overlay y los checks.

3. Repositorio [x]/aarch64

scripts/build-repo.sh              # sin firma (pruebas locales)
X_REPO_SIGN_KEY=... scripts/build-repo.sh --sign

Por defecto: x-release, x-wallpapers, x-dev, xfetch-bin, xtop-git. --all añade opencode-bin y x-kde-settings.

Los overrides de overlay/packages/ pasan a aarch64 lo que era x86_64:

PaqueteCambio
xfetch-bintarball aarch64 v1.0.1 + sha256 fijado
opencode-binv1.19.5 opencode-linux-arm64.tar.gz + sha256 fijado
xtop-gitarch=('aarch64'); Rust desde fuente
x-release, x-wallpapers, x-dev, x-kde-settingsany, sin cambios

Salida: out/repo/aarch64/ (x.db, paquetes, SHA256SUMS, firmas).

4. ISO

sudo scripts/build-iso.sh                  # usa out/repo/aarch64
sudo scripts/build-iso.sh --no-repo        # usa la URL publicada de [x]/aarch64

build-iso.sh renderiza pacman.aarch64.conf, apunta [x] al repo local (file://) y los mirrors ALARM al mirrorlist incluido. Luego ejecuta mkarchiso, comprueba que existen EFI/BOOT/BOOTAA64.EFI, arch/boot/aarch64/Image e initramfs-linux.img, e imprime el SHA-256.

Salida: out/iso/x-<versión>-aarch64.iso.

5. Imagen de VM

scripts/build-vm.sh --create      # qcow2 vacío
scripts/build-vm.sh --install     # arranca la ISO con scripts/vm.sh
scripts/build-vm.sh --export      # .qcow2 + .raw + .sha256 en out/vm/

Ver Imágenes de VM para importar en UTM/Parallels/VMware y el aviso de no-3D.

6. Publicar

X_REPO_SIGN_KEY=... scripts/publish-repo.sh --push
X_REPO_SIGN_KEY=... scripts/publish-arm.sh --verify

publish-repo.sh publica out/repo/aarch64 en el repositorio GitHub Pages equislinux/x-arm-repo, servido en https://equislinux.github.io/x-arm-repo/repo/aarch64; x-repo sigue sirviendo solo x86_64. publish-arm.sh sube la ISO a SourceForge (/home/frs/project/equislinux/arm/iso) y actualiza web/data/releases-arm.json, separado del índice x86_64.

Problemas típicos

SíntomaCausaArreglo
target not found: linuxALARM no tiene linuxusa linux-aarch64 (ya está en packages.aarch64)
target not found: archisono está en ALARMscripts/fetch-archiso.sh
target not found: stubbleno está en ALARMaviso esperado; no se fusionan DTBs
grub-mkstandalone: cannot find arm64-efihost x86_64compila en aarch64; instala grub de ALARM
la ISO no tiene BOOTAA64.EFIse coló el perfil x86apply-overlay.sh y revisa bootmodes
xgen: no archived kernelxgen busca vmlinuz-*gap conocido; x gen new es best-effort
error de firma de la DBlas DB de ALARM no están firmadasSigLevel = Required DatabaseOptional
arranca sin salida por serieconsole=ttyS0 es x86console=ttyAMA0
makepkg se niegase ejecutó como rootusa un usuario normal

Estado de paridad

Hecho: perfil, lista de paquetes, repo [x], ISO, imágenes de VM, publicación y parche del instalador (UEFI, arm64-efi, BOOTAA64, Image, keyring ALARM, repos ALARM).

Pendiente: validar el delta x-scripts-arm (equislinux/scripts-arm, que parchea Image/Image.gz y la ausencia de pkgbase en el motor de generaciones) en una instalación desatendida completa en VM; generación de bundles .utm; pruebas en hardware aarch64 real. Nada de esto impide arrancar e instalar.

El delta se construye con scripts-arm/build.sh y produce x-scripts-arm, que provides/conflicts/replaces x-scripts en aarch64. Todavía no está publicado en [x]/aarch64; instala el paquete construido con pacman -U.

Editar esta página en GitHub