Set up Clang
This GitHub action sets up Clang & LLVM in your workflow run.
- Installs either 32-bit or 64-bit Clang & LLVM on either Ubuntu, Windows or Cygwin.
- Specify a version to install using the
versionparameter.
Use it in your workflow like this:
- name: Set up Clang
uses: egor-tensin/setup-clang@v1
with:
version: latest
platform: x64
latestis the default value for theversionparameter and can be omitted.x64is the default value for theplatformparameter and can be omitted. Usex86if you want to build 32-bit binaries.- Set the
cygwinparameter to1to set up Clang inside an existing Cygwin installation (you can set up Cygwin itself using my action setup-cygwin). ccandc++executables are set up, pointing to theclangandclang++executables. Disable this by setting theccparameter to0.
API
| Input | Value | Default | Description |
|---|---|---|---|
| version | latest | ✓ | Install the latest version available in the repository. |
| any | Install a specific version if it's available (see below). | ||
| platform | x64 | ✓ | Install the x86_64 toolchain. |
| any | Install the i686 toolchain. | ||
| cygwin | any | ✓ | Install native binaries. |
| 1 | Install Cygwin packages. | ||
| cc | 1 | ✓ | Set up cc/clang/c++/clang++ executables. |
| any | Don't set up the executables. | ||
| hardlinks | any | ✓ | Cygwin: don't convert any symlinks. |
| 1 | Cygwin: convert symlinks in /usr/bin to hardlinks. |
| Output | Example | Description |
|---|---|---|
| clang | clang-4.0 | clang binary name |
| clangxx | clang++-7 | clang++ binary name |
Supported versions
Unless the version parameter value is "latest", the official LLVM repository
is used to make more versions available.
You can pass the version number as the version parameter value (5.0, 8,
9, etc.), and this action will install the corresponding packages.
The version parameter value is not checked for being an available version for
the current distribution.
The supported versions for a particular distribution are those found in that
distro's repositories & those in the LLVM repository.
For example, the supported versions for Bionic & Focal as of August 2021 are
listed below.
version |
Bionic | Focal |
|---|---|---|
| 3.9 | ✓ | |
| 4.0 | ✓ | |
| 5.0 | ✓ | |
| 6.0 | ✓ | ✓ |
| 7 | ✓ | ✓ |
| 8 | ✓ | ✓ |
| 9 | ✓ | ✓ |
| 10 | ✓ | ✓ |
| 11 | ✓ | ✓ |
| 12 | ✓ | ✓ |
| 13 | ✓ | ✓ |
This table is not definitive; I expect more future versions to be made available, especially for Focal.
On Windows and Cygwin, the version parameter is ignored.
License
Distributed under the MIT License. See LICENSE.txt for details.