Add ccache installation instructions to readme

This commit is contained in:
Bart
2026-02-03 09:57:31 -05:00
parent 3a5a5c08ba
commit b8fef9e486

View File

@@ -368,6 +368,35 @@ The workaround for this error is to add two lines to your profile:
tools.build:cxxflags=['-DBOOST_ASIO_DISABLE_CONCEPTS']
```
### Set Up Ccache
To speed up repeated compilations, we recommend that you install
[ccache](https://ccache.dev), a tool that wraps your compiler so that it can
cache build objects locally.
#### Linux
You can install it using the package manager, e.g. `sudo apt install ccache`
(Ubuntu) or `sudo dnf install ccache` (RHEL).
#### macOS
You can install it using Homebrew, i.e. `brew install ccache`.
####
You can install it using Chocolatey, i.e. `choco install ccache`. However, if
you see an error such as:
```
terminate called after throwing an instance of 'std::bad_alloc'
what(): std::bad_alloc
C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(617,5): error MSB6006: "cl.exe" exited with code 3.
```
then the latest version of Ccache still has not been fixed. In that case please
install it via: `choco install ccache --version 4.11.3 --allow-downgrade`.
### Build and Test
1. Create a build directory and move into it.