如何限制find_package()的目标作用域至单个CMake函数？

问题背景 #

原有的CreatePlugin函数要求在外部提前调用find_package()获取依赖目标，导致这些目标的作用域覆盖整个项目。我们需要重构函数，让依赖目标仅存在于函数内部作用域中。

重构后的函数代码 #

function(CreatePlugin PluginName)
    # 使用CMake参数解析工具区分依赖查找命令和目标列表
    cmake_parse_arguments(PLUGIN "" "" "FIND_COMMANDS;TARGETS" ${ARGN})

    # 在函数局部作用域内执行传入的依赖查找命令
    foreach(cmd IN LISTS PLUGIN_FIND_COMMANDS)
        ${cmd}
    endforeach()

    # 验证所有依赖目标是否存在
    foreach(target IN LISTS PLUGIN_TARGETS)
        if(NOT TARGET ${target})
            message(STATUS "Skipped ${PluginName} plugin. Target ${target} not found.")
            return()
        endif()
    endforeach()

    # 构建插件库
    add_library(${PluginName}Plugin SHARED ${PluginName}Plugin.cpp)
    target_link_libraries(${PluginName}Plugin ${PLUGIN_TARGETS})
    target_include_directories(${PluginName}Plugin PUBLIC ${PROJECT_SOURCE_DIR}/plugins)
    install(TARGETS ${PluginName}Plugin DESTINATION plugins)
endfunction()

调用示例 #

# 直接在调用时传入需要执行的find_package命令和依赖目标
CreatePlugin(myPlugin 
    FIND_COMMANDS 
        "find_package(some-lib REQUIRED)"
        "find_package(another-lib REQUIRED)"
    TARGETS 
        someLib 
        anotherLib
)

关键说明 #

1. 参数解析：使用cmake_parse_arguments将传入的参数拆分为FIND_COMMANDS（需要执行的依赖查找命令）和TARGETS（插件依赖的目标名称），参数结构更清晰易维护。
2. 作用域隔离：在函数内部执行find_package()命令，CMake函数的局部作用域会限制这些命令创建的目标，不会扩散到项目全局作用域。
3. 兼容性：保留了原有的目标检查逻辑，确保依赖目标存在后才会继续构建插件，避免构建错误。

内容的提问来源于stack exchange，提问作者mython paster