1
0
mirror of synced 2024-12-23 05:00:01 +01:00
modern-cmake/chapters/intro/installing.md

189 lines
12 KiB
Markdown
Raw Normal View History

2017-10-18 10:20:39 -04:00
# Installing CMake
{% hint style='tip' %}
Your CMake version should be newer than your compiler. It should be newer than the libraries you are using (especially Boost). New versions work better for everyone.
{% endhint %}
2017-10-18 10:20:39 -04:00
If you have a built in copy of CMake, it isn't special or customized for your system. You can easily install a new one instead, either on the system level or the user level. Feel free to instruct your users here if they complain about a CMake requirement being set too high. Especially if they want 3.1+ support. Maybe even if they want 3.23+ support...
2017-10-18 10:20:39 -04:00
2019-09-23 15:38:22 -04:00
#### Quick list (more info on each method below)
Ordered by author preference:
* All
- [Pip(x)][PyPI] (official, often updates same-day)
2019-09-23 15:38:22 -04:00
- [Anaconda][] / [Conda-Forge][]
* Windows
2022-04-28 05:37:00 +00:00
- [Winget][]
2020-03-18 20:00:54 +00:00
- [Chocolatey][]
- [Scoop][]
- [MSYS2][]
2019-09-23 15:38:22 -04:00
- [Download binary][download] (official)
* MacOS
- [Homebrew][]
- [MacPorts][]
- [Download binary][download] (official)
* Linux
- [Snapcraft][snap] (official)
- [APT repository][apt] (Ubuntu/Debian only) (official)
- [Download binary][download] (official)
2017-10-18 10:20:39 -04:00
## Official package
2021-02-11 11:01:48 -05:00
You can [download CMake from KitWare][download]. This is how you will probably get CMake if you are on Windows. It's not a bad way to get it on macOS either (and a Universal2 version is supplied supporting both Intel and Apple Silicon), but using `brew install cmake` is much nicer if you use [Homebrew](https://brew.sh) (and you should; Apple even supports Homebrew such as during the Apple Silicon rollout). You can also get it on most other package managers, such as [Chocolatey](https://chocolatey.org) for Windows or [MacPorts](https://www.macports.org) for macOS.
2017-10-18 10:20:39 -04:00
2019-09-23 15:38:22 -04:00
On Linux, there are several options. Kitware provides a [Debian/Ubunutu apt repository][apt], as well as [snap packages][snap]. There are universal Linux binaries provided, but you'll need to pick an install location. If you already use `~/.local` for user-space packages, the following single line command[^1] will get CMake for you [^2]:
2017-10-18 10:20:39 -04:00
2018-03-28 20:50:38 +02:00
{% term %}
2022-04-12 23:07:30 -04:00
~ $ wget -qO- "https://cmake.org/files/v3.23/cmake-3.23.1-linux-x86_64.tar.gz" | tar --strip-components=1 -xz -C ~/.local
2018-03-28 20:50:38 +02:00
{% endterm %}
2017-10-18 10:20:39 -04:00
The names changed in 3.23; older releases had names like `cmake-3.19.7-Linux-x86_64.tar.gz`. If you just want a local folder with CMake only:
2017-10-18 10:20:39 -04:00
2018-03-28 20:50:38 +02:00
{% term %}
2022-04-12 23:07:30 -04:00
~ $ mkdir -p cmake-3.23 && wget -qO- "https://cmake.org/files/v3.23/cmake-3.23.1-linux-x86_64.tar.gz" | tar --strip-components=1 -xz -C cmake-3.23
~ $ export PATH=`pwd`/cmake-3.23/bin:$PATH
2018-03-28 20:50:38 +02:00
{% endterm %}
2017-10-18 10:20:39 -04:00
2020-08-03 10:51:03 -04:00
You'll obviously want to append to the PATH every time you start a new terminal, or add it to your `.bashrc` or to an [LMod][] system.
2017-10-18 10:20:39 -04:00
2018-04-19 12:49:00 +02:00
And, if you want a system install, install to `/usr/local`; this is an excellent choice in a Docker container, for example on GitLab CI. Do not try it on a non-containerized system.
{% term %}
2022-04-12 23:07:30 -04:00
docker $ wget -qO- "https://cmake.org/files/v3.23/cmake-3.23.1-linux-x86_64.tar.gz" | tar --strip-components=1 -xz -C /usr/local
2018-04-19 12:49:00 +02:00
{% endterm %}
2018-04-05 08:07:40 +02:00
If you are on a system without wget, replace `wget -qO-` with `curl -s`.
2017-10-18 10:20:39 -04:00
You can also build CMake on any system, it's pretty easy, but binaries are faster.
## CMake Default Versions
Here are some common build environments and the CMake version you'll find on them. Feel free to install CMake yourself, it's 1-2 lines and there's nothing "special" about the built in version. It's also very backward compatible.
2020-03-23 21:19:01 -04:00
### Windows
2022-04-28 05:37:00 +00:00
[![Winget package](https://repology.org/badge/version-for-repo/winget/cmake.svg)][Winget]
2020-03-23 21:19:01 -04:00
[![Chocolatey package](https://repology.org/badge/version-for-repo/chocolatey/cmake.svg)][chocolatey]
[![MSYS2 mingw package](https://repology.org/badge/version-for-repo/msys2_mingw/cmake.svg)][MSYS2]
[![MSYS2 msys2 package](https://repology.org/badge/version-for-repo/msys2_msys2/cmake.svg)][MSYS2]
Also [Scoop][scoop] is generally up to date. The normal installers from CMake.org are common on Windows, too.
### MacOS
[![Homebrew package](https://repology.org/badge/version-for-repo/homebrew/cmake.svg)][homebrew]
[![Homebrew Casks package](https://repology.org/badge/version-for-repo/homebrew_casks/cmake.svg)][homebrew-cask]
[![MacPorts package](https://repology.org/badge/version-for-repo/macports/cmake.svg)][macports]
Homebrew is quite a bit more popular nowadays on macOS, at least according to Google Trends.
### Linux
#### RHEL/CentOS
2020-08-03 11:50:29 -04:00
[![CentOS 7 package](https://repology.org/badge/version-for-repo/centos_7/cmake.svg?minversion=3.10.0)][centos]
[![CentOS 8 package](https://repology.org/badge/version-for-repo/centos_8/cmake.svg?minversion=3.10.0)][centos]
[![EPEL 7 package](https://repology.org/badge/version-for-repo/epel_7/cmake.svg?minversion=3.10.0)][centos]
2020-03-23 21:19:01 -04:00
The default on 8 is not too bad, but you should not use the default on 7. Use the EPEL package instead.
#### Ubuntu
2020-08-03 11:50:29 -04:00
[![Ubuntu 14.04 package](https://repology.org/badge/version-for-repo/ubuntu_14_04/cmake.svg?minversion=3.10.0)](https://launchpad.net/ubuntu/trusty/+source/cmake)
[![Ubuntu 16.04 package](https://repology.org/badge/version-for-repo/ubuntu_16_04/cmake.svg?minversion=3.10.0)](https://launchpad.net/ubuntu/xenial/+source/cmake)
[![Ubuntu 18.04 package](https://repology.org/badge/version-for-repo/ubuntu_18_04/cmake.svg?minversion=3.10.0)](https://launchpad.net/ubuntu/bionic/+source/cmake)
[![Ubuntu 20.04 package](https://repology.org/badge/version-for-repo/ubuntu_20_04/cmake.svg?minversion=3.10.0)](https://launchpad.net/ubuntu/focal/+source/cmake)
2022-04-22 04:23:43 +00:00
[![Ubuntu 22.04 package](https://repology.org/badge/version-for-repo/ubuntu_22_04/cmake.svg?minversion=3.10.0)](https://launchpad.net/ubuntu/jammy/+source/cmake)
2020-03-23 21:19:01 -04:00
You should only use the default CMake on 18.04+; it's an LTS release with a pretty decent minimum version!
#### Debian
[![Debian 10 package](https://repology.org/badge/version-for-repo/debian_10/cmake.svg)][repology]
[![Debian 10 backports package](https://repology.org/badge/version-for-repo/debian_10_backports/cmake.svg)][repology]
[![Debian 11 package](https://repology.org/badge/version-for-repo/debian_11/cmake.svg)][repology]
[![Debian 11 backports package](https://repology.org/badge/version-for-repo/debian_11_backports/cmake.svg)][repology]
[![Debian Unstable package](https://repology.org/badge/version-for-repo/debian_unstable/cmake.svg)][repology]
2020-03-23 21:19:01 -04:00
#### Other
2022-04-22 04:23:43 +00:00
[![Alpine Linux 3.15 package](https://repology.org/badge/version-for-repo/alpine_3_15/cmake.svg)](https://pkgs.alpinelinux.org/packages?name=cmake&branch=v3.15)
2020-03-23 21:19:01 -04:00
[![Arch package](https://repology.org/badge/version-for-repo/arch/cmake.svg)][repology]
2022-04-22 04:23:43 +00:00
[![Fedora 35 package](https://repology.org/badge/version-for-repo/fedora_35/cmake.svg)][repology]
2020-03-23 21:19:01 -04:00
[![FreeBSD port](https://repology.org/badge/version-for-repo/freebsd/cmake.svg)][repology]
[![OpenBSD port](https://repology.org/badge/version-for-repo/openbsd/cmake.svg)][repology]
[![Gentoo package](https://repology.org/badge/version-for-repo/gentoo/cmake.svg)][repology]
[![openSUSE Tumbleweed package](https://repology.org/badge/version-for-repo/opensuse_tumbleweed/cmake.svg)][repology]
[![Homebrew package](https://repology.org/badge/version-for-repo/homebrew/cmake.svg)][homebrew]
2020-03-23 21:19:01 -04:00
### General tools
[![ConanCenter package](https://repology.org/badge/version-for-repo/conancenter/cmake.svg)][repology]
[![PyPI](https://img.shields.io/pypi/v/cmake)][PyPI]
[![Conda-forge](https://img.shields.io/conda/vn/conda-forge/cmake.svg)][Conda-Forge]
[![Anaconda](https://anaconda.org/anaconda/cmake/badges/version.svg?style=flat)][Anaconda]
2021-02-11 11:01:48 -05:00
Just `pip install cmake` on many systems. Add `--user` if you have to (modern pip does this for you if needed). This does not supply Universal2 wheels yet.
2020-03-23 21:19:01 -04:00
2020-08-03 18:16:52 -04:00
### CI
2020-03-23 21:19:01 -04:00
| Distribution | CMake version | Notes |
|---------------|---------------|-------|
2020-01-26 12:16:28 -05:00
| [TravisCI Xenial](https://docs.travis-ci.com/user/reference/xenial/#compilers-and-build-toolchain) | 3.12.4 | Mid November 2018 this image became ready for widescale use. |
| [TravisCI Bionic](https://docs.travis-ci.com/user/reference/bionic/#compilers-and-build-toolchain) | 3.12.4 | Same as Xenial at the moment. |
| [Azure DevOps](https://docs.microsoft.com/en-us/azure/devops/pipelines/agents/hosted?view=azure-devops#use-a-microsoft-hosted-agent) | 3.23.3 | kept up to date |
| [GitHub Actions 20.04](https://github.com/actions/virtual-environments/blob/main/images/linux/Ubuntu2004-Readme.md) | 3.23.3 | Same runners as Azure DevOps |
2020-01-26 12:16:28 -05:00
2020-07-24 18:06:51 -04:00
If you are using GitHub Actions, also see the [jwlawson/actions-setup-cmake](https://github.com/marketplace/actions/actions-setup-cmake) action, which can install your selection of CMake, even in a docker action run.
2020-03-23 21:19:01 -04:00
### Full list
2020-08-03 10:51:03 -04:00
Versions less than 3.10 are marked by a deeper color of red.
[![Full listing](https://repology.org/badge/vertical-allrepos/cmake.svg?columns=3&minversion=3.10.0)][repology]
2020-03-23 21:19:01 -04:00
2019-08-07 05:06:55 +00:00
Also see [pkgs.org/download/cmake](https://pkgs.org/download/cmake).
2017-10-18 10:20:39 -04:00
## Pip
[This][PyPI] is also provided as an official package, maintained by the authors of CMake at KitWare and several PyPA members, including myself. It's now supported on special architectures, like PowerPC on Linux and Apple Silicon on macOS, and on MUSL systems like Alpine too. If you have pip (Python's package installer), you can do:
2017-10-18 10:20:39 -04:00
```term
gitbook $ pip install cmake
2017-10-18 10:20:39 -04:00
```
And as long as a binary exists for your system, you'll be up-and-running almost immediately. If a binary doesn't exist, it will try to use KitWare's `scikit-build` package to build, and will require an older copy of CMake to build. So only use this system if binaries exist, which is most of the time.
2017-10-18 10:20:39 -04:00
2020-07-20 16:39:04 -04:00
This has the benefit of respecting your current virtual environment, as well. It really shines when placed in a `pyproject.toml` file, however - it will only be installed to build your package, and will not remain afterwords! Fantastic.
2017-10-18 10:20:39 -04:00
This also, of course, works with pipx. So you can even use `pipx run cmake` to run CMake in a disposable virtual environment, without any setup - and this works out-of-the-box on GitHub Actions, since `pipx` is a supported package manager there!
2017-10-18 10:20:39 -04:00
{% hint style='info' %}
2020-08-03 10:51:03 -04:00
Personally, on Linux, I put versions of CMake in folders, like `/opt/cmake312` or `~/opt/cmake312`, and then add them to [LMod][]. See [`envmodule_setup`][envmodule_setup] for help setting up an LMod system on macOS or Linux. It takes a bit to learn, but is a great way to manage package and compiler versions.
2018-03-29 23:22:38 +02:00
[envmodule_setup]: https://github.com/CLIUtils/envmodule_setup
2017-10-18 10:20:39 -04:00
{% endhint %}
[^1]: I assume this is obvious, but you are downloading and running code, which exposes you to a man in the middle attack. If you are in a critical environment, you should download the file and check the checksum. (And, no, simply doing this in two steps does not make you any safer, only a checksum is safer).
2018-07-06 02:04:02 +00:00
[^2]: If you don't have a `.local` in your home directory, it's easy to start. Just make the folder, then add `export PATH="$HOME/.local/bin:$PATH"` to your `.bashrc` or `.bash_profile` or `.profile` file in your home directory. Now you can install any packages you build to `-DCMAKE_INSTALL_PREFIX=~/.local` instead of `/usr/local`!
2017-10-18 10:20:39 -04:00
2020-03-23 21:19:01 -04:00
[repology]: https://repology.org/project/cmake/versions
[LMod]: http://lmod.readthedocs.io/en/latest/
[apt]: https://apt.kitware.com/
[snap]: https://snapcraft.io/cmake
[PyPI]: https://pypi.org/project/cmake/
2022-04-28 05:37:00 +00:00
[winget]: https://github.com/microsoft/winget-pkgs/tree/master/manifests/k/Kitware/CMake
2020-03-23 21:19:01 -04:00
[chocolatey]: https://chocolatey.org/packages/cmake
[scoop]: https://github.com/ScoopInstaller/Main/blob/master/bucket/cmake.json
[MSYS2]: https://packages.msys2.org/base/mingw-w64-cmake
[anaconda]: https://anaconda.org/anaconda/cmake
[conda-forge]: https://github.com/conda-forge/cmake-feedstock
[download]: https://cmake.org/download/
[homebrew]: https://formulae.brew.sh/formula/cmake
[homebrew-cask]: https://formulae.brew.sh/cask/cmake
[macports]: https://ports.macports.org/port/cmake/summary
[centos]: https://rpms.remirepo.net/rpmphp/zoom.php?rpm=cmake