系统化学习cmake_3_static-library

介绍

显示了一个helloworld示例,该示例首先创建并链接了一个静态库。这是一个简化的示例,显示了库和二进制文件在同一个文件夹中。
本教程中的文件包括:

$ tree
.
├── CMakeLists.txt
├── include
│   └── static
│       └── Hello.h
└── src
    ├── Hello.cpp
    └── main.cpp
  • CMakeLists.txt - 包含要运行的CMake命令
  • include/Hello.h - 头文件
  • src/Hello.cpp - 资源文件
  • src/main.cpp - main文件

概念

添加一个静态库

add_library( )函数用来从源文件创造一个库,调用方法如下:

add_library(hello_library STATIC
    src/Hello.cpp
)

这将用于创建一个名为libhello_library.a的静态库,其中包含add_library调用中的源。
如前一个示例中所述,我们将源文件直接传递给add_library调用,这是现代CMake的建议。

添加头文件目录

在这个实例中,我们使用target_include_directories()函数将范围设置为PUBLIC。

target_include_directories(hello_library
    PUBLIC
        ${PROJECT_SOURCE_DIR}/include
)

这将使在以下位置使用包含的目录:

  • 当编译链接库的任何其他目标时。

  • 编译库

作用域的含义是:

  • PRIVATE-目录被添加到此目标的include目录中。
  • INTERFACE-该目录将添加到链接此库的任何目标的include目录中。
  • PUBLIC-如上所述,它包含在这个库中,也包含在链接此库的任何目标中。

在使用target_include_directories( )函数后,c++文件只需要引入相对路径即可,这有效避免了文件引用冲突。如:

#include "static/Hello.h"

链接库

当创建一个使用你的库的可执行文件时,你必须告诉编译器关于这个库的信息。这可以使用target_link_libraries()函数完成。

add_executable(hello_binary
    src/main.cpp
)

target_link_libraries( hello_binary
    PRIVATE
        hello_library
)

在二进制文件进行链接时告诉cmake去链接hello_library。它还将从链接库目标传播任何具有公共或接口作用域的include目录。

编译器调用的一个例子:

/usr/bin/c++ CMakeFiles/hello_binary.dir/src/main.cpp.o -o hello_binary -rdynamic libhello_library.a

构建例子

$ mkdir build

$ cd build

$ cmake ..
-- The C compiler identification is GNU 4.8.4
-- The CXX compiler identification is GNU 4.8.4
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/matrim/workspace/cmake-examples/01-basic/C-static-library/build

$ make
Scanning dependencies of target hello_library
[ 50%] Building CXX object CMakeFiles/hello_library.dir/src/Hello.cpp.o
Linking CXX static library libhello_library.a
[ 50%] Built target hello_library
Scanning dependencies of target hello_binary
[100%] Building CXX object CMakeFiles/hello_binary.dir/src/main.cpp.o
Linking CXX executable hello_binary
[100%] Built target hello_binary

$ ls
CMakeCache.txt  CMakeFiles  cmake_install.cmake  hello_binary  libhello_library.a  Makefile

$ ./hello_binary
Hello Static Library!
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容