我正在尝试使 CMake 构建到一个名为 "build" 的目录中，例如 project/build，其中 CMakeLists.txt 位于 project/ 中。
我知道我可以这样做：
mkdir build
cd build
cmake ../
但是那太麻烦了。我可以把它放在脚本中并调用它，但是这样就很难为CMake提供不同的参数（比如-G“MSYS Makefiles”），或者我需要在每个平台上编辑此文件。
最好的情况下，我想在主要的CMakeLists.txt中做一些像SET(CMAKE_OUTPUT_DIR build)的事情。请告诉我是否可能，如果可能，请说明如何操作？或者有其他的基于外部构建的方法可以轻松指定不同的参数吗？
-S和-B，分别用于指定源目录和二进制目录。cmake -S . -B build -G "MSYS Makefiles"
CMakeLists.txt并创建一个build文件夹（如果它还不存在）。-H和-B来指定调用cmake时的源和二进制目录：cmake -H. -Bbuild -G "MSYS Makefiles"
我最近找到的一个解决方案是将“外部构建”概念与Makefile包装器结合起来。
在我的顶层CMakeLists.txt文件中，我包含以下内容以防止内部构建:
if ( ${CMAKE_SOURCE_DIR} STREQUAL ${CMAKE_BINARY_DIR} )
message( FATAL_ERROR "In-source builds not allowed. Please make a new directory (called a build directory) and run CMake from there. You may need to remove CMakeCache.txt." )
endif()
然后，我创建一个顶层的Makefile，并包含以下内容：
# -----------------------------------------------------------------------------
# CMake project wrapper Makefile ----------------------------------------------
# -----------------------------------------------------------------------------
SHELL := /bin/bash
RM := rm -rf
MKDIR := mkdir -p
all: ./build/Makefile
@ $(MAKE) -C build
./build/Makefile:
@ ($(MKDIR) build > /dev/null)
@ (cd build > /dev/null 2>&1 && cmake ..)
distclean:
@ ($(MKDIR) build > /dev/null)
@ (cd build > /dev/null 2>&1 && cmake .. > /dev/null 2>&1)
@- $(MAKE) --silent -C build clean || true
@- $(RM) ./build/Makefile
@- $(RM) ./build/src
@- $(RM) ./build/test
@- $(RM) ./build/CMake*
@- $(RM) ./build/cmake.*
@- $(RM) ./build/*.cmake
@- $(RM) ./build/*.txt
ifeq ($(findstring distclean,$(MAKECMDGOALS)),)
$(MAKECMDGOALS): ./build/Makefile
@ $(MAKE) -C build $(MAKECMDGOALS)
endif
all可通过键入make来调用，并调用目标./build/Makefile。./build/Makefile的第一件事是使用$(MKDIR)创建build目录，其中$(MKDIR)是mkdir -p的变量。目录build是我们将执行外部源生成构建的地方。我们提供参数-p以确保mkdir不会因为尝试创建可能已经存在的目录而报错。./build/Makefile的第二件事是更改目录到build目录并调用cmake。all目标，我们调用$(MAKE) -C build，其中$(MAKE)是自动生成的make Makefile变量。 make -C在做任何事情之前都会更改目录。因此，使用$(MAKE) -C build等同于执行cd build; make。make all或make调用此Makefile包装器相当于执行：mkdir build
cd build
cmake ..
make
distclean会调用cmake ..，然后是make -C build clean，最后会从build目录中删除所有内容。我相信这正是您在问题中要求的。distclean。如果不是，则在调用之前将更改目录到build。这非常强大，因为用户可以键入例如make clean，而Makefile将将其转换为等效的cd build; make clean。cmake交互。此解决方案还提供了一种优雅的方法来从build目录中删除所有CMake输出文件。@来抑制来自shell命令的输出，并使用前缀@-来忽略shell命令的错误。当使用rm作为distclean目标的一部分时，如果文件不存在（可能已经使用rm -rf build命令行删除或根本没有生成），则该命令将返回错误。此返回错误将强制我们的Makefile退出。我们使用前缀@-来防止这种情况发生。如果文件已被删除，则是可以接受的；我们希望我们的Makefile继续并删除其余文件。cmake .. -DSOMEBUILDSUSETHIS:STRING="foo" -DSOMEOTHERBUILDSUSETHISTOO:STRING="bar"，则此Makefile可能无法正常工作。此Makefile假定您以一致的方式调用CMake，即通过键入cmake ..或提供cmake一致数量的参数（您可以将其包含在Makefile中）。根据之前的回答，我编写了以下模块，您可以包含它以强制执行外部构建。
set(DEFAULT_OUT_OF_SOURCE_FOLDER "cmake_output")
if (${CMAKE_SOURCE_DIR} STREQUAL ${CMAKE_BINARY_DIR})
message(WARNING "In-source builds not allowed. CMake will now be run with arguments:
cmake -H. -B${DEFAULT_OUT_OF_SOURCE_FOLDER}
")
# Run CMake with out of source flag
execute_process(
COMMAND ${CMAKE_COMMAND} -H. -B${DEFAULT_OUT_OF_SOURCE_FOLDER}
WORKING_DIRECTORY ${CMAKE_SOURCE_DIR})
# Cause fatal error to stop the script from further execution
message(FATAL_ERROR "CMake has been ran to create an out of source build.
This error prevents CMake from running an in-source build.")
endif ()
这个方法是可行的，不过我已经注意到两个缺点：
cmake .，他们将始终看到一个FATAL_ERROR。我找不到其他阻止CMake执行任何其他操作并提前退出的方法。cmake的任何命令行参数都不会传递给"源代码外构建调用"。欢迎提出改进此模块的建议。
-P选项，它将：
将给定的CMake文件处理为以CMake语言编写的脚本。不执行配置或生成步骤，也不修改缓存。在脚本内部，我们将使用
file()命令创建构建目录，然后使用execute_process()运行CMake，这次使用生成构建系统所需的选项。由于选项在脚本中指定，这样可以节省每次在命令行上手动输入它们的时间。
build.cmake的新文本文件，并粘贴以下代码：#!/usr/bin/env -S cmake -P
# Set default values for project variables
set(SOURCE_PATH "${CMAKE_CURRENT_LIST_DIR}") # directory of this script
set(BUILD_PATH "${SOURCE_PATH}/build")
set(CPUS 16) # number of logical processor cores (for parallel builds)
# Set generator for each platform
if(WIN32)
set(GENERATOR "MSYS Makefiles")
elseif(APPLE)
set(GENERATOR "Xcode")
else()
set(GENERATOR "Ninja")
endif()
# Allow developers to override the above variables if they want
if(EXISTS "${SOURCE_PATH}/overrides.cmake")
include("${SOURCE_PATH}/overrides.cmake")
endif()
# Configure
if(NOT EXISTS "${BUILD_PATH}/CMakeCache.txt")
file(MAKE_DIRECTORY "${BUILD_PATH}")
execute_process(
# CMAKE_ARGS on next line must not be quoted
COMMAND "${CMAKE_COMMAND}" -S "${SOURCE_PATH}" -B . -G "${GENERATOR}" ${CMAKE_ARGS}
WORKING_DIRECTORY "${BUILD_PATH}"
RESULT_VARIABLE EXIT_STATUS
)
if(NOT "${EXIT_STATUS}" EQUAL "0")
file(REMOVE "${BUILD_PATH}/CMakeCache.txt") # force CMake to run again next time
message(FATAL_ERROR "CMake failed with status ${EXIT_STATUS}.")
endif()
endif()
# Build
execute_process(
COMMAND "${CMAKE_COMMAND}" --build . --parallel "${CPUS}"
WORKING_DIRECTORY "${BUILD_PATH}"
RESULT_VARIABLE EXIT_STATUS
)
if(NOT "${EXIT_STATUS}" EQUAL "0")
message(FATAL_ERROR "${GENERATOR} failed with status ${EXIT_STATUS}.")
endif()
# From any Unix shell (Linux, macOS, WSL, Git Bash)
./build.cmake
# CMD or PowerShell
cmake -P build.cmake
set(CPUS 32) # override default CPUS set in build.cmake
set(GENERATOR "Visual Studio 17 2022") # use different generator
# Pass some options to CMake
set(CMAKE_ARGS
"-DFIRST_OPTION=Value 1"
"-DSECOND_OPTION=Value 2"
)
set(ENV{PATH} "C:/Tools;$ENV{PATH}") # add a directory to PATH
build.cmake和开发者文档，获取更多想法，比如如何读取和处理通过命令行传递给脚本的参数，以及如何使用MSVC作为编译器。