Installation

Notes sur les versions publiées

WSL Dashboard propose trois formats de fichiers différents pour répondre à divers scénarios d'utilisation :

Type de version	Exemple de nom de fichier	Description
Version portable (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Méthode recommandée. Fichier unique autonome, sans installation, exécution directe. La configuration est stockée dans ~\.wsldashboard.
Version portable (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Version portable compressée, idéale pour un déploiement manuel ou l'intégration dans des suites d'outils.
Version d'installation (Setup)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Installateur standard. Crée un raccourci dans le menu Démarrer, une icône sur le bureau et enregistre l'entrée de désinstallation système.

TIP

Comment choisir ?

• Si vous recherchez la simplicité et la rapidité, choisissez la version portable (EXE).
• Si vous souhaitez le trouver dans le « menu Démarrer » comme un logiciel normal, choisissez la version d'installation (Setup).

Méthodes d'installation

WSL Dashboard propose quatre méthodes d'installation ; choisissez celle que vous préférez :

Méthode 1 : Téléchargement depuis le site officiel (recommandé)

Visitez la page de téléchargement officielle et choisissez le miroir adapté à votre région.

Méthode 2 : Installation via winget

Installez directement via le gestionnaire de paquets Windows (winget) :

winget search wsl-dashboard
winget install wsl-dashboard

L'identifiant du paquet winget est Owu.WSLDashboard, avec l'alias wsl-dashboard (insensible à la casse) ; les deux fonctionnent.

Méthode 3 : Binaires précompilés de GitHub Releases

Rendez-vous sur la page GitHub Releases pour télécharger la dernière version. Si vous téléchargez l'archive compressée, décompressez-la et exécutez directement wsldashboard.exe, sans installation.

Méthode 4 : Compilation depuis les sources

Si vous souhaitez compiler vous-même, assurez-vous que votre environnement de développement répond aux exigences suivantes :

• Chaîne d'outils Rust : version 1.92 ou ultérieure.
• Cible de compilation : x86_64-pc-windows-msvc.

Étapes de compilation

1. Clonez le dépôt :

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

2. Exécution en développement :

   cargo run .

3. Compilation de production (à l'aide du script fourni) :

   .\build\portable\build.ps1

Les artefacts de compilation se trouveront dans le répertoire target/release.

Guide de la version portable

La version portable ne nécessite aucune installation : exécutez simplement wsldashboard.exe. La configuration est stockée dans ~\.wsldashboard. Pour désinstaller, il suffit de supprimer les fichiers ; aucun résidu n'est laissé dans le système. La version portable offre exactement les mêmes fonctionnalités que la version d'installation ; seules les intégrations système manquent (raccourci du menu Démarrer, icône du bureau, entrée de désinstallation).