问题[cmake](coding)

我有一个小的 cmake 项目。我将 cpplint 添加到编译中，它运行良好。我正在向 cpplint 调用添加一个命令行参数。

find_program(CPPLINT_EXECUTABLE cpplint)

if(CPPLINT_EXECUTABLE)
    set(CMAKE_CXX_CPPLINT "${CPPLINT_EXECUTABLE} --quiet")
    set(CMAKE_CXX_CPPLINT_EXTENSIONS "*.cc; *.h")
 else()
    message(WARNING "cpplint not found.")
endif()

但失败了。我运行的是 3.30.2 版的 cmake

Error running '/usr/local/bin/cpplint --quiet': no such file or directory
make[2]: *** [src/CMakeFiles/libxdemo.dir/xdemo.cc.o] Error 1
make[1]: *** [src/CMakeFiles/libxdemo.dir/all] Error 2

我有一个包含 2 个子目录的顶级 CMakeLists.txt 文件。只要 cmake 命令行上没有 -j 或 --parallel，它就可以正确构建。CMakeLists.txt 文件记录了这个问题。除了记录问题之外，还有其他方法可以防止 CMakeLists.txt 文件中的并行构建吗？

cmake_minimum_required(VERSION 3.25)

# Do not attempt to build in parallel using either --parallel or -j
# There can be a race codition between generating the performance test
# header file and building the tests.

project(TestDictionary LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_subdirectory(src/PerformanceTestGenerator)
add_subdirectory(src/tests)

cmake_minimum_required(VERSION 3.25)

project(createPerformanceTest LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(createPerformanceTest main.cpp PerformanceTestGenerator.cpp TestParameters.cpp)

target_compile_features(createPerformanceTest PUBLIC cxx_std_23)

if (CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
    # warning level 4 and all warnings as errors
    target_compile_options(createPerformanceTest PRIVATE /W3 /WX -D_CRT_SECURE_NO_WARNINGS)
elseif (CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    if("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU")
        # require at least gcc 12 to get full C++20 support
        if (CMAKE_CXX_COMPILER_VERSION VERSION_LESS 12)
            message(FATAL_ERROR "GCC version must be at least 12!")
        endif()
    endif()
    # lots of warnings and all warnings as errors
    target_compile_options(createPerformanceTest PRIVATE -Wall -Wextra -pedantic -Werror)
endif()

add_custom_command(
  OUTPUT ${CMAKE_CURRENT_SOURCE_DIR}/performanceTest.h
  COMMAND createPerformanceTest --output-file ${CMAKE_CURRENT_SOURCE_DIR}/performanceTest.h --test-count 3 --radix-16 --test-size 10 --test-size 20 --test-size ff --both-tests
  COMMENT "Generating performanceTest.h header file"
  VERBATIM
)

add_custom_target(
  GeneratedHeader ALL
  DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/performanceTest.h
)

cmake_minimum_required(VERSION 3.25)

project(testTest LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(testTest testtest.cpp FunctionalityTests.cpp TestGenericDictionary.cpp)

target_include_directories(testTest
    PUBLIC ../..
    PRIVATE ./ ../PerformanceTestGenerator 
)

target_compile_features(testTest PUBLIC cxx_std_23)

if (CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
    # warning level 4 and all warnings as errors
    target_compile_options(testTest PRIVATE /W4 /WX -D_CRT_SECURE_NO_WARNINGS)
elseif (CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    if("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU")
        # require at least gcc 12 to get full C++20 support
        if (CMAKE_CXX_COMPILER_VERSION VERSION_LESS 12)
            message(FATAL_ERROR "GCC version must be at least 12!")
        endif()
    endif()
    # lots of warnings and all warnings as errors
    target_compile_options(testTest PRIVATE -Wall -Wextra -pedantic -Werror)
endif()

FetchContent 的官方文档看起来更像是一个概述。但我正在寻找完整的参考。cmake --help-module FetchContent产生与上述链接相同的文本。

在某些项目中我看到了这种情况，例如：GIT_SHALLOW TRUE。在这种情况下：

FetchContent_Declare(
    box2d
    GIT_REPOSITORY https://github.com/erincatto/box2d.git
    GIT_TAG 7b273b12409252d247b89940d29a8aab0386f570
    GIT_SHALLOW TRUE
    GIT_PROGRESS TRUE
)

我想查看它的文档。其他的想法我也没找到文档。

CMake 现在已经有一种称为“CMake 文件 API”的东西：

CMake 提供了一个基于文件的 API，客户端可以使用该 API 获取有关 CMake 生成的构建系统的语义信息。客户端可以通过将查询文件写入构建树中的特定位置来使用该 API，以请求零个或多个对象类型。当 CMake 在该构建树中生成构建系统时，它将读取查询文件并编写回复文件供客户端读取。

我不明白这个 API 应该何时使用，由谁使用。因此，我不明白，作为使用 CMake 的项目维护者，我是否需要担心这个 API 并“迎合”使用它来满足请求。我需要吗？

注意：如果答案取决于我维护哪种 CMake 项目 - 请选择几个示例（因为我在多种项目中使用 CMake）。

我正在尝试在我的游戏中开始使用 GUI 库 Noesis，目前正在将其集成到我的项目中。不幸的是，在链接过程中，到目前为止我使用的所有 Noesis 函数都显示“未定义引用”例如：

[0/1] Re-running CMake...
-- 
-- Configuring done (0.3s)
-- Generating done (0.1s)
-- Build files have been written to: C:/projects/Curse of Elliah/cmake-build-debug
[1/2] Linking CXX executable Curse_of_Elliah.exe
FAILED: Curse_of_Elliah.exe 
C:\WINDOWS\system32\cmd.exe /C "cd . && C:\Users\wilto\AppData\Local\Programs\CLion\bin\mingw\bin\g++.exe -g  @CMakeFiles\Curse_of_Elliah.rsp -o Curse_of_Elliah.exe -Wl,--out-implib,libCurse_of_Elliah.dll.a -Wl,--major-image-version,0,--minor-image-version,0 && cd ."
C:\Users\wilto\AppData\Local\Programs\CLion\bin\mingw\bin/ld.exe: CMakeFiles/Curse_of_Elliah.dir/libs/Noesis/NoesisGL/GLRenderDevice.cpp.obj: in function `NoesisApp::GLRenderDevice::GLRenderDevice(bool)':
C:/projects/Curse of Elliah/libs/Noesis/NoesisGL/GLRenderDevice.cpp:154: undefined reference to `Noesis::RenderDevice::RenderDevice()'

Noesis 是一个预构建的静态库，其中包括头文件 (.h)，以及 .lib 文件和 .dll 文件。不知何故，无法访问 .dll 文件中的定义，我搜索了互联网以寻找解决方案，并尝试了许多不同的方法，但似乎没有任何改变。

在 Noesis 集成教程中，它是这样说的：

/Bin: this is the directory where dynamic libraries, one folder per architecture, can be found. Your executable must be able to reach this path. The easiest way is by copying it here in a post-build step.
/Include: directory for public headers. You must add this path to the Additional Include Directories of your project
/Lib: object libraries to link against with are stored in this directory, one folder per architecture. You must add this path to you Additional Libraries Directory and also link with the corresponding library.

因此，我将标头放入项目的 lib 文件夹中，使用它们没有问题，因为我刚刚将其包含在 CMake 中。然后，我将 .lib 文件放入我的 libs 文件夹中的另一个子文件夹中：libs/Noesis/Lib/windows_x86_64/Noesis.lib，我已将此路径与 target_link_libraries 一起以多种不同方式使用，并已验证 CMake 能够通过消息 (STATUS) 访问该文件。然后是 .dll 文件。我已将 dll 文件放入 lib 的另一个子文件夹中，并将其所在的子文件夹添加到 Windows 中的环境变量中。这似乎没有任何作用。我还将 .dll 文件放在构建文件夹 cmake-build-debug 中。我试图将它放在该位置内的多个不同子文件夹中，但即使它位于 .exe 文件旁边，也没有任何变化。

我尝试将其像包含普通库一样包含，使用 include_directories 和 target_link_libraries 尽可能简单。我尝试使用 add_library：

add_library(noesis SHARED IMPORTED)
set_target_properties(noesis PROPERTIES
        INTERFACE_INCLUDE_DIRECTORIES "${PROJECT_SOURCE_DIR}/libs/Noesis"
        IMPORTED_LOCATION "${PROJECT_SOURCE_DIR}/libs/Noesis/Bin/windows_x86_64/Noesis.dll"
        IMPORTED_IMPLIB "${PROJECT_SOURCE_DIR}/libs/Noesis/Lib/windows_x86_64/Noesis.lib"
        #INTERFACE_LINK_LIBRARIES "\$<LINK_ONLY:gdi32>"
)

以这两种方式并将 IMPORTED_LOCATION 更改为 .lib 文件并省略 IMPORTED_IMPLIB。这也不起作用。我想知道我是否做错了什么，以及导入静态预构建库的实际正确方法是什么？我也没有真正得到 Noesis 方面的任何官方支持，因为他们不支持 CMake。我花了一整天时间来解决这个简单的问题，我觉得我已经没有选择了。

编辑：我使用 MSVC 和 Visual Studio 2022 生成器仅使用 Noesis 创建了一个最小项目。这是我的 cmake 代码：

cmake_minimum_required(VERSION 3.29)
project(untitled)

set(CMAKE_CXX_STANDARD 23)

include_directories("${CMAKE_CURRENT_SOURCE_DIR}/libs/Noesis")
link_directories("${CMAKE_CURRENT_SOURCE_DIR}/libs/Noesis/Bin/windows_x86_64")

add_library(noesis SHARED IMPORTED)
set_target_properties(noesis PROPERTIES
        INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_CURRENT_SOURCE_DIR}/libs/Noesis"
        IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/libs/Noesis/Bin/windows_x86_64/Noesis.dll"
        IMPORTED_IMPLIB "${CMAKE_CURRENT_SOURCE_DIR}/libs/Noesis/Lib/windows_x86_64/Noesis.lib"
        #INTERFACE_LINK_LIBRARIES "\$<LINK_ONLY:gdi32>"
)

add_executable(untitled main.cpp)
target_link_libraries (untitled ${noesis})

这是我的结构：

无标题

• cmake-build-调试
• 库
• 诺西斯
• 箱体-windows_x86_64
  • 诺西斯
• 库——windows_x86_64
  • Noesis 库
• Noesis 头文件
• CMake列表.txt
• 主程序

不幸的是，我仍然遇到同样的问题，其中显示：

main.obj : error LNK2019: unresolved external symbol "__declspec(dllimport) void __cdecl Noesis::Init(void)" (__imp_?Init@Noesis@@YAXXZ) referenced in function main [C:\projects\untitled\cmake-build-debug\untitled.vcxproj]
C:\projects\untitled\cmake-build-debug\Debug\untitled.exe : fatal error LNK1120: 1 unresolved externals [C:\projects\untitled\cmake-build-debug\untitled.vcxproj]

编辑2：

实际上，我很笨。我在 target_link_libraries 中将 ${noesis} 更改为 noesis，现在它显示进程已完成，退出代码为 -1073741515 (0xC0000135)。这似乎是因为 .exe 找不到 .dll。我想我已经将 Noesis.dll 放在 .exe 旁边，但我可能需要做一些测试

编辑 3：实际上，我设法让它工作了！MSVC 只是将 .exe 放在子文件夹中！

使用以下 CMakeLists.txt

cmake_minimum_required(VERSION 3.30)

project(usage_example)

add_executable(usage main.cpp)

以及以下命令：

cmake -S . -B build -G Ninja -DCMAKE_C_COMPILER:PATH="%ProgramFiles(x86)%\LLVM\bin\clang.exe" -DCMAKE_CXX_COMPILER:PATH="%ProgramFiles(x86)%\LLVM\bin\clang.exe" -DCMAKE_C_COMPILER_ID="Clang" -DCMAKE_CXX_COMPILER_ID="Clang" -DCMAKE_SYSTEM_NAME="Generic"
cmake --build build

它构建没有问题，但生成的二进制文件不包含exe文件类型，它只生成build\usage

如果我重命名usage，usage.exe它可以正常工作，但为什么需要这个额外的步骤？

是否有一个好的、简单的方法来使用和合并（链接、包含等）它们来构建CMake项目？Premake

我有这个CMakePresets.json：

{
    "version": 5,
    "configurePresets": [
        {
            "name": "MSVC-VS-2022-x64",
            "displayName": "MSVC-VS-2022-x64",
            "description": "Ninja Multi-Config Build",
            "generator": "Ninja Multi-Config",
            "binaryDir": "${sourceParentDir}/${sourceDirName}Build",
            "cacheVariables": {
                "CMAKE_VS_VERSION_RANGE": "[17.0,18.0)",
                "CMAKE_CONFIGURATION_TYPES": "Debug;Release"
            }
        }
    ],
    "buildPresets": [
        {
            "name": "Debug",
            "displayName": "Debug",
            "configurePreset": "MSVC-VS-2022-x64",
            "configuration": "Debug"
        },
        {
            "name": "Release",
            "displayName": "Release",
            "configurePreset": "MSVC-VS-2022-x64",
            "configuration": "Release"
        }
    ]
}

我想让我们的开发人员能够将ACTIVE_SUBSETS具有用户特定值的缓存变量添加A;B;C到配置预设中MSVC-VS-2022-x64。

我尝试使用这个CMakeUserPresets.json：

{
    "version": 5,
    "configurePresets": [
        {
            "name": "MSVC-VS-2022-x64",
            "cacheVariables": {
                "ACTIVE_SUBSETS": "A;B;C"
            }
        }
    ]
}

但这显然会创建一个新的配置预设，而不是修改现有的预设。

CMake 错误：无法从 C:/tt/SourceRoot 读取预设：

重复预设：“MSVC-VS-2022-x64”

我CMakeUserPresets.json需要在配置预设中覆盖或添加什么值？

CMakePresets.json复制并重命名，然后修改它也是可以的CMakeUserPresets.json。不幸的是，这两个文件似乎总是被加载。

类似于缓存变量，环境变量和二进制目录也应该能够被覆盖。

我想要在每个配置构建目录中生成文件：

add_executable(test_generator_gen test_generator.cpp)
target_compile_definitions(test_generator_gen PRIVATE GENERATE)
target_link_libraries(test_generator_gen YOMM2::yomm2)

add_custom_command(
    OUTPUT ${GENERATED_FILES}
    DEPENDS test_generator_gen
    COMMAND test_generator_gen
    WORKING_DIRECTORY $<TARGET_FILE_DIR:test_generator_gen>
)

文件生成在我想要的位置（例如./builds/headers-only/tests/Debug/test_generator_slots.hpp和另一个文件）。我的问题是，我应该输入什么${GENERATED_FILES}？如果我输入"${CMAKE_CURRENT_BINARY_DIR}/test_generator_slots.hpp"，我就是在欺骗cmake，文件会一次又一次地生成。我尝试了对我来说似乎很自然的方法：

add_custom_command(
    OUTPUT $<TARGET_FILE_DIR:test_generator_gen>/test_generator_slots.hpp
    DEPENDS test_generator_gen
    COMMAND test_generator_gen
    WORKING_DIRECTORY $<TARGET_FILE_DIR:test_generator_gen>
)
# ...

...但我收到一个错误：

CMake Error at tests/CMakeLists.txt:95 (add_custom_command):
[cmake]   Error evaluating generator expression:
[cmake] 
[cmake]     $<TARGET_FILE_DIR:test_generator_gen>
[cmake] 
[cmake]   No target "test_generator_gen"

我很困惑。为什么同一命令中的同一生成器表达式对于某些参数可接受，而对于其他参数则不可接受？我该如何正确指定 OUTPUT？

cmake 3.22.1

我想设置一个变量，该变量可在我作为子目录 ( ) 包含的第三方库中修改add_subdirectory(.../third_party/libA)。该库允许我启用/禁用构建过程的某些部分，例如包括测试目标，例如：set(BUILD_TESTS OFF)。

但是，如果多个库包含相同的选项，并且名称相同，我该怎么办？我知道存在我想要实现的“相反方向”PARENT_SCOPE的选项set()，但是有没有办法以某种方式限制范围，以便我可以执行以下操作（下面的模拟行为）：

project(my_project)

set(libA_BUILD_TESTS OFF) # I DO NOT want to build tests for libA
add_subdirectory("${my_project_SOURCE_DIR}/third_party/libA")

set(libB_BUILD_TESTS ON) # I DO want to build tests for libB
add_subdirectory("${my_project_SOURCE_DIR}/third_party/libB")

由于我无法控制第三方库的变量名，因此变量libA_BUILD_TESTS和libB_BUILD_TESTS实际上并不存在。它们都只是有BUILD_TESTS。

1. 是否可以这样做并期望每个都应该正确设置？我不熟悉 CMake 如何处理变量解析的时间...

   set(BUILD_TESTS OFF)
   add_subdirectory(.../third_party/libA)
   
   set(BUILD_TESTS ON)
   add_subdirectory(.../third_party/libB)
   

2. 除了共享相同的变量名之外，有没有更明确/更安全的方式来声明我希望这两个变量不同？对我来说，重复使用相同的变量名似乎从根本上容易出错，而且特别“糟糕”。我不喜欢这样，因为它使变量“有状态”，这使得在构建过程中更难跟踪。

3. 我是否正确地思考了这个基本的变量设置过程？也许我对 #2 的感受根本不是“做事的方式”。

我尝试过的一些随机的事情（没有成功）：

特定于子目录的设置属性：

set(libA_dir "${my_project_SOURCE_DIR}/third_party/libA")
set(libB_dir "${my_project_SOURCE_DIR}/third_party/libB")

set_property(DIRECTORY ${libA_dir} PROPERTY BUILD_TESTS OFF)
set_property(DIRECTORY ${libB_dir} PROPERTY BUILD_TESTS ON)

设置目标属性（由于目标尚不存在，因此不起作用）：

# does not work because the libA target does not yet exist
set_target_properties(libA PROPERTIES BUILD_TESTS OFF) 

add_subdirectory("${my_project_SOURCE_DIR}/third_party/libA")

# this does work based on how the third party CMake was written...
find_package(libA REQUIRED) 

在定义目标之后设置目​​标属性（不起作用，因为在看到我的 set_target_properties 之前逻辑已经被处理了）：

add_subdirectory("${my_project_SOURCE_DIR}/third_party/libA")

# does not work because the subdir was already included and seems to have not respected
# the options here due to timing/ordering.
set_target_properties(libA PROPERTIES BUILD_TESTS OFF)

# this does work based on how the third party CMake was written...
find_package(libA REQUIRED) 

最后：我希望了解确保这两个库之间变量分配“隔离”的方法，尤其是当同一个变量有两个不同的值时（即“我想为 libA 构建测试，但不想为 libB 构建测试”）。谢谢。