Pular para o conteúdo principal
Versão: v2.11.0

Instalação

Plataformas Suportadas​

  • Windows 10/11 AMD64/ARM64
  • MacOS 10.15+ AMD64 for development, MacOS 10.13+ for release
  • MacOS 11.0+ ARM64
  • Linux AMD64/ARM64

Dependências​

O Wails tem várias dependências comuns que são necessárias antes da instalação:

  • Go 1.21+ (macOS 15+ requires Go 1.23.3+)
  • NPM (Node 15+)

Go​

Baixe o Go direto da página de download do Go.

Certifique-se de seguir as instruções oficiais de instalação do Go. Você também precisará garantir que sua variável de ambiente PATH também inclua o caminho para o seu diretório ~/go/bin. Reinicie seu terminal e faça as seguintes verificações:

  • Verificar se o Go está instalado corretamente: go version
  • Cheque se ~/go/bin está nas suas variáveis de ambiente echo $PATH | grep go/bin

NPM​

Baixe o NPM da Página de downloads do Node. É melhor usar o último lançamento, pois é isso que costumamos testar.

Execute npm --version para verificar.

Dependências específicas da plataforma​

Você também precisará instalar as dependências específicas da plataforma:

Wails requires that the WebView2 runtime is installed. Algumas instalações do Windows já terão isto instalado. Você pode conferir usando o comando do wails doctor.

Dependências opcionais​

  • UPX para comprimir suas aplicações.
  • NSIS for generating Windows installers.

Instalando Wails​

Execute instale github.com/wailsapp/wails/v2/cmd/wails@latest para instalar a CLI do Wails.

Note: If you get an error similar to this:

....\Go\pkg\mod\github.com\wailsapp\wails\v2@v2.1.0\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found

please check you have Go 1.18+ installed:

go version

Verificação do sistema​

Ao executar wails doctor verificará quais dependências estão instaladas corretamente. Caso contrário, aconselhará sobre o que está em falta e ajudará a corrigir quaisquer problemas.

O comando wail parece estar faltando?​

Se o sistema está relatando que o comando wail está faltando, certifique-se de ter seguido o guia de instalação corretamente. Normalmente, isso significa que o diretório go/bin no diretório do seu usuário não está na variável do ambiente PATH. Você normalmente também precisará fechar e reabrir qualquer prompt de comando aberto para que as alterações no ambiente feitas pelo instalador sejam refletidas no prompt de comando.