CMake 笔记

                     

贡献者： addis

预备知识　Makefile 笔记

　　 参考官方教程。

1. 常识

2. 常用命令

PRIVATE, INTERFACE, PUBLIC

target_include_directories(my_target
    # Only my_target can see these directories.
    PRIVATE
        src1/include
        src2/include
    # my_target and its dependents can see these directories.
    PUBLIC
        src3/include
        src4/include
    # Only dependents of my_target can see these directories.
    INTERFACE
        src5/include
        src6/include
)

3. 链接库

4. 静态和动态库

5. 函数

　　 自定义函数如 

# 计算一个数的平方
function(compute_square number result_var)
    math(EXPR result "${number} * ${number}")
    set(${result_var} ${result} PARENT_SCOPE)
endfunction()

# 函数调用
set(my_number 5)
compute_square(${my_number} my_result)
message(STATUS "The square of ${my_number} is ${my_result}")

6. CMake Package

如何写 包名Config.cmake（Config Mode）

　　 如果要写 Find包名.cmake，其实只需要使用 set() 设置若干路径变量即可。一般只有库的作者没有提供 config mode 的 cmake 时才需要用户写这个文件。用 apt 安装的包如果提供了该 cmake 一般也会被搜到。

　　 要写 包名Config.cmake，需要给 add_library 定义要导出的 target，以及用 set_target_properties 指定库文件和头文件的路径，这样用户导入的时候就不需要再设置一次了。 

# MyLibraryConfig.cmake
# Define the paths to the library and include directories
set(MyLibrary_LIBRARIES "${CMAKE_CURRENT_LIST_DIR}/lib/file.a")
set(MyLibrary_INCLUDE_DIRS "${CMAKE_CURRENT_LIST_DIR}/include")
# Create an imported target for MyLibrary
add_library(MyLibrary STATIC IMPORTED)
# Set the properties for the imported target
set_target_properties(MyLibrary PROPERTIES
  # set lib files location so that user can import the target
  IMPORTED_LOCATION "${MyLibrary_LIBRARIES}"
  # set header files location so that user can import the target
  INTERFACE_INCLUDE_DIRECTORIES "${MyLibrary_INCLUDE_DIRS}"
)
# Optionally, set the MyLibrary_FOUND variable
# to indicate the library was found
set(MyLibrary_FOUND TRUE)

# Minimum CMake version
cmake_minimum_required(VERSION 3.10)

# Project name
project(MyLibrary)

# Set the version (optional)
set(MYLIBRARY_VERSION_MAJOR 1)
set(MYLIBRARY_VERSION_MINOR 0)

# Define the library target
add_library(MyLibrary SHARED IMPORTED)

# Specify the directories for header files
target_include_directories(MyLibrary
    INTERFACE
    # Replace with actual path
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# Link the library files (use separate statements
#     for different OSes if needed)
set_target_properties(MyLibrary PROPERTIES
    # Linux
    IMPORTED_LOCATION "${CMAKE_CURRENT_SOURCE_DIR}/lib/mylibrary.so"
    # Windows
    IMPORTED_IMPLIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/mylibrary.dll"
)

# Define macros required by the library
target_compile_definitions(MyLibrary
    INTERFACE
    MYLIBRARY_DEFINE_1
    MYLIBRARY_DEFINE_2=VALUE  # Example with a value
)

# Export the library target for use in other projects
export(TARGETS MyLibrary FILE MyLibraryConfig.cmake)

7. install

8. 内置变量

9. 判断

　　 参考这里。 

if(1 或 ON 或 YES 或 TRUE 或 Y)
  ……
elseif(0 或 OFF 或 NO 或 FALSE 或 N 或 IGNORE 或 NOTFOUND)
  这里永远不会执行
elseif(条件 AND (条件 OR 条件) OR NOT 条件)
  ……
elseif(("bar" IN_LIST 变量) OR (file1 IS_NEWER_THAN file2))
  ……
elseif(变量)
  当变量有定义且不是 false constant
if(ENV{变量})
  这里永远不会执行
elseif (DEFINED <name>|CACHE{<name>}|ENV{<name>})
  若定义了变量
elseif (变量1 STREQUAL 变量2)
  比较字符串
elseif (IS_DIRECTORY 某路径)
  判断某路径是否存在
else()
  ……
endif()
一些细节：

10. CMake 与 Visual Studio

11. ccmake 使用


致读者： 小时百科一直以来坚持所有内容免费无广告，这导致我们处于严重的亏损状态。 长此以往很可能会最终导致我们不得不选择大量广告以及内容付费等。 因此，我们请求广大读者热心打赏 ，使网站得以健康发展。 如果看到这条信息的每位读者能慷慨打赏 20 元，我们一周就能脱离亏损， 并在接下来的一年里向所有读者继续免费提供优质内容。 但遗憾的是只有不到 1% 的读者愿意捐款， 他们的付出帮助了 99% 的读者免费获取知识， 我们在此表示感谢。

                     

友情链接： 超理论坛　|　©小时科技 保留一切权利