Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-15 20:46:37 +08:00
Code Issues Projects Releases Wiki Activity

FASTBuild: don't set default cache path

Browse Source 
Leave only 2 option to set cache path:
1. CMake variable
2. Environment variable
Update docs to reflect the changes.
This commit is contained in:
Eduard Voronkin
2025-09-07 21:20:31 -07:00
committed by Eduard Voronkin
parent 563e11b6fd
commit f77628e0af
3 changed files with 18 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
Help/generator/FASTBuild.rst
View File

@@ -27,6 +27,19 @@ This writes a FASTBuild configuration file named ``fbuild.bff`` into
These IDE files can be generated by building ``xcode`` or ``solution`` targets These IDE files can be generated by building ``xcode`` or ``solution`` targets
and will build using FASTBuild as the backend. and will build using FASTBuild as the backend.
Caching
-------
To enable FASTBuild caching, set the cache path using the
:variable:`CMAKE_FASTBUILD_CACHE_PATH` variable or the
``FASTBUILD_CACHE_PATH`` environment variable.
Then build with the ``-cache`` flag:
.. code-block:: console
cmake --build <path-to-build> -- -cache
Configuration Variables Configuration Variables
----------------------- -----------------------

7
Help/variable/CMAKE_FASTBUILD_CACHE_PATH.rst
View File

@@ -1,9 +1,10 @@
CMAKE_FASTBUILD_CACHE_PATH CMAKE_FASTBUILD_CACHE_PATH
--------------------------- --------------------------
Specifies the directory for the FASTBuild artifact cache. Specifies the directory for the FASTBuild artifact cache in the generated file.
Defaults to :variable:`CMAKE_BINARY_DIR` ``/fbuild.cache`` if not set. If not set, FASTBuild will use the ``FASTBUILD_CACHE_PATH`` environment
variable at build time.
See the `FASTBuild caching documentation <https://www.fastbuild.org/docs/features/caching.html>`_ See the `FASTBuild caching documentation <https://www.fastbuild.org/docs/features/caching.html>`_
for more information. for more information.

6
Source/cmGlobalFastbuildGenerator.cxx
View File

@@ -538,12 +538,8 @@ void cmGlobalFastbuildGenerator::WriteSettings()
auto val = this->GetSafeGlobalSetting(FASTBUILD_CACHE_PATH); auto val = this->GetSafeGlobalSetting(FASTBUILD_CACHE_PATH);
if (!val.empty()) { if (!val.empty()) {
cacheDir = std::move(val); cacheDir = std::move(val);
} else { cmSystemTools::ConvertToOutputSlashes(cacheDir);
// Default value.
cacheDir =
this->GetCMakeInstance()->GetHomeOutputDirectory() + "/fbuild.cache";
} }
cmSystemTools::ConvertToOutputSlashes(cacheDir);
WriteDivider(); WriteDivider();
*this->BuildFileStream << "// Settings\n\n"; *this->BuildFileStream << "// Settings\n\n";