Local Development
Overview
Wails is in constant development and new releases are regularly "tagged". This usually happens when all the newer code on master
has been tested and confirmed working. If you need a bugfix or feature that has not yet made it to a release, it's possible to use the latest "bleeding edge" version using the following steps:
git clone https://github.com/wailsapp/wails
cd wails/v2/cmd/wails
go install
NOTE: The directory that you cloned the project into will now be called "clonedir".
The Wails CLI will now be at the very latest version.
Updating your project
To update projects to use the latest version of the Wails library, update the project's go.mod
and ensure the following line is at the bottom of the file:
replace github.com/wailsapp/wails/v2 => <clonedir>
Example:
On Windows: replace github.com/wailsapp/wails/v2 => C:\Users\leaan\Documents\wails-v2-beta\wails\v2
On 'nix: replace github.com/wailsapp/wails/v2 => /home/me/projects/wails/v2
To revert to a stable version, run:
go install github.com/wailsapp/wails/v2/cmd/wails@latest
Testing a Branch
If you want to test a branch, follow the instructions above, but ensure you switch the branch you want to test before installing:
git clone https://github.com/wailsapp/wails
cd wails
git checkout -b branch-to-test --track origin/branch-to-test
cd v2/cmd/wails
go install
Make sure you update your project as described above.
Testing a PR
If you want to test a PR, follow the instructions above, but ensure you fetch the PR and switch the branch before installing. Please replace [IDofThePR]
with the ID of the PR shown on github.com:
git clone https://github.com/wailsapp/wails
cd wails
git fetch -u origin pull/[IDofThePR]/head:test/pr-[IDofThePR]
git checkout test/pr-[IDofThePR]
git reset --hard HEAD
cd v2/cmd/wails
go install
Make sure you update your project as described above.