Installazione

Note sulle versioni rilasciate

WSL Dashboard offre tre diverse forme di file rilasciati per soddisfare diversi scenari d'uso:

Tipo di versione	Esempio di nome file	Descrizione
Versione portatile (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Metodo consigliato. File singolo portabile, nessuna installazione richiesta, esecuzione diretta. La configurazione viene salvata in ~\.wsldashboard.
Versione portatile (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Versione portatile compressa, adatta per la distribuzione manuale o per l'integrazione in altri set di strumenti.
Versione di installazione (Setup)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Programma di installazione standard. Dopo l'esecuzione crea il collegamento nel menu Start, l'icona sul desktop e registra la voce di disinstallazione di sistema.

TIP

Come scegliere?

• Se si cerca semplicità e velocità, scegliere la versione portatile (EXE).
• Se si desidera trovare l'applicazione nel "menu Start" come un normale software, scegliere la versione di installazione (Setup).

Metodi di installazione

WSL Dashboard offre quattro metodi di installazione, si può sceglierne uno a piacere:

Metodo 1: Download dal sito ufficiale (consigliato)

Visitare la pagina di download del sito ufficiale e selezionare il mirror più adatto alla propria area geografica.

Metodo 2: Installazione con winget

Installazione diretta tramite il gestore pacchetti di Windows (winget):

winget search wsl-dashboard
winget install wsl-dashboard

L'identificatore del pacchetto winget è Owu.WSLDashboard, con alias wsl-dashboard (senza distinzione tra maiuscole e minuscole); entrambi possono essere utilizzati.

Metodo 3: Precompilati da GitHub Releases

Visitare la pagina delle Release di GitHub per scaricare l'ultima versione. Se si scarica un archivio compresso, dopo l'estrazione basta eseguire wsldashboard.exe, senza alcuna installazione.

Metodo 4: Build dal codice sorgente

Se si desidera compilare autonomamente, assicurarsi che l'ambiente di sviluppo soddisfi i seguenti requisiti:

• Toolchain Rust: versione 1.92 o successiva.
• Obiettivo di build: x86_64-pc-windows-msvc.

Passaggi di compilazione

1. Clonare il repository:

   git clone https://github.com/owu/wsl-dashboard.git
   cd wsl-dashboard

2. Esecuzione in sviluppo:

   cargo run .

3. Build di produzione (utilizzando lo script fornito):

   .\build\portable\build.ps1

I file compilati si troveranno nella directory target/release.

Guida all'uso della versione portatile

La versione portatile non richiede installazione: basta eseguire wsldashboard.exe per utilizzarla; la configurazione viene salvata in ~\.wsldashboard. Per disinstallarla è sufficiente eliminare i file, senza lasciare residui nel sistema. La versione portatile offre funzionalità del tutto identiche alla versione di installazione, con la sola differenza che mancano le integrazioni di sistema come il collegamento nel menu Start, l'icona sul desktop e la voce di disinstallazione.