FindOpenThreads¶
查找基于 C++ 的 OpenThreads 线程库。
OpenThreads 头文件的包含方式为:
example.cxx
¶#include <OpenThreads/Thread>
结果变量¶
此模块定义了以下变量
OpenThreads_FOUND
一个布尔值,指示是否找到 OpenThreads 库。为了向后兼容,
OPENTHREADS_FOUND
变量也设置为相同的值。OPENTHREADS_LIBRARY
使用 OpenThreads 所需链接的库。这提供了发布(优化)或调试库的变体,这些库根据项目的构建配置单独查找。
缓存变量¶
以下缓存变量也可以设置
OPENTHREADS_INCLUDE_DIR
包含使用 OpenThreads 所需头文件的目录。
提示¶
此模块接受以下变量
OPENTHREADS_DIR
一个环境变量或 CMake 变量,可以设置该变量以帮助查找安装在自定义位置的 OpenThreads 库。它应该指向在配置、构建和安装 OpenThreads 库时使用的安装目标:
./configure --prefix=$OPENTHREADS_DIR
。
此模块最初是为了支持 FindOpenSceneGraph
模块及其组件而引入的。为了简化 OpenSceneGraph 包在上游开发和分发时的一步自动化配置和构建,此模块支持额外的环境变量以在特定位置查找依赖项。上游包使用此方法而不是在命令行上指定 -DVAR=value
,因为它提供了更好的与模块内部更改的隔离,并且在独立于 CMAKE_*_PATH
变量指定各个 OSG 组件时提供了更大的灵活性。如果需要,显式的 -DVAR=value
参数仍然可以覆盖这些设置。由于 OpenThreads 是 OpenSceneGraph 的一个可选独立依赖项,因此此模块为了方便也支持以下变量:
OSG_DIR
可以设置为环境变量或 CMake 变量。其作用与
OPENTHREADS_DIR
相同。OSGDIR
作用与
OPENTHREADS_DIR
相同的环境变量。
示例¶
查找 OpenThreads 库并创建一个接口 导入目标,该目标封装了其链接到项目目标的用法要求。
find_package(OpenThreads)
if(OpenThreads_FOUND AND NOT TARGET OpenThreads::OpenThreads)
add_library(OpenThreads::OpenThreads INTERFACE IMPORTED)
set_target_properties(
OpenThreads::OpenThreads
PROPERTIES
INTERFACE_INCLUDE_DIRECTORIES "${OPENTHREADS_INCLUDE_DIR}"
INTERFACE_LINK_LIBRARIES "${OPENTHREADS_LIBRARY}"
)
endif()
target_link_libraries(example PRIVATE OpenThreads::OpenThreads)