CMake - 环境变量

一、控制构建的环境变量

环境变量	说明	可设置的值
CMAKE_APPLE_SILICON_PROCESSOR	在MacOS系统中，用于告诉CMake使用哪个架构进行编译	arm64 / x86_64
CMAKE_BUILD_PARALLEL_LEVEL	构建时要使用的最大并发进程数	数值
CMAKE_BUILD_TYPE	构建类型	Debug / Release / RelWithDebInfo / MinSizeRel
CMAKE_CONFIGURATION_TYPES	多配置生成器上的可用构建类型	Debug / Release / RelWithDebInfo / MinSizeRel
CMAKE_CONFIG_TYPE
CMAKE_EXPORT_COMPILE_COMMANDS	在生成期间启用/禁用编译命令的输出，如果开启则生成的文件compile_commands.json，包含所有编译单元所执行的指令	ON / OFF
CMAKE_GENERATOR	指定生成器，可以在cmake指令中使用-G	Unix Makefiles, Ninja, etc.
CMAKE_GENERATOR_INSTANCE	用户提供的特定生成器的特定生成器实例	例如：对于Visual Studio 15 2017 Generator（及更高版本），这将指定所选VS实例的VS安装目录的绝对路径。
CMAKE_GENERATOR_PLATFORM	用户提供的特定特定平台的特定生成器	例如：对于Visual Studio 15 2017 Generator（及更高版本），这将指定特定的平台架构。
CMAKE_GENERATOR_TOOLSET	用户提供的本地构建系统工具集
CMAKE_INSTALL_MODE
CMAKE_<LANG>_COMPILER_LAUNCHER	其中，<LANG>为 C, CXX, Fortran, HIP, ISPC, OBJC, OBJCXX, or CUDA
CMAKE_<LANG>_FLAGS	其中，<LANG>为 C, CXX, Fortran, HIP, ISPC, OBJC, OBJCXX, or CUDA
CMAKE_<LANG>_LINKER_LAUNCHER	其中，<LANG>为 C, CXX, Fortran, HIP, ISPC, OBJC, OBJCXX, or CUDA
CMAKE_MSVCIDE_RUN_PATH
CMAKE_NO_VERBOSE	实际发布时，使用它去掉一些冗余信息	ON / OFF
CMAKE_OSX_ARCHITECTURES	MacOS系统指定架构
CMAKE_TOOLCHAIN_FILE	工具链文件路径，交叉编译的工具链toolchain.cmake，该文件里面设置了一系列CMAKE变量和属性，比如C_COMPILER，CXX_COMPILER等
DESTDIR	重新指定所有安装文件的路径， make install DESTDIR= < $CUSTOM_PREFIX>在configure或cmake时，指定了要安装的路径后，以这种方式make install安装的文件会通通安装到以$CUSTOM_PREFIX为前缀的目录中，这样，开发者直接对这目录中的文件打包，即可发布使用
LDFLAGS	只有在第一个配置上使用cmake来确定默认链接器标志，之后LDFLAGS 的值存储在缓存中作为CMAKE_EXE_LINKER_FLAGS_INIT，CMAKE_SHARED_LINKER_FLAGS_INIT 和CMAKE_MODULE_LINKER_FLAGS_INIT。对于任何配置运行（包括第一个配置），如果定义了等效的CMAKE_<TYPE>_LINKER_FLAGS_INIT变量，则将忽略环境变量。
<PackageName>_ROOT	find_package(<PackageName>)将用到此变量设置的package路径，例如要find_package(Foo)，则需要设置 Foo_ROOT，否则会报CMP0074的警告	Package的路径
VERBOSE	实际发布时，使用它去掉一些冗余信息

二、改变行为的环境变量

环境变量	说明	可设置的值
CMAKE_PREFIX_PATH	设置库的搜索路径，可用于 find_package(), find_program(), find_library(), find_file(), find_path() 在改路径查找库	路径

三、其他

环境变量	说明	可设置的值
ROJECT_BINARY_DIR	工程的二进制文件路径
CMAKE_CURRENT_BINARY_DIR	外部编译时，指的是target目录，内部编译时，指的是顶级目录
ROJECT_SOURCE_DIR	工程源文件路径
CMAKE_SOURCE_DIR	工程根目录路径，如果有多层子目录，在子目录CMakeLists文件中获取到的也是根目录的路径
CMAKE_CURRENT_SOURCE_DIR	当前源文件路径，即CMakeList.txt所在的目录
CMAKE_CURRENT_LIST_DIR	当前CMakeList.txt所在的目录
CMAKE_CURRENT_LIST_FILE	当前CMakeList.txt文件完整路径
CMAKE_CURRENT_LIST_LINE	当前所在的行
CMAKE_MODULE_PATH	如果工程复杂，可能需要编写一些cmake模块，这里通过SET指定这个变量
EXECUTABLE_OUTPUT_PATH	当前工程生成可执行文件，生成的可执行文件存放的目录
LIBRARY_OUTPUT_DIR	当前工程生成库文件，生成的库文件存放的目录
BINARY_OUTPUT_DIR	生成的二进制文件存放的目录
BUILD_SHARED_LIBS	是否编译动态库，与add_library的第二个参数意思一样，设置ON则生成动态库，否则生成静态库	ON / OFF

sample_004