Instalação

Sobre as versões de lançamento

O WSL Dashboard oferece três formas diferentes de arquivos de lançamento, para atender a diferentes cenários de uso:

Tipo de versão	Exemplo de nome de arquivo	Descrição
Versão portátil (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Forma recomendada. Arquivo único, sem instalação, execute diretamente. As configurações são armazenadas em ~\.wsldashboard.
Versão portátil (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Versão portátil compactada, adequada para implantação manual ou integração com outras ferramentas.
Versão de instalação (Setup)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Instalador padrão. Após a execução, cria atalhos no menu Iniciar, ícone na área de trabalho e registra o item de desinstalação do sistema.

TIP

Como escolher?

• Se você busca simplicidade e rapidez, escolha a versão portátil (EXE).
• Se deseja encontrá-lo no "Menu Iniciar" como um software comum, escolha a versão de instalação (Setup).

Formas de instalação

O WSL Dashboard oferece quatro formas de instalação; você pode escolher qualquer uma delas de acordo com sua preferência:

Forma 1: Download do site oficial (recomendado)

Acesse a página de download oficial e escolha o espelho mais adequado à sua região.

Forma 2: Instalação via winget

Instale diretamente pelo gerenciador de pacotes do Windows (winget):

winget search wsl-dashboard
winget install wsl-dashboard

O identificador do pacote winget é Owu.WSLDashboard, com alias wsl-dashboard (sem diferenciar maiúsculas/minúsculas); ambos podem ser usados.

Forma 3: Pré-compilado do GitHub Releases

Vá para a página GitHub Releases e baixe a versão mais recente. Se baixar o pacote compactado, basta extraí-lo e executar wsldashboard.exe — sem necessidade de instalação.

Forma 4: Compilação a partir do código-fonte

Se preferir compilar por conta própria, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes requisitos:

• Toolchain Rust: versão 1.92 ou superior.
• Destino de compilação: x86_64-pc-windows-msvc.

Passos da compilação

1. Clone o repositório:

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

2. Executar em desenvolvimento:

   cargo run .

3. Build de produção (usando o script fornecido):

   .\build\portable\build.ps1

Os artefatos compilados estarão no diretório target/release.

Guia da versão portátil

A versão portátil não requer instalação: basta executar wsldashboard.exe e usá-la; as configurações são armazenadas em ~\.wsldashboard. Para desinstalar, basta excluir o arquivo, sem deixar resíduos no sistema. A versão portátil tem exatamente os mesmos recursos da versão de instalação, apenas sem a integração do sistema, como atalhos no menu Iniciar, ícone na área de trabalho e item de desinstalação.