72689ca25b
- add Ubuntu release 24.04 LTS (Noble Numbat). - remove Ubuntu release 18.04 LTS (Bionic Beaver) as Github runners no longer support it. - remove clang versions 3.9, 4.0, 5.0, 6.0 which are now obsolete due to removal of Bionic. - add clang versions 16, 17, 18.
99 lines
3.8 KiB
Markdown
99 lines
3.8 KiB
Markdown
Set up Clang
|
|
============
|
|
|
|
[](https://github.com/egor-tensin/setup-clang/actions/workflows/test.yml)
|
|
|
|
This GitHub action sets up Clang & LLVM in your workflow run.
|
|
|
|
1. Installs either 32-bit or 64-bit Clang & LLVM on either Ubuntu, Windows or
|
|
Cygwin.
|
|
2. Specify a version to install using the `version` parameter.
|
|
|
|
Use it in your workflow like this:
|
|
|
|
- name: Set up Clang
|
|
uses: egor-tensin/setup-clang@v1
|
|
with:
|
|
version: latest
|
|
platform: x64
|
|
|
|
* `latest` is the default value for the `version` parameter and can be omitted.
|
|
* `x64` is the default value for the `platform` parameter and can be omitted.
|
|
Use `x86` if you want to build 32-bit binaries.
|
|
* Set the `cygwin` parameter to `1` to set up Clang inside an existing Cygwin
|
|
installation (you can set up Cygwin itself using my action [setup-cygwin]).
|
|
* `cc` and `c++` executables are set up, pointing to the `clang` and `clang++`
|
|
executables.
|
|
Disable this by setting the `cc` parameter to `0`.
|
|
|
|
[setup-cygwin]: https://github.com/egor-tensin/setup-cygwin
|
|
|
|
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, you can find the list of available versions as of July 2024
|
|
below.
|
|
|
|
| `version` | Focal | Jammy | Noble
|
|
| --------- | ----- | ----- | -----
|
|
| 6.0 | ✓ | |
|
|
| 7 | ✓ | |
|
|
| 8 | ✓ | |
|
|
| 9 | ✓ | |
|
|
| 10 | ✓ | |
|
|
| 11 | ✓ | ✓ |
|
|
| 12 | ✓ | ✓ |
|
|
| 13 | ✓ | ✓ |
|
|
| 14 | ✓ | ✓ | ✓
|
|
| 15 | ✓ | ✓ | ✓
|
|
| 16 | ✓ | ✓ | ✓
|
|
| 17 | ✓ | ✓ | ✓
|
|
| 18 | ✓ | ✓ | ✓
|
|
|
|
This table should be updated periodically; it's a work-in-progress.
|
|
|
|
On Windows and Cygwin, the `version` parameter is ignored.
|
|
|
|
:warning: The 32-bit build on Noble Numbat (Ubuntu 24.04 LTS) is temporarily not supported
|
|
due to a bug in the linux-azure kernel used by Github runner images. See this
|
|
[bug report](https://bugs.launchpad.net/ubuntu/+source/linux-signed-azure/+bug/2071445)
|
|
for more information. Related [issue](https://bugs.launchpad.net/ubuntu/+source/linux-signed-azure/+bug/2071445)
|
|
on actions/runner-images.
|
|
|
|
License
|
|
-------
|
|
|
|
Distributed under the MIT License.
|
|
See [LICENSE.txt] for details.
|
|
|
|
[LICENSE.txt]: LICENSE.txt
|