cmkae命令set_target_properties

一、介绍

命令的格式如下

set_target_properties(target1 target2 ...
                      PROPERTIES prop1 value1
                      prop2 value2 ...)

Sets properties on targets. The syntax for the command is to list all the targets you want to change, and then provide the values you want to set next. You can use any prop value pair you want and extract it later with the get_property() or get_target_property() command.

意思就是：

这个命令是设置目标的属性，该命令的语法是列出想要更改的所有目标，然后提供接下来想要设置的值。您可以使用该命令任何所需的键值对，然后使用get_property()或get_target_property()命令提取它。

二、使用

有如下例子

１、建立一个静态库和动态库，提供HelloFunc函数供其他程序编程使用，HelloFunc

向终端输出Hello World字符串。

２、安装头文件与共享库。

3、编写一个程序，来使用创建的共享库（静态库和动态库）。

首先，新建一个目录，创建MakeList.txt

/home/code/test/build

PROJECT(HELLOLIB)

# 通过在主工程文件CMakeLists.txt中修改ADD_SUBDIRECTORY (lib) 指令来指定一个编译输出位置;

# 指定本工程中静态库libhello.so生成的位置，即 build/lib;

ADD_SUBDIRECTORY(lib)

在lib目录下建立两个源文件hello.cpp与 hello.h

hello.cpp内容如下：

#include "hello.h"

using namespace std;

void HelloFunc(){

    cout << "Hello World/n";

}

hello.h内容如下：

#ifndef HELLO_H

#define HELLO_H

#include <stdio.h>

void HelloFunc();

#endif

在lib目录下建立CMakeLists.txt，内容如下： 

SET (LIBHELLO_SRC hello.cpp)

# SET (LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

# 添加动态库，关键词为shared，不需要写全称libhello.so，

# 只需要填写hello即可，cmake系统会自动为你生成 libhello.X


ADD_LIBRARY (hello SHARED ${LIBHELLO_SRC})


# 添加静态库，关键词为static，ADD_LIBRARY (hello STATIC ${LIBHELLO_SRC})

# 仍然用hello作为target名时，是不能成功创建所需的静态库的，

# 因为hello作为一个target是不能重名的， 故把上面的hello修改为hello_static

# 同理，你不需要写全libhello_static.a

# 只需要填写hello即可，cmake系统会自动为你生成 libhello_static.X


ADD_LIBRARY (hello_static STATIC ${LIBHELLO_SRC})


# 按照一般的习惯，静态库名字跟动态库名字应该是一致的，只是扩展名不同；

# 即：静态库名为 libhello.a； 动态库名为libhello.so ；

# 所以，希望 "hello_static" 在输出时，不是"hello_static"，而是以"hello"的名字显示，故设置如下：


SET_TARGET_PROPERTIES (hello_static PROPERTIES OUTPUT_NAME "hello")


GET_TARGET_PROPERTY (OUTPUT_VALUE hello_static OUTPUT_NAME)


MESSAGE (STATUS "This is the hello_static OUTPUT_NAME: " ${OUTPUT_VALUE})


# cmake在构建一个新的target时，会尝试清理掉其他使用这个名字的库，

# 因此，在构建libhello.a时，就会清理掉libhello.so.

# 为了回避这个问题，比如再次使用SET_TARGET_PROPERTIES定义 CLEAN_DIRECT_OUTPUT属性。


SET_TARGET_PROPERTIES (hello_static PROPERTIES CLEAN_DIRECT_OUTPUT 1)

SET_TARGET_PROPERTIES (hello PROPERTIES CLEAN_DIRECT_OUTPUT 1)


# 按照规则，动态库是应该包含一个版本号的，

# VERSION指代动态库版本，SOVERSION指代API版本。

SET_TARGET_PROPERTIES (hello PROPERTIES VERSION 1.2 SOVERSION 1)

 
# 我们需要将libhello.a, libhello.so.x以及hello.h安装到系统目录，才能真正让其他人开发使用，

# 在本例中我们将hello的共享库安装到<prefix>/lib目录；

# 将hello.h安装<prefix>/include/hello目录。

INSTALL (TARGETS hello hello_static LIBRARY DESTINATION lib

ARCHIVE DESTINATION lib)

INSTALL (FILES hello.h DESTINATION include/hello)

在build目录中

cmake ..

make

这时，你就可以在lib目录得到一个libhello.so，这就是我们期望的共享库。

如果你要指定libhello.so生成的位置，可以通过：

• 在主工程文件CMakeLists.txt中修改ADD_SUBDIRECTORY (lib) 指令来指定一个编译输出位置；
• 或者在 lib/CMakeLists.txt中添加SET (LIBRARY_OUTPUT_PATH <路径>) 来指定一个新的位置。

参考：

set_target_properties — CMake 3.22.0 Documentation
add_subdirectory — CMake 3.22.0 Documentation

（转）HelloWorld CMake CMake中构建静态库与动态库及其使用 - 莫水千流 - 博客园