CMake基本用法

Question

我正在尝试使用 CMake 构建我的库。我正在处理 CMakeLists.txt 。

我希望能够执行以下操作：

我有一个名为“然后”的目录

include
src

，其中有 阿吉文件夹。 该文件夹中是库的子文件夹。

到目前为止，我收集到的信息是：

我需要做：

set(AGUI_SOURCES
src/Agui/Rectangle.cpp
src/Agui/xxx.cpp (and so on)
)

然后我认为需要做：

include_directories(./include)

然后我不太确定。

我知道 add_library 会参与其中，但我不确定如何参与。

问题是，我想创建 2 个选项：DLL 或静态。

如果是DLL，则必须定义AGUI_BUILD_DLL。

因此，根据这些信息：

1. 我走在正确的道路上吗？
2. 如何创建选项
3. add_library 中应放入什么
4. 如果用户想要 DLL 版本，如何添加预处理器 AGUI_BUILD_DLL？

如果其中任何一个或所有这些问题都能得到解答，我将不胜感激。

谢谢

Answer 1

我建议您查看 CMake 教程，其中介绍了添加可执行文件、库、系统自省等。 cmake 命令也是自记录的，因此在命令行输入时，

cmake --help-command add_library

将为您提供 add_library 命令的文档。您可以使用 --help-commands 获取所有 CMake 命令文档的完整列表。因此，您可以使用 option 命令添加用于构建共享或静态的选项，并使用 add_definitions 命令添加预处理器定义。

例如，

option(BUILD_SHARED "Build shared libraries" OFF)
if(BUILD_SHARED)
  add_definitions(-DAGUI_BUILD_DLL)
  add_library(agui SHARED ${AGUI_SOURCES})
else()
  add_library(agui STATIC ${AGUI_SOURCES})
endif()

您应该注意 targetName_EXPORTS 将在构建库时定义，因此可以在 declspec 逻辑中使用。这是由 CMake 完成的，在 Unix 系统上的 GCC 中使用可见性支持时也很有用。

Answer 2

1. 也许吧，不知道:)
2. 选项（AGUI_BUILD_DLL“构建agui DLL”关闭）
   靠近 CMakeLists.txt 开头的某个位置。您可能想要使用 ON 而不是 OFF - 取决于您是否希望 DLL 构建为默认值。

3,4。

if(AGUI_BUILD_DLL)
  add_library(agui SHARED ${AGUI_SOURCES})
  set_target_properties(agui PROPERTIES DEFINE_SYMBOL "AGUI_BUILD_DLL")
else()
  add_library(agui STATIC ${AGUI_SOURCES})
endif()