选择静态或共享库
下一篇:练习11 添加导出配置,上一篇:练习9 打包安装程序,目录|首页
温故知新
经过第一个练习,大家对于基本的使用应该已经掌握了,由于代码过多,在文档中详细介绍太过于啰嗦,大家可以自行下载代码参考
- 练习1 构建一个基本项目
cmake_minimum_required()
是一个用于指定构建特定项目所需的最低CMake版本的函数。project()
函数用于定义一个项目,并指定项目的名称及相关属性。add_executable()
用于指定生成一个可执行文件的目标。CMAKE_CXX_STANDARD
用于指定项目中C++编译器要遵循的C++标准。CMAKE_CXX_STANDARD_REQUIRED
用于指示是否要求编译器强制使用指定的C++标准。set()
函数用于设置变量的值。<PROJECT-NAME>_VERSION_MAJOR
通常用于访问项目的主要版本号。<PROJECT-NAME>_VERSION_MINOR
通常用于访问项目的次要版本号。configure_file()
用于在生成构建系统时复制文件并替换其中的变量值。target_include_directories()
用于指定一个目标(通常是可执行文件或库)的头文件包含路径。
- 练习2 添加库
add_library()
用于创建和配置一个库目标。add_subdirectory()
是用于将其他源代码目录(通常是子目录)添加到当前 CMake 项目中,并在这些子目录中构建其他 CMake 项目。target_link_libraries()
用于为一个目标(通常是可执行文件或库)指定它所依赖的其他库。PROJECT_SOURCE_DIR
它包含了当前 CMake 项目的根源代码目录的路径。if()
用于根据条件的真假来执行不同的 CMake 代码块。option()
命令用于定义用户可配置的选项。target_compile_definitions()
用于为特定目标(通常是可执行文件或库)设置编译时宏定义(preprocessor definitions)。
- 练习3 添加库的使用要求
target_compile_options()
用于为特定目标(通常是可执行文件或库)设置编译选项(compiler options)target_link_directories()
命令用于为特定目标(通常是可执行文件或库)指定链接目录,以帮助构建系统在链接目标时查找共享库或库文件的位置。target_link_options()
是 CMake 中的一个命令,用于为特定目标(通常是可执行文件或库)设置链接器选项。target_precompile_headers()
是 CMake 3.16 版本引入的一项功能,它用于为目标(通常是可执行文件或库)预编译头文件(precompiled headers)以提高构建性能。target_sources()
用于向特定目标(通常是可执行文件或库)添加源文件,以便将这些源文件编译并链接到目标中。target_compile_features()
是 CMake 中的一个命令,用于为特定目标(通常是可执行文件或库)设置编译器支持的 C++ 特性(C++ features)。
- 练习4 添加生成器表达式
cmake-generator-expressions()
(CMake 生成器表达式)是一种在 CMake 构建系统中用于生成构建文件的特殊表达式。
- 练习5 安装和测试
install()
用于指定在构建完成后如何安装项目的文件和目标(可执行文件、库、头文件等)。enable_testing()
用于启用测试支持,允许你在项目中定义和运行测试。add_test()
用于定义和创建测试。function()
用于定义自定义函数(Custom Function)。set_tests_properties()
用于配置已定义的测试的属性。ctest
是 CMake 的测试驱动工具,用于运行和管理项目中定义的测试。
- 练习6 添加对测试仪表板的支持
- 练习7 添加系统自省
CheckCXXSourceCompiles
是 CMake 中的一个宏,用于检查给定的 C++源代码片段是否可以成功编译。
- 练习8 添加自定义命令和生成的文件
- 练习9 打包安装程序
在本节中,我们将展示如何BUILD_SHARED_LIBS
变量可用于控制默认行为add_library()
,并允许控制如何构建没有显式类型( STATIC
、 SHARED
或)的库。MODULE``OBJECT
为了实现这一点,我们需要添加BUILD_SHARED_LIBS
到了顶层CMakeLists.txt
。我们使用option()
命令,因为它允许用户选择值是否应该是ON
或OFF
。
- CMakeLists.txt
option(BUILD_SHARED_LIBS "Build using shared libraries" ON)
接下来,我们需要为静态库和共享库指定输出目录。
- CMakeLists.txt
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}")
option(BUILD_SHARED_LIBS "Build using shared libraries" ON)
最后,更新MathFunctions/MathFunctions.h
为使用 dll 导出定义:
- MathFunctions/MathFunctions.h
#if defined(_WIN32)
# if defined(EXPORTING_MYMATH)
# define DECLSPEC __declspec(dllexport)
# else
# define DECLSPEC __declspec(dllimport)
# endif
#else // non windows
# define DECLSPEC
#endif
namespace mathfunctions {
double DECLSPEC sqrt(double x);
}
此时,如果您构建所有内容,您可能会注意到链接失败,因为我们将没有位置无关代码的静态库与具有位置无关代码的库组合在一起。解决这个问题的方法是显式设置POSITION_INDEPENDENT_CODE
构建共享库时SqrtLibrary 的 target 属性True
。
- MathFunctions/CMakeLists.txt
# state that SqrtLibrary need PIC when the default is shared libraries
set_target_properties(SqrtLibrary PROPERTIES
POSITION_INDEPENDENT_CODE ${BUILD_SHARED_LIBS}
)
定义我们在 Windows 上构建时EXPORTING_MYMATH
使用的声明。declspec(dllexport)
- MathFunctions/CMakeLists.txt
# define the symbol stating we are using the declspec(dllexport) when
# building on windows
target_compile_definitions(MathFunctions PRIVATE "EXPORTING_MYMATH")
练习:我们修改MathFunctions.h
为使用 dll 导出定义。使用 CMake 文档,你能找到一个帮助模块来简化这个过程吗?
下一篇:练习11 添加导出配置,上一篇:练习9 打包安装程序,目录|首页