A fun folly writing an ATC client.
To build vice from scratch, first make sure that you have a recent go compiler installed: (go compiler downloads).
Next, make sure that SDL is installed on your system. You may build it from source, though installing prebuilt binaries is easier:
- Windows: You can download prebuilt
binaries
from the libsdl releases
page. You
will then need to set the following environment variables, with INSTALL
in the following replaced with the directory where you installed
SDL2-devel:CGO_CFLAGS:'-I INSTALL/SDL2-2.24.0/x86_64-w64-mingw32/include'CGO_CPPFLAGS:'-I INSTALL/SDL2-2.24.0/x86_64-w64-mingw32/include'CGO_LDFLAGS:'-L INSTALL/SDL2-2.24.0/x86_64-w64-mingw32/lib'
- OSX: If you have homebrew installed, running
brew install sdl2will install SDL2. - Linux: On Ubuntu,
sudo apt install xorg-dev libsdl2-devwill install the necessary libraries.
On Windows, you must also have the mingw64 compiler installed. Make sure
that your PATH environment variable includes the mingw64 bin directory.
With all of that set up, run the following command in a shell:
go install github.com/mmp/vice@latest
When the build completes, a vice binary will be in your
${GOPATH}/bin/vice directory; if the GOPATH environment variable is
unset then vice will be in go/bin/vice, where the go/ directory is in
your home directory.
For vice releases, there are a few more steps in the build process so that the executable has an icon and that OSX builds are universal binaries that run on both Intel and Apple CPUs. See the scripts in the osx and windows directories for details. See also the github workflow for the Windows build for details about how the Windows vice installer is created.