【CMake】CMake打包Dll

已于 2024-05-15 23:11:59 修改
阅读量1.2k 收藏 26
点赞数 12
分类专栏： CMake 文章标签： 服务器 c++
于 2024-04-13 00:02:53 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_30340349/article/details/137689302
版权
本文详细阐述了CMake中的target属性设置、安装文件与头文件策略，以及CMakePackageConfigHelpers用于包配置和版本管理的部分，还涉及find_package和自定义命令的使用。
摘要由CSDN通过智能技术生成

设置lib的属性

1. target_include_directories

target_include_directories 是CMake的一个命令，用于特定的目标添加包含目录，包含目录是编译器在查找头文件会搜索的目标。

set(_INCLUDE_DIR 
    ${CMAKE_SOURCE_DIR}/src
    ${CMAKE_SOURCE_DIR}/3rdparty/plog
    ${CMAKE_SOURCE_DIR}/3rdParty/OpenCV460/include
)

set(_INCLUDE_DIR ${CMAKE_SOURCE_DIR}/src)
target_include_directories(${output_name_dynamic} PUBLIC
    $<BUILD_INTERFACE:${_INCLUDE_DIR}>
    $<INSTALL_INTERFACE:include>
)

1.1 BUILD_INTERFACE 和 <INSTALL_INTERFACE:include> 生成表达式

BUILD_INTERFACE 是CMake生成表达式的一部分，，通常用在target_include_directories或target_link_libraries等命令中，用于区分构建阶段和安装阶段。生成表达式是CMake的一种特性，它们在生成阶段被求值。
在构建阶段会被求值为一个路径，但是在安装阶段会被求值为空。
例如，下面的命令为目标添加一个包含目录：

target_include_directories(my_target PUBLIC
$<BUILD_INTERFACE:${CMAKE_SOURCE_DIR}/include
)

在这个例子中，${CMAKE_SOURCE_DIR}/include目录在构建阶段会被添加到包含目录中，但是在安装阶段不会。这意味着构建阶段，编译器会在${CMAKE_SOURCE_DIR}/include目录中查找文件，但是在安装阶段不会。
这种使用生成表达式的方式可以在构建和安装阶段使用不同的包含目录，这在创建可安装的库时非常有用。

同理： $<INSTALL_INTERFACE:dir>生成表达式在构建阶段被求值为空，在安装阶段被求值为dir。
这个命令使得在安装阶段添加包含目录。

2. set_target_properties

set_target_properties(${output_name_dynamic}
    PROPERTIES
    DEBUG_POSTFIX "d"
    CXX_STANDARD 17
)

CMake代码使用set_target_properties命令为${output_name_dynamic}目标设置了一些属性。

  • FOLDER Lib设置了目标在IDE中的文件夹。在这个例子中，目标会被放在名为"Lib"的文件夹中。
  • CXX_STANDARD 17设置了目标的C++标准。在这个例子中，目标会使用C++17标准进行编译。

3. install FILES 安装头文件及PDB

使用 install (FILES) 安装头文件

install(FILES  ${mfmeidabase_HEADERS} DESTINATION include/aibase)
install(FILES  ${media_HEADERS} DESTINATION include/media)
install(FILES  ${simple_HEADERS} DESTINATION include/mediawrapper)

安装PDB

install(FILES $<TARGET_PDB_FILE:${output_name_dynamic}> DESTINATION bin OPTIONAL)

4. install TARGETS 安装 库

这段CMake代码使用install命令为${output_name_dynamic}目标设置了安装规则。

EXPORT ${output_name_dynamic}Targets表示在安装目标时，也会导出一个名为${output_name_dynamic}Targets的导出文件。这个导出文件可以被其他CMake项目使用，以便在其他项目中使用这个目标。

  • LIBRARY DESTINATION lib表示库目标（如果存在）会被安装到lib目录。

  • ARCHIVE DESTINATION lib表示静态库目标（如果存在）会被安装到lib目录。

  • RUNTIME DESTINATION bin表示运行时目标（例如可执行文件和模块）会被安装到bin目录。

  • INCLUDES DESTINATION include表示目标的公共头文件会被安装到include目录。

这些目录是相对于安装前缀的，安装前缀可以在调用CMake时通过CMAKE_INSTALL_PREFIX变量设置。例如，如果安装前缀是/usr/local，那么库目标会被安装到/usr/local/lib目录，运行时目标会被安装到/usr/local/bin目录，公共头文件会被安装到/usr/local/include目录。

5. include(CMakePackageConfigHelpers)

include(CMakePackageConfigHelpers)是CMake的一个命令，它包含了CMakePackageConfigHelpers模块。

CMakePackageConfigHelpers模块提供了一些函数和宏，用于创建和安装CMake包配置文件。这些配置文件可以让其他CMake项目更容易地使用你的项目。

例如，CMakePackageConfigHelpers模块提供了configure_package_config_file函数，你可以使用这个函数来创建一个包配置文件。这个函数会将一个输入文件复制到一个输出文件，并替换输入文件中的一些变量。

这个模块还提供了write_basic_package_version_file函数，你可以使用这个函数来创建一个包版本文件。这个函数会生成一个文件，这个文件定义了一个CMake变量，这个变量包含了包的版本信息。

5.1 write_basic_package_version_file

write_basic_package_version_file(
    ${output_name_dynamic}Version.cmake
    COMPATIBILITY AnyNewerVersion)
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/${output_name_dynamic}Version.cmake"
    DESTINATION share/MFMeidaCapture)

这段CMake代码使用write_basic_package_version_file函数创建了一个包版本文件。

${output_name_dynamic}Version.cmake是输出文件的名字，${output_name_dynamic}是一个变量，它应该在之前被设置为一个字符串。

COMPATIBILITY AnyNewerVersion表示这个包与任何新版本兼容。这意味着如果其他项目要求一个更高的版本，CMake会认为这个包满足要求。

write_basic_package_version_file函数会生成一个文件，这个文件定义了一个CMake变量，这个变量包含了包的版本信息。这个文件可以被其他CMake项目使用，以便在其他项目中使用这个包。
此外还需要用install 来安装到目标地址，不然不会生成。

5.2 安装 xxxTarget.cmake

install(EXPORT ${output_name_dynamic}Targets
    FILE ${output_name_dynamic}Targets.cmake
    NAMESPACE mfcap::
    DESTINATION share/MFMeidaCapture)
  • FILE ${output_name_dynamic}Targets.cmake表示导出文件的名字是${output_name_dynamic}Targets.cmake。
  • NAMESPACE mfcap::表示在导出文件中，所有的目标都会被添加一个mfcap::的命名空间前缀

这个install命令会在安装阶段生成一个导出文件，这个导出文件包含了目标的信息，例如目标的类型、源文件、编译选项、依赖关系等。这个导出文件可以被其他CMake项目使用，以便在其他项目中使用这个目标。

例如，如果${output_name_dynamic}被设置为mylib，那么这个命令会创建一个名为mylibTargets.cmake的导出文件。这个文件可以被其他项目使用，以便在其他项目中使用mfcap::mylib目标。

NAMESPACE
在这个例子中，如果MyTargets导出文件中有一个名为mylib的目标，那么在导出文件中，这个目标的名字会变成mfcap::mylib。
其他CMake项目中使用这个命名空间前缀来引用这个目标。例如，你可以使用find_package(mfcap)和target_link_libraries(my_target mfcap::mylib)来在你的项目中使用mfcap::mylib目标。

这个命名空间前缀有两个作用：

  1. 避免命名冲突。如果两个不同的包都导出了一个名为mylib的目标，那么使用命名空间可以避免冲突。
  2. 明确指出目标来自哪个包。如果你看到一个名为mfcap::mylib的目标，你就知道这个目标来自mfcap包。

6. config_file

configure_file(MFMeidaCaptureConfig.cmake.in MFMeidaCaptureConfig.cmake @ONLY)

这段CMake代码使用configure_file函数来生成一个配置文件。

  • MFMeidaCaptureConfig.cmake.in是输入文件的名字。这个文件包含一些CMake变量
  • MFMeidaCaptureConfig.cmake是输出文件的名字。
  • @ONLY表示只有@VAR@形式的变量会被替换。如果没有@ONLY，那么${VAR}形式的变量也会被替换。
    一个典型的xxxConfig.cmake.in
include("${CMAKE_CURRENT_LIST_DIR}/@targets_export_name@.cmake")
check_required_components("@PROJECT_NAME@")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/MFMeidaCaptureConfig.cmake"
                DESTINATION share/MFMeidaCapture)

  • @PACKAGE_INIT@是一个变量，它会被替换为一些初始化代码。

  • @targets_export_name@是一个变量，它会被替换为导出文件的名字。

  • @PROJECT_NAME@是一个变量，它会被替换为项目的名字。

check_required_components(“@PROJECT_NAME@”)
check_required_components(“@PROJECT_NAME@”)是一个CMake命令，它用于检查是否找到了所有需要的组件。
这个命令通常在find_package命令之后使用。例如：

find_package(MyPackage REQUIRED COMPONENTS comp1 comp2)
check_required_components(MyPackage)

在这个例子中，find_package命令会尝试找到MyPackage包，并且需要comp1和comp2这两个组件。然后，check_required_components命令会检查是否真的找到了这两个组件。

如果没有找到所有需要的组件，check_required_components命令会生成一个错误消息，并停止CMake的处理过程

7. find_package

cmake_minimum_required(VERSION 3.10)
project(MFInstallDemo)

set(CMAKE_CXX_STANDARD 17)

set(MFMeidaCapture_DIR "${CMAKE_CURRENT_SOURCE_DIR}/MFMeidaCapture/share/MFMeidaCapture")
find_package(OpenCV HINTS ../3rdparty/OpenCV460)

find_package(MFMeidaCapture REQUIRED)
add_executable(MFInstallDemo main.cpp)
get_target_property(MFCapDll mfcap::MFMeidaCapture IMPORTED_LOCATION_RELWITHDEBINFO)
get_target_property(MFCapDllDebug mfcap::MFMeidaCapture IMPORTED_LOCATION_DEBUG)
target_link_libraries(
        MFInstallDemo 
        ${OpenCV_LIBS}
        mfcap::MFMeidaCapture
)

target_include_directories(
        MFInstallDemo 
        PRIVATE
        ${CMAKE_SOURCE_DIR}/../3rdparty/plog/
        ${MFMeidaCapture_INCLUDE_DIRS}
        ${OpenCV_INCLUDE_DIRS}
        # "${CMAKE_CURRENT_SOURCE_DIR}/../3rdparty/OpenCV460/include"
)

add_custom_command(TARGET MFInstallDemo POST_BUILD
        COMMAND ${CMAKE_COMMAND} -E copy_if_different
        "$<IF:$<CONFIG:DEBUG>,${MFCapDllDebug},${MFCapDll}>"
        $<TARGET_FILE_DIR:MFInstallDemo>
)

add_custom_command(TARGET MFInstallDemo POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        "$<IF:$<CONFIG:DEBUG>,${OpenCV_DIR}/x64/vc16/bin/opencv_world460d.dll,${OpenCV_DIR}/x64/vc16/bin/opencv_world460.dll>"
        $<TARGET_FILE_DIR:MFInstallDemo>)
Dovake
关注
  • 12
    点赞
  • 踩
  • 26
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Windows+MinGW使用CMake生成.dll动态链接库
阿清的随手记
06-20 1万+
在完成接口开发后，为了给其他开发人员调用，通常需要将这部分代码打包生成动态链接库文件。动态链接库很好地保证了代码的封装性和独立性，作为接口，它可以很好地独立于主程序，便于更新。调用接口的主程序编译时也会绕过已生成的动态链接库，仅作连接，在运行时使用它，减少了前端人员编译的时间消耗。......
cmake编译多个工程，一个执行工程调用dll工程。跨平台 win和Linux。 __declspec __attribute__ 函数导出导入动态库声明
weixin_44654161的博客
10-24 1941
cmake编译多个工程，一个工程专门生成 dll ，另一个工程调用dll。
cmake target_include_directories 详解
最新发布
qq_37805392的博客
06-16 392
在 CMake 中，target_include_directories 命令用于向特定目标（如可执行文件或库）添加包含目录，以便编译器能够找到特定目标所需的头文件。通过正确配置包含目录，可以确保编译器能够正确找到和包含项目中需要的头文件，这对于构建和管理大型项目尤为重要。
【CMake保姆级教程】制作动静态链接库、指定动静态库输出路径
m0_62599305的博客
12-22 4779
在软件开发中，我们经常听到动态链接库（Dynamic Link Library，DLL）和静态链接库（Static Link Library，LIB）的术语。它们是一种组织和共享代码的方式，有助于提高代码的可维护性和可重用性。本教程将使用CMake来创建动态链接库和静态链接库，为你提供一份简单易懂的指南，让你轻松理解这两种库的概念和制作过程。动态链接库是一种包含可执行代码和数据的文件，它可以在运行时被加载和执行。这种库的主要优势在于代码的共享，多个程序可以同时使用同一个动态链接库，从而减少内存占用。
如何将c语言编译成dll文件路径,如何使用CMake将DLL文件复制到与可执行文件相同的文件夹中？...
weixin_35731579的博客
05-21 718
我将使用 add_custom_command 与 cmake -E copy_if_different... 一起实现此目的 . 完整信息运行cmake --help-command add_custom_commandcmake -E所以在你的情况下，如果你有以下目录结构：/CMakeLists.txt/src/libs/test.dll以及该命令适用的CMake目标是 MyTest ，然后您...
Qt的CMake添加外部dll
qq_53704112的博客
07-15 1863
关于如何在QT的CMake中添加外部Dll
C++生成dll和调用dll以及利用CMAKE生成c++ dll的问题
yangjj2005的博客
05-09 5015
一、dll生成 1、设置项目属性：打开vs，建立空项目，在项目的 配置属性->常规->项目默认值->配置类型 修改为：动态库(.dll) 2、准备文件：填写头文件和源文件，注意头文件的声明，源文件正常。 ————————————————————————————————————— | 头文件： ...
windows下Qt6 使用CMake 安装时自动拷贝Qt及其他依赖文件
02-06
3. **复制Qt库和资源文件**：为了在目标机器上运行程序，你需要把Qt库文件和依赖的动态链接库一起打包。可以使用CMake的`file(GLOB ...)`命令收集需要的文件，然后使用`install(TARGETS ... COPY_FILE ...)`或者`add...
cmake bin目录
12-26
总结来说，CMake的bin目录是一个包含所有必要工具和库的集合，使得开发者可以在Windows环境下进行CMake项目构建、测试和打包。无论你是初学者还是经验丰富的开发者，理解并熟练使用这个目录中的文件都是至关重要的。...
JRtpLib 源码 CMake 编译方法
11-24
3. **编译方法**：描述了如何使用CMake和Visual Studio 2010来编译源码，生成lib和dll文件。 4. **编译后的lib与dll**：编译成功后得到的静态或动态链接库，供其他程序使用。 为了编译jRtpLib，你需要遵循以下步骤...
cmake-3.9.2-win64-x64.zip
05-29
CMake是一款跨平台的自动化...总的来说，"cmake-3.9.2-win64-x64.zip"提供了一套完整的CMake工具链，便于Windows开发环境中进行项目的构建、测试和打包，尤其是对于涉及DLL开发的项目，CMake能够提供强大的支持和便利。
cmake-3.10.3-win64-x64.zip
05-06
4. `lib`目录：可能包含CMake运行所需的动态链接库（`.dll`）或静态库（`.lib`），以及可能的第三方库。 5. `include`目录：可能包含头文件，供CMake的库或模块使用。 使用这个版本的CMake，开发者可以通过以下...
OpenCV4.0 cmake后生成的库文件，包含cuda模块和dnn模块
01-11
静态库（.lib）将所有依赖项打包到一个文件中，而动态库（.dll）在运行时从系统路径加载。根据项目需求选择合适的库类型。 DNN模块是OpenCV 4.0中的亮点之一，它提供了对多种深度学习框架的支持，如TensorFlow、...
Android Studio 基于cmake 链接静态库,动态库
03-18
动态库（如.so或.dll文件）则在运行时加载，可以被多个程序共享，减少内存占用，但需要确保运行环境中有相应的库文件。 要将CMake引入Android Studio项目，需要在项目的`build.gradle`（Module级别）文件中添加以下...
cmake-3.2.1-win32-x86.zip
02-02
4. `lib`目录：存放CMake的库文件，可能包含动态链接库（.dll）和静态库（.lib），用于CMake的内部功能。 5. `scripts`目录：可能包含CMake的脚本和其他辅助工具。 6. `CMakeLists.txt`：这是CMake项目的主配置文件...
第三篇:跨平台QT开发-打包
02-01
在QT项目中，可以使用`qmake`或`cmake`来生成NSIS脚本，或者直接编写NSIS脚本手动集成QT应用。例如，`qmake`的`win32deployqt`工具可以自动收集并添加QT项目的依赖库，但可能需要额外处理其他第三方库。 打包过程中...
Windows使用cmake编译dll
一亩田
01-14 1331
cmake mingw makefile
如何把c++文件通过cmake编译为dll文件
topcss的专栏
11-27 2166
这个CMake脚本首先设置了CMake的最低版本要求，然后定义了项目名称和C++标准。然后，它添加了源文件 hook.cpp 并将其编译为共享库（DLL）。最后，它链接了Windows的user32库，这是因为我们的代码中使用了 MessageBoxW 函数，该函数在user32库中定义。在CMake中，SHARED关键字用于指示库应该被构建为动态链接库（DLL），而不是静态库。动态链接库与静态库的主要区别在于，动态链接库在运行时被加载到内存中，而静态库在编译时被包含在最终的可执行文件中。
【CMake实例篇】04.创建一个共享库dll或so
小鱼酱的博客
03-22 584
CMake创建一个C/C++共享库dll或so
cmake项目正式打包发布
11-08
CMake是一个跨平台的自动化构建系统，可以用于管理项目的编译过程、测试和打包等。在CMake中，打包是将项目编译成可执行文件或库，并将其打包成可分发的格式，以便在其他计算机上运行。下面是CMake项目正式打包发布的步骤： 1. 在项目根目录下创建一个build目录，并进入该目录。 2. 在终端中运行cmake命令，指定项目的源代码目录，例如：cmake /path/to/source。 3. 运行make命令编译项目。 4. 运行make package命令打包项目，生成可分发的安装包。 5. 将生成的安装包分发给其他用户或安装在其他计算机上。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值