CMake-创建静态库

问题：CMake中如何创建静态库？

回答：

在使用CMake构建项目时，创建静态库是一种常见的需求。静态库是一种编译后的代码集合，它可以在程序编译时被链接到程序中，而不是在程序运行时被动态加载。下面我将详细解释如何在CMake中创建一个静态库，并提供一个实际的示例。

步骤1: 准备源代码

首先，你需要准备好你打算编译成静态库的源代码。假设我们有一个简单的项目，其中包括两个文件：library.cpp 和 library.h。

library.h

cpp
#ifndef LIBRARY_H
#define LIBRARY_H

void print_hello();

#endif

library.cpp

cpp
#include "library.h"
#include <iostream>

void print_hello() {
    std::cout << "Hello, Static Library!" << std::endl;
}

步骤2: 编写CMakeLists.txt文件

接下来，你需要编写一个CMakeLists.txt文件来告诉CMake如何编译这些源代码文件并创建静态库。

CMakeLists.txt

cmake
cmake_minimum_required(VERSION 3.10)  # 指定CMake的最低版本要求

project(MyStaticLibrary)              # 定义项目名称

add_library(mylib STATIC             # 创建静态库`mylib`
    library.cpp
    library.h
)

这里add_library命令用于创建一个新的库。mylib是库的名字，STATIC指定了我们要创建的是一个静态库，后面跟着要编译成库的源文件。

步骤3: 编译项目

为了编译这个库，你需要执行以下命令：

1. 创建一个构建目录并进入：

   bash
   mkdir build
   cd build

2. 运行CMake来配置项目并生成构建系统：

   bash
   cmake ..

3. 编译代码：

   bash
   cmake --build .

执行上述命令后，你会在build目录下找到编译好的静态库文件（如libmylib.a，具体名称可能因平台而异）。

总结

通过上述步骤，我们成功地用CMake创建了一个静态库。这种方法在实际开发中非常常见，因为它可以帮助我们将代码模块化，提高代码重用性，并简化大型项目的管理。

当使用 CMake 创建静态库时，首先需要编写一个 CMakeLists.txt 文件，用来定义项目的编译信息。以下是创建一个简单的静态库的步骤和示例。

1. 项目结构

假设我们有以下简单的项目结构：

shell
/my_library
|-- include
|   |-- mylib.h
|-- src
|   |-- mylib.cpp
|-- CMakeLists.txt

在这个结构中：

• include 文件夹包含所有头文件。
• src 文件夹包含所有源代码文件。
• CMakeLists.txt 是我们需要编写的 CMake 配置文件。

2. 编写 CMakeLists.txt

在 CMakeLists.txt 文件中，我们需要指定项目名、CMake最低版本号、需要包含的头文件目录，以及需要编译成静态库的源文件。

cmake
cmake_minimum_required(VERSION 3.10)  # 指定CMake的最低版本要求

project(MyLibrary)  # 定义项目名称

# 指定头文件目录
include_directories(include)

# 将src目录下的源文件编译成名为mylib的静态库
file(GLOB_RECURSE SOURCES "src/*.cpp")
add_library(mylib STATIC ${SOURCES})

3. 编译项目

在项目根目录（即 CMakeLists.txt 所在的目录）下，运行以下命令来生成 Makefile 并编译项目：

bash
mkdir build
cd build
cmake ..
make

这些命令首先创建一个名为 build 的目录来存放编译生成的文件，然后使用 cmake .. 生成 Makefile，最后用 make 命令编译项目。

4. 使用静态库

生成的静态库通常名为 libmylib.a（在 Unix-like 系统上），位于 build 目录下。如果要在其他项目中使用这个库，需要将头文件目录和库文件目录添加到项目中，然后链接这个库。

小结

通过这个例子，我们可以看到，使用 CMake 创建静态库是一个比较直接的过程，主要涉及到编写合适的 CMakeLists.txt 文件来指定如何编译源代码文件到静态库。这种方法非常灵活，可以很容易地扩展到更大的项目中。