Installazione su Linux (.deb)

Su Ubuntu 22.04 / Debian il modo consigliato per installare DroneField è il pacchetto nativo .deb. Il runtime .NET 10 self-contained è incluso, quindi la macchina non richiede alcun .NET preinstallato. Per altre distribuzioni, usa l’AppImage descritto nella pagina Installazione.

Distribuzione supportata

Il sistema di destinazione del .deb è Ubuntu 22.04 LTS.

Ubuntu 24.04

Il runtime nativo OpenCV incluso nel pacchetto è stato compilato sullo stack di sistema di Ubuntu 22.04. Su Ubuntu 24.04 non si carica in fase di esecuzione (versioni major incompatibili di libtesseract, ffmpeg, libtiff e OpenEXR). Su 24.04, per ora usa l’AppImage — seguirà una build dedicata per 24.04.

Passo 1 — Scaricare il pacchetto

Accedi a my.dronefield.app, apri Download nel menu a sinistra e, nella scheda Ultima versione stabile, scarica il .deb per Linux (circa 100–130 MB). Il file ha un nome simile a dronefield_26.2.18_amd64.deb.

Passo 2 — Installazione

Dalla cartella in cui hai scaricato il file:

sudo apt install ./dronefield_26.2.18_amd64.deb

Consiglio

Usa apt install ./file.deb invece di dpkg -i ./file.deb — apt risolve automaticamente le dipendenze di runtime (libx11-6, libvulkan1, ecc.). Con dpkg -i dovresti poi installare manualmente le dipendenze mancanti con sudo apt install -f.

Passo 3 (facoltativo) — Verificare il download

Le release firmate includono una firma .deb.asc separata accanto al .deb. Per verificarla basta il gnupg standard. Importa una volta la chiave di rilascio dell’editore:

wget https://dronefield.app/keys/dronefield-release.asc
gpg --import dronefield-release.asc

Quindi verifica il pacchetto scaricato:

gpg --verify dronefield_26.2.18_amd64.deb.asc dronefield_26.2.18_amd64.deb

La riga Good signature from "DroneSpot Kft <support@dronefield.app>" indica che il pacchetto è autentico. Al primo avvio compare anche WARNING: This key is not certified with a trusted signature — è normale, perché la chiave è autofirmata dall’editore. Ciò che conta è che l’impronta (fingerprint) corrisponda a quella pubblicata su dronefield.app/keys. Se vedi BAD signature o Can't check signature, fermati e contatta l’assistenza.

Passo 4 — Dopo l’installazione

• Nel menu delle applicazioni compare una voce DroneField nella categoria Istruzione / Scienza (Education / Science).
• Si avvia anche da terminale con dronefield (da qualsiasi directory di lavoro).
• I file del programma si trovano in /usr/lib/dronefield/ (sola lettura; solo root può modificarli).
• L’icona viene installata in tutte le dimensioni standard (16–256 px).

Passo 5 — Primo avvio

Al primo avvio compare una schermata di accesso:

1. Inserisci email e password del tuo account del portale.
2. Fai clic su Accedi.
3. DroneField registra automaticamente il tuo dispositivo sul tuo account (vedi Gestione dispositivi).
4. Leggi e accetta il Contratto di licenza con l’utente finale (EULA). È un passaggio unico; se l’EULA viene aggiornata in seguito, l’accettazione viene richiesta di nuovo.

Ora puoi creare il tuo primo progetto — vedi Primo progetto in 10 minuti.

I tuoi progetti si trovano per impostazione predefinita in ~/DroneField/. Per cambiare posizione, vedi Installazione → Cartella dati e progetti.

Disinstallazione

sudo apt remove dronefield     # mantiene la configurazione in ~/.config/
sudo apt purge dronefield      # rimuove anche i dati debconf

I tuoi progetti in ~/DroneField/ non vengono mai toccati da remove o purge.

Risoluzione dei problemi

Se l’applicazione non si avvia con l’errore «shared object not found», manca una libreria di runtime. Installa le dipendenze mancanti con:

sudo apt install -f

Se l’errore persiste, contatta l’assistenza indicando il nome esatto del .so mancante riportato nel messaggio di errore.