Инструкция по установке
Поддерживаемые платформы
- Windows 10/11 AMD64/ARM64
- MacOS 10.15+ AMD64 for development, MacOS 10.13+ for release
- MacOS 11.0+ ARM64
- Linux AMD64/ARM64
Зависимости
Wails имеет ряд общих зависимостей, которые необходимы перед установкой:
- Go 1.21+ (macOS 15+ requires Go 1.23.3+)
- NPM (Node 15+)
Go
Скачайте Go с Go Downloads Page.
Убедитесь, что вы следуете официальным Инструкциям по установке. Вам также нужно убедиться, что ваша переменная окружения PATH также включает путь к вашему каталогу ~/go/bin. Перезапустите терминал и выполните следующие шаги:
- Проверьте то, что Go установлен правильно:
go version - Проверьте "~/go/bin" в переменной PATH:
echo $PATH | grep go/bin
NPM
Загрузите NPM отсюда: Node Downloads Page. Лучше использовать последнюю версию, так как это то, что мы её обычно тестируем.
Запустите npm --version для проверки.
Зависимости платформы
Вам также нужно установить специфичные для платформы зависимости:
- Windows
- MacOS
- Linux
Wails требует установки инструментов xcode command line tools. Их можно установить,
запустив xcode-select --install.
Wails требует установки WebView2. В некоторых установках Windows это уже установлено. Вы можете проверить используя команду wails doctor.
Linux requires the standard gcc build tools plus libgtk3 and libwebkit. Вместо того чтобы перечислять огромное количество команд для разных дистрибутивов, Wails может попробовать определить команды установки, специфичные для вашего дистрибутива. Запустите wails doctor после установки, чтобы узнать, как установить зависимости. Если ваш дистрибутив или менеджер пакетов не поддерживается, пожалуйста, обратитесь к руководству Добавление дистрибутива Linux.
Note:
If you are using latest Linux version (example: Ubuntu 24.04) and it is not supporting libwebkit2gtk-4.0-dev, then you might encounter an issue in wails doctor: libwebkit not found. To resolve this issue you can install libwebkit2gtk-4.1-dev and during your build use the tag -tags webkit2_41.
Необязательные зависимости
Установка Wails
Выполните go install github.com/wailsapp/wails/v2/cmd/wails@latest для установки Wails CLI.
Примечание: Если вы получите ошибку, похожую на эту:
....\Go\pkg\mod\github.com\wailsapp\wails\v2@v2.1.0\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found
пожалуйста, убедитесь, что у вас установлен Go 1.18+:
go version
Проверка системы
Запуск wails doctor проверит установлены ли у вас правильные зависимости. Если нет, то он покажет что не хватает, и покажет как исправить какие-либо проблемы.
Отсутствует команда wails?
Если ваша система пишет, что команда wails отсутствует, удостоверьтесь, что вы корректно следовали инструкции по установке Go. Обычно это значит, что папка go/bin, находящаяся в домашней папке пользователя не добавлена в переменную окружения PATH. Обычно после изменения переменных окружения нужно переоткрыть командную строку, чтобы изменения применились в ней.