CMake简单学习

ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC})
ADD_LIBRARY(hello STATIC ${LIBHELLO_SRC})

add_library(hello_static STATIC ${LIBHELLO_SRC})

set_target_properties(hello_static PROPERTIES OUTPUT_NAME "hello")

set_target_properties(hello_static PROPERTIES CLEAN_DIRECT_OUTPUT 1)

设置hello_static库文件只有在执行make clean命令时才会被删除。

默认情况下，CMake会自动将所有生成的库文件和可执行文件都放在构建目录下的一个特定位置。如果你不设置CLEAN_DIRECT_OUTPUT属性或者将其设置为0，那么在执行make clean命令时，CMake会删除这个目录中的所有内容，包括生成的库文件和可执行文件。

但是，如果你将CLEAN_DIRECT_OUTPUT属性设置为1，那么在执行make clean命令时，CMake只会删除由该目标直接生成的文件，而不会删除任何其他文件。在这个例子中，它只会删除hello_static库文件，而不会删除hello动态库文件和其他文件。

这个属性通常用于帮助节省时间和资源。因为静态库文件只需要在第一次构建时生成一次，因此在后续构建中，如果不需要重新生成该文件，则可以通过设置CLEAN_DIRECT_OUTPUT属性来避免不必要的文件操作。

INSTALL(FILES hello.h DESTINATION include/hello)

安装包含在hello.h文件中的头文件到系统路径usr/include/hello下。

INSTALL(TARGETS hello hello_static LIBRARY DESTINATION lib ARCHIVE DESTINATION lib)

安装生成的动态库和静态库到系统路径lib下。动态库被安装在lib目录下，静态库被安装在usr/lib/static目录下（因为静态库的输出名称已经被修改为hello）。

（5）使用外部共享库和头文件

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?图10 项目工程初始形态

hello.cpp的代码

#include "hello.h"
void HelloFunc()
{
    HelloFunc();
}

工程目录下的CMakeLists.txt的代码

project(HELLO)
add_subdirectory(src bin)

源代码src目录下的CMakeLists.txt的代码

include_directories(/usr/include/hello)

add_executable(hello hello.cpp)

target_link_libraries(hello libhello.so)

分析

include_directories(/usr/include/hello)

将/usr/include/hello目录添加到包含文件的搜索路径中。这样，在编译时，编译器将在该目录中查找头文件.

target_link_libraries(hello libhello.so)

将 libhello.so 动态库链接到 hello 可执行文件中。这样，在运行 hello 可执行文件时，系统将自动加载并使用 libhello.so 动态库中的函数和符号。

问题：代码中libhello.so是哪里来的为什么不用指明路径

答：TARGET_LINK_LIBRARIES 添加需要链接的共享库。当使用target_link_libraries函数时，如果要链接的库文件是系统默认的库文件或已在默认的库搜索路径中（例如 /usr/lib），则可以直接使用库文件名而无需指定完整的路径。

补充：LINK_DIRECTORIES 添加?标准的共享库搜索路径。当使用 LINK_DIRECTORIES 指令时，你需要提供库文件的完整路径。

最后，在build目录中cmake ..和make就行了，就不细讲了

三、shell脚本中的代码转入CMakeList.txt中例子

shell脚本的代码

gcc -c linuxrec.c
g++ -g -std=c++11 -o ivw_demo ivw_demo.cpp linuxrec.o -L./libs/ -laikit -lpthread -ldl -Wl,-rpath=lib -lasound

转换成CMakeList.txt中的代码

在 CMakeLists.txt 中添加一个可执行文件目标

add_executable(ivw_demo
    src/ivw_demo.cpp
    src/linuxrec.o
)

然后，指定该可执行文件需要链接的库文件和编译选项

target_link_libraries(ivw_demo
    libaikit
    pthread
    dl
    asound
)
set_target_properties(ivw_demo PROPERTIES
    LINK_FLAGS "-Wl,-rpath=lib"
)

分析

set_target_properties(ivw_demo PROPERTIES
    LINK_FLAGS "-Wl,-rpath=lib"
)

• 这行代码用于设置目标 ivw_demo 的链接属性。具体来说，它使用了 set_target_properties 函数来为目标设置属性，并且属性名称为 LINK_FLAGS。
• 在 CMake 中，PROPERTIES 是一个用于设置目标属性的关键字。通过使用 set_target_properties 函数，可以为指定的目标（如可执行文件、库文件等）设置不同的属性。
• LINK_FLAGS 属性是一个连接器选项，它允许你在链接目标时传递额外的标志给连接器。在这个例子中，-Wl,-rpath=lib 是要传递给连接器的标志。
• -Wl：这是 GCC/Clang 编译器的选项，用于将后面的参数传递给连接器。
• -rpath=lib：这是连接器选项，用于指定运行时库搜索路径。在这里，它指定了名为?lib?的目录作为运行时库的搜索路径。
• 因此，这行代码的作用是告诉连接器在链接 ivw_demo 目标时，将 lib 目录添加到运行时库搜索路径中。这样，当运行 ivw_demo 时，系统将在 lib 目录中查找并加载所需的运行时库。

最后，设置可执行文件的输出路径

set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_LIST_DIR}/../bin_${PLATFORM})
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${EXECUTABLE_OUTPUT_PATH})

分析

• EXECUTABLE_OUTPUT_PATH 被设置为 ${CMAKE_CURRENT_LIST_DIR}/../bin_${PLATFORM}。${CMAKE_CURRENT_LIST_DIR} 是 CMakeLists.txt 文件所在的当前目录，而 ${PLATFORM} 是一个变量，表示平台名称。
• CMAKE_RUNTIME_OUTPUT_DIRECTORY 被设置为 EXECUTABLE_OUTPUT_PATH。这样就将可执行文件的输出路径设置为 EXECUTABLE_OUTPUT_PATH。
• 通过这些设置，你可以指定生成的可执行文件的输出路径。${CMAKE_CURRENT_LIST_DIR} 表示以 CMakeLists.txt 文件所在的目录为基准，../bin_${PLATFORM} 表示将可执行文件放置在 CMakeLists.txt 文件所在目录的上一级目录中的名为 bin_${PLATFORM} 的子目录中。

四、学习资源

推荐（若有侵权，告知必删）：【从零开始详细介绍CMake】https://www.bilibili.com/video/BV1vR4y1u77h?p=10&vd_source=8a8939fa34f1535a58f4146e906da94a