Files
harbour-grumpydove/spike

Spike: il motore di GrumpyDove su ARM

Due prove separate, entrambe riproducibili: il motore compilato ed eseguito in emulazione, e il motore linkato con le librerie vere e con la vista al posto di Qt.

1. Il motore gira (run.sh)

Compila con il cross Debian e esegue in emulazione aarch64:

  • un «hello Ada»;
  • tutti i file Ada del motore (verifica semantica);
  • un programma che legge una Maildir vera con il motore;
  • un test di tasking (3 task, protected object, 30.000 incrementi).
./run.sh /percorso/grumpydove/src

2. Il motore completo, con gli shim C (questo file)

Serve a provare che il motore si linka con libetpan, gpgme, jansson, curl, gnutls e libxml2 — cioè come sarà nell'app — senza Qt e senza telefono.

./build_engine.sh /percorso/grumpydove

Fa tutto da sé, in work/ e senza root: sysroot (se manca), compilazione Ada, shim C e C++ (PGP e S/MIME compresi), link, esecuzione in emulazione. I passi qui sotto spiegano cosa fa e perché.

Sysroot aarch64 senza root

cross_sysroot.py scarica dai repo Debian i .deb arm64 delle librerie (e delle loro dipendenze) e li estrae in un albero locale, da passare come --sysroot al compilatore cross.

curl -o /tmp/arm64-Packages.xz \
  http://ftp.it.debian.org/debian/dists/bookworm/main/binary-arm64/Packages.xz
python3 cross_sysroot.py sysroot /tmp/arm64-Packages.xz    # ~120 pacchetti, 67 MB

Note che sono costate tempo:

  • l'indice va decompresso con xz (1,8 s), non con lzma di Python (oltre 120 s su questo host);
  • libc6 non va escluso dalle dipendenze: senza, il linker non trova libc.so.6 né ld-linux-aarch64.so.1;
  • serve anche zlib1g-dev, altrimenti -lz fallisce;
  • il runtime Ada (libgnat-12.so, libgnarl-12.so) va copiato dal cross dentro il sysroot, o il binario non parte.

Compilare e linkare

SYS=$PWD/sysroot
# Ada (motore)
aarch64-linux-gnu-gnatmake -c -gnat2022 -O2 -Isrc src/grumpydove.adb
# shim C
aarch64-linux-gnu-gcc-12 --sysroot=$SYS -O2 -fPIC -Isrc \
    -I$SYS/usr/include/libxml2 -c imap_shim.c jmap_shim.c smtp_bridge.c \
    carddav_shim.c image_fetch.c
# stub della vista (gd_run) e di PGP/S-MIME: sostituiscono qt_shim.cpp e
# gpg_shim.cpp, che richiedono Qt 6 e g++, non disponibili nel cross
aarch64-linux-gnu-gcc-12 --sysroot=$SYS -O2 -fPIC -Isrc -c stub_gui.c stub_pgp.c
# link
aarch64-linux-gnu-gnatmake -gnat2022 -O2 -Isrc src/grumpydove.adb -largs *.o \
    --sysroot=$SYS -L$SYS/usr/lib/aarch64-linux-gnu \
    -letpan -lgpgme -ljansson -lcurl -lgnutls -lxml2 -lz -lpthread -ldl

gnatlink diretto su questo host risponde Failed to open binder output: si passa da gnatmake ... -largs, che fa le stesse cose e funziona.

Eseguire

HOME=<cartella con Mail/> qemu-aarch64-static -L $SYS ./grumpydove

Esito (11 novembre 2026):

--- cartelle viste dal motore (senza Qt) ---
Local / In / Out / Junk / Trash / In / Out / progetti / In / Out
--- messaggio in testa a ogni cartella ---
cartella 5 (In): 1 KB
  colonna 1: 3
  colonna 4: Luca Bianchi

Il motore elenca le cartelle, apre «In», legge il messaggio e ne restituisce i campi attraverso le callback che riceve dalla vista: è esattamente il contratto che il bridge QML dovrà fornire.

Cosa manca

  • gpg_shim.cpp ora è incluso: compilato con g++-12-aarch64-linux-gnu, il binario definisce gd_pgp_* e gd_smime_* veri e dipende da libgpgme.so.11. Lo stub stub_pgp.c non serve più (si può togliere dal link).
  • Il sysroot è Debian: prima della consegna va rifatto contro le librerie del telefono (un tar di /lib e /usr/lib dal device).

Le dipendenze che il pacchetto dovrà soddisfare

readelf -d sul motore linkato elenca:

libetpan.so.20  libgpgme.so.11  libjansson.so.4  libcurl-gnutls.so.4
libgnutls.so.30  libxml2.so.2  libstdc++.so.6  libgnarl-12.so
libgnat-12.so  libgcc_s.so.1  libc.so.6

Su Sailfish esistono curl, gnutls, libxml2 (con nomi e versioni da verificare: libcurl-gnutls.so.4 non è libcurl.so.4) e il runtime Ada va incluso; non esistono libetpan, gpgme e jansson: vanno compilate e messe nel pacchetto.