インストール

対応プラットフォーム

• Windows 10/11 AMD64/ARM64
• macOS 10.15+ AMD64 (macOS 10.13以降にデプロイ可能)
• macOS 11.0+ ARM64
• Ubuntu 24.04 AMD64/ARM64 (他のLinuxでも動作する可能性があります)

依存関係

Wailsをインストールする前に、以下の共通の依存関係をインストールする必要があります。

Go (1.24以降)

Go ダウンロードページからGoをダウンロードしてください。

公式のGoインストール手順に従ってください。また、PATH環境変数に~/go/binディレクトリのパスが含まれていることを確認する必要があります。ターミナルを再起動し、以下のチェックを行ってください。

• Goが正しくインストールされているか確認: go version
• ~/go/binがPATH変数に含まれているか確認
  • Mac / Linux: echo $PATH | grep go/bin
  • Windows: $env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

npm (オプション)

Wails自体はnpmのインストールを必要としませんが、バンドルされているテンプレートのほとんどで必要となります。

Node ダウンロードページから最新のNodeインストーラーをダウンロードしてください。一般的にテスト対象となる最新リリースを使用することをお勧めします。

npm --versionを実行して確認してください。

ノート

npm以外のパッケージマネージャーをお使いの場合は、それをご利用ください。プロジェクトのTaskfilesを更新して使用する必要があります。

プラットフォーム固有の依存関係

さらに、プラットフォーム固有の依存関係もインストールする必要があります。

Mac

Wailsではxcodeコマンドラインツールがインストールされている必要があります。これは以下を実行することでインストールできます。

xcode-select --install

Windows

WailsではWebView2 Runtimeがインストールされている必要があります。ほとんどのWindowsインストールでは既にインストールされています。wails doctorコマンドを使用して確認できます。

Linux

Linuxでは標準のgccビルドツールに加えてgtk3とwebkit2gtkが必要です。インストール後にwails doctorを実行すると、依存関係のインストール方法が表示されます。お使いのディストリビューションやパッケージマネージャーがサポートされていない場合は、Discordでお知らせください。

インストール

Go Modulesを使用してWails CLIをインストールするには、以下のコマンドを実行してください。

go install -v github.com/wailsapp/wails/v3/cmd/wails3@latest

最新の開発版をインストールしたい場合は、以下のコマンドを実行してください。

git clone https://github.com/wailsapp/wails.git
cd wails
cd v3/cmd/wails3
go install

開発版を使用する場合、生成されるすべてのプロジェクトはGoのreplaceディレクティブを使用して、プロジェクトが開発版のWailsを使用するようにします。

システムチェック

wails3 doctorを実行すると、必要な依存関係が正しくインストールされているか確認できます。不足しているものがある場合は、何が不足しているか、および問題を解決する方法を案内します。

wails3コマンドが見つからない場合？

システムがwails3コマンドが見つからないと報告している場合は、以下を確認してください。

• 上記のGoインストールガイドを正しく従っていること、およびgo/binディレクトリがPATH環境変数に含まれていることを確認してください。
• 新しいPATH変数を反映させるために、現在のターミナルを閉じて再度開いてください。