build2 | Install from Source
The universal way to install or upgrade build2 is to build
it from source using the automated install scripts. Download a version for
your platform (see below), verify its checksum, run, and follow the onscreen
instructions. The script will prompt for your confirmation before building
or installing anything. See the Installation
FAQ for common installation questions. Alternatively, you can install
build2 from binary packages on many
mainstream operating systems.
While the below instructions download the install scripts from
download.build2.org, you can also get them from GitHub
Releases.
Install scripts for development snapshots are also available.
To build and install build2 all you will need is a
reasonably recent C++ compiler. See Which compilers are supported? for
details.
You will normally want to keep the build directory around for upgrades or to cleanly uninstall the toolchain. An automated upgrade can be performed from any previous patch release and from the most recent previous minor version.
| 1 | UNIX (Linux, Mac OS, FreeBSD) |
|---|---|
| 2 | Windows with MSVC |
| 3 | Windows with Clang |
| 4 | Windows with MinGW |
| 5 | Other Installation Methods |
1 UNIX (Linux, Mac OS, FreeBSD)
Create the build2 build directory, for example
~/build2-build in your home directory, then run:
$ cd ~/build2-build $ curl -sSfO https://download.build2.org/0.18.1/build2-install-0.18.1.sh $ shasum -a 256 -b build2-install-0.18.1.sh 22b5e8e51fba6461954d2363884969ad760ee031b5b1a024c7e0b4913a2125f1 $ sh build2-install-0.18.1.sh
Or, to upgrade from 0.17.0:
$ sh build2-install-0.18.1.sh --upgrade
To uninstall:
$ sh build2-install-0.18.1.sh --uninstall
See the Installation FAQ for common platform-specific issues and solutions.
2 Windows with MSVC
Create the build2 build directory, for example,
C:\build2-build, download build2-install-msvc-0.18.1.bat
into it, start the Visual Studio x64 Command Prompt,
then run:
> cd C:\build2-build > certutil -hashfile build2-install-msvc-0.18.1.bat SHA256 0f3d5afdfbcd8f400a75ff548c82eaac58644f7f2757fb9448daf2a97510a0fe > build2-install-msvc-0.18.1.bat
If your organization's network security breaks the installation process
(often the case on Windows when trying to use curl), then
consider installing offline.
Or, to upgrade from 0.17.0:
> build2-install-msvc-0.18.1.bat --upgrade
Note that currently the automated upgrade process does not upgrade the baseutils
package. Use the from-scratch installation if you would like to upgrade
this package.
To uninstall:
$ build2-install-msvc-0.18.1.bat --uninstall
See the Installation FAQ for common Windows-specific issues and solutions.
3 Windows with Clang
There are two common ways to obtain Clang targeting the MSVC runtime: bundled with the MSVC installation (by selecting the Clang tools component in the Visual Studio installer) or as a separate installation (by getting the installer from the LLVM Download page).
If you are using a separate installation, then the Clang compiler is most
likely already in your PATH environment variable and you don't
have to use the Visual Studio command prompt below.
Create the build2 build directory, for example,
C:\build2-build, download build2-install-clang-0.18.1.bat
into it, start the Visual Studio x64 Command Prompt,
then run:
> cd C:\build2-build > certutil -hashfile build2-install-clang-0.18.1.bat SHA256 5f05a19691eac317ffea46870f9191a5c948eb22774b5ed14c26c256178a0d0c > build2-install-clang-0.18.1.bat
If your organization's network security breaks the installation process
(often the case on Windows when trying to use curl), then
consider installing offline.
Or, to upgrade from 0.17.0:
> build2-install-clang-0.18.1.bat --upgrade
Note that currently the automated upgrade process does not upgrade the baseutils
package. Use the from-scratch installation if you would like to upgrade
this package.
To uninstall:
$ build2-install-clang-0.18.1.bat --uninstall
See the Installation FAQ for common Windows-specific issues and solutions.
4 Windows with MinGW
Create the build2 build directory, for example,
C:\build2-build, download build2-install-mingw-0.18.1.bat
into it, start the Command Prompt, then run:
> cd C:\build2-build > certutil -hashfile build2-install-mingw-0.18.1.bat SHA256 71ea9dc27b6ddfbbe12f5a8fb59bf46a21b75c53d0e7d85f6627dd391195a27c > build2-install-mingw-0.18.1.bat
If your organization's network security breaks the installation process
(often the case on Windows when trying to use curl), then
consider installing offline.
The build2-install-mingw script downloads and installs (into
the same directory as build2) a minimal MinGW GCC distribution
that is then used to compile build2. If you would prefer to use
your own MinGW GCC, see the alternative installation methods below.
Or, to upgrade from 0.17.0:
> build2-install-mingw-0.18.1.bat --upgrade
Note that currently the automated upgrade process does not upgrade the baseutils
and mingw packages. Use the from-scratch installation if
you would like to upgrade these packages.
To uninstall:
$ build2-install-mingw-0.18.1.bat --uninstall
See the Installation FAQ for common Windows-specific issues and solutions.
5 Other Installation Methods
The steps described above are the preferred way to build and install
build2 from source for most developers. For alternative
from-source installation methods that offer more control see the Installation and
Upgrade manual. To manually obtain various components of the
build2 toolchain refer to the Download page or GitHub
Releases.