Distribuire un'app desktop

Durante lo sviluppo si usa cargo run, che crea un binario di debug non ottimizzato. Per la distribuzione serve una build release: cargo build --release.

Le build release abilitano le ottimizzazioni e rimuovono il sovraccarico del debug, producendo un binario molto più piccolo e veloce nella cartella target/release/.

Le applicazioni egui possono essere grandi perché collegano staticamente un backend GPU. Riduca le dimensioni con un profilo release in Cargo.toml.

Abilitare l’ottimizzazione al tempo del linking, una sola unità di codegen, l’interruzione tramite panic e la rimozione dei simboli può ridurre di diversi megabyte l’eseguibile finale.

Su Windows, un’applicazione GUI non dovrebbe aprire una finestra della console. Aggiunga l’attributo windows_subsystem alla radice del crate, limitandolo alla release, così durante lo sviluppo potrà continuare a visualizzare i log.

Senza questa impostazione, facendo doppio clic sull’eseguibile comparirà brevemente un terminale nero accanto alla finestra.

Un’applicazione curata usa una propria icona per la finestra. Carichi i byte PNG all’avvio, li decodifichi in RGBA e passi un IconData tramite NativeOptions.

Includa l’immagine con include_bytes!, così l’icona viene inserita nel binario invece di essere distribuita come file separato.

ViewportBuilder controlla la finestra nativa: dimensioni iniziali, dimensioni minime, titolo, possibilità di ridimensionamento e decorazioni.

Imposti valori predefiniti ragionevoli, in modo che al primo avvio l’applicazione si apra con dimensioni utilizzabili invece che in una finestra troppo piccola o troppo grande.

Per distribuire un unico file, incorpori direttamente nel binario font, immagini e configurazione con include_bytes! e include_str!.

In questo modo evita di distribuire una cartella di risorse e impedisce che l’applicazione smetta di funzionare quando viene avviata da una directory di lavoro diversa.

Su macOS, un semplice binario non è un’applicazione avviabile con un clic. Serve un bundle .app con un Info.plist e un’icona .icns.

Lo strumento cargo-bundle automatizza questa procedura leggendo i metadati dalla sezione [package.metadata.bundle] di Cargo.toml.

Per distribuire l’applicazione su altre macchine macOS è necessario firmarla con un certificato Developer ID e sottoporla alla notarizzazione di Apple; in caso contrario Gatekeeper la bloccherà.

Usi codesign per firmare il bundle, quindi lo invii con notarytool e applichi il ticket. Anche Windows trae vantaggio da una firma Authenticode, che evita gli avvisi di SmartScreen.

Ogni sistema operativo richiede una build nativa perché eframe collega librerie GPU e di gestione delle finestre specifiche della piattaforma. L’approccio più affidabile consiste nel compilare su ciascun sistema operativo di destinazione, spesso tramite runner CI.

Strumenti come cross sono utili per le destinazioni Linux, ma la vera cross-compilation di binari GUI verso macOS o Windows da Linux è fragile: è preferibile usare build CI in matrice.

egui viene compilato anche in WebAssembly. Eseguite la compilazione con il target wasm32-unknown-unknown e create il bundle con trunk, che produce un insieme di file HTML/JS/WASM che potete ospitare staticamente.

Lo stesso codice App viene eseguito nel browser tramite eframe::WebRunner, montato su un elemento canvas.

Prima della distribuzione: ottimizzate il profilo di release per ridurre le dimensioni, nascondete la console di Windows, incorporate un'icona e le risorse, create il bundle per macOS e firmate l'applicazione sia per macOS sia per Windows.

Testate l'artefatto finale su una macchina pulita, non sul vostro computer di sviluppo, per individuare librerie di sistema mancanti o avvisi relativi a binari non firmati che gli utenti incontrerebbero.

Perché aggiungere l'attributo windows_subsystem?

Create la build con cargo build --release, quindi ottimizzate il profilo di release per ridurre le dimensioni e nascondete la console di Windows. Impostate l'icona e il viewport della finestra e incorporate le risorse con include_bytes! per ottenere un binario autonomo.

Su macOS create il bundle con cargo-bundle, quindi firmatelo e sottoponetelo a notarizzazione; create una build per ogni sistema operativo tramite CI per garantire la compatibilità multipiattaforma e usate trunk come target WebAssembly. Testate sempre l'artefatto finale su una macchina pulita. In questo modo il corso su egui è completo.