如何在 CMake 项目中创建一个共享库，并在同一个项目中生成使用该库的可执行程序。

tutorial_5/CMakeLists.txt

# 声明要求的 cmake 最低版本
cmake_minimum_required( VERSION 2.8 )

# 声明一个 cmake 工程
project( tutorial_5 )

include_directories(include)


set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
# 共享库
add_library( tutorial_4 SHARED src/tutorial_4.cpp)

# 为工程添加子目录bin放入生成的可执行程序
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

add_executable(tutorial_5 example/tutorial_5.cpp)
target_link_libraries(tutorial_5 tutorial_4)

tutorial_5/example/tutorial_5.cpp

#include "tutorial_4.h"

/**
 * 代码作者：小秋SLAM实战教程
 * 开发环境：Ubuntu 16.04
 * 运行依赖：C++ 11
 */

// 使用 libHelloSLAM.h 中的 printHello() 函数
int main( int argc, char** argv )
{
    printHello();
    return 0;
}

tutorial_5/include/tutorial_4.h

#ifndef LIBHELLOSLAM_H_
#define LIBHELLOSLAM_H_
// 上面的宏定义是为了防止重复引用这个头文件而引起的重定义错误

void printHello();

#endif

tutorial_5/src/tutorial_4.cpp

//这是一个库文件
#include <iostream>
using namespace std;

void printHello()
{
    std::cout<<"小秋SLAM实战教程"<<std::endl;
}

这个示例展示了如何在 CMake 项目中创建一个共享库，并在同一个项目中生成使用该库的可执行程序。以下是详细的文件解释和构建过程：

项目的结构如下所示：

/tutorial_5
|-- CMakeLists.txt
|-- /src
    |-- tutorial_4.cpp
|-- /include
    |-- tutorial_4.h
|-- /example
    |-- tutorial_5.cpp

根目录的 CMakeLists.txt

位于 tutorial_5 的 CMakeLists.txt 文件配置了整个项目。

cmake_minimum_required(VERSION 2.8)
project(tutorial_5)

include_directories(include)

set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
add_library(tutorial_4 SHARED src/tutorial_4.cpp)

set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
add_executable(tutorial_5 example/tutorial_5.cpp)
target_link_libraries(tutorial_5 tutorial_4)

• add_library(tutorial_4 SHARED src/tutorial_4.cpp)：创建一个名为 tutorial_4 的共享库。
• add_executable(tutorial_5 example/tutorial_5.cpp)：创建一个名为 tutorial_5 的可执行程序。
• target_link_libraries(tutorial_5 tutorial_4)：链接可执行程序 tutorial_5 和共享库 tutorial_4。

tutorial_5.cpp

这是 tutorial_5 可执行程序的主函数文件，它使用了共享库中的 printHello 函数。

#include "tutorial_4.h"

int main(int argc, char** argv) {
    printHello();
    return 0;
}

tutorial_4.cpp 和 tutorial_4.h

tutorial_4.cpp 和 tutorial_4.h 定义了共享库的内容。这里 printHello 函数被定义在 tutorial_4.cpp 中，并在头文件 tutorial_4.h 中声明。

构建过程

1. 创建一个构建目录：在项目根目录中创建一个新目录，例如 build，用于存放构建文件。

2. 运行 CMake：从 build 目录运行 cmake .. 命令以生成 Makefile。

3. 编译项目：在 build 目录中运行 make 命令来编译项目。

4. 检查生成的库和可执行文件：

   • 生成的共享库 libtutorial_4.so 将位于 lib 目录中。
   • 生成的可执行文件 tutorial_5 将位于 bin 目录中。

运行可执行文件

运行位于 bin 目录中的 tutorial_5 可执行文件。它将使用 libtutorial_4.so 共享库中定义的 printHello 函数。

总结

这个示例展示了如何在一个 CMake 项目中既创建共享库又创建使用该库的可执行程序。通过将共享库的源文件和头文件分别放在 src 和 include 子目录中，项目的结构变得清晰并易于管理。这种方法对于同时构建库和可执行程序的项目特别有用。