正文

CMakeLists.txt入门必看：基础语法全面解析及实战操作指南

/0 浏览量
0401

引言

CMake 是一个跨平台的自动化构建系统，它被广泛用于构建各种类型的软件项目。CMakeLists.txt 文件是 CMake 的核心，它定义了项目的构建规则。对于初学者来说，理解 CMakeLists.txt 的基础语法和实战操作至关重要。本文将全面解析 CMakeLists.txt 的基础语法，并提供实战操作指南。

一、CMakeLists.txt 的基础语法

1. 项目定义

CMakeLists.txt 文件的第一行通常是项目定义，如下所示：

cmake_minimum_required(VERSION 3.10)
project(MyProject 1.0)

这里，cmake_minimum_required 指定了 CMake 的最低版本要求，project 定义了项目的名称和版本。

2. 添加库和可执行文件

使用 add_library 和 add_executable 命令可以添加库和可执行文件。以下是一个示例：

add_library(MyLibrary src/mylibrary.cpp)
add_executable(MyExecutable src/main.cpp)
target_link_libraries(MyExecutable MyLibrary)

这里，MyLibrary 是一个库，由 mylibrary.cpp 文件构建；MyExecutable 是一个可执行文件，由 main.cpp 文件构建。target_link_libraries 命令用于将库链接到可执行文件。

3. 添加头文件目录

使用 include_directories 命令可以添加头文件目录：

include_directories(include)

这会将 include 目录添加到项目的头文件搜索路径中。

4. 添加源文件

使用 add_sources 命令可以添加源文件：

add_sources(src/*.cpp)

这会将 src 目录下的所有 .cpp 文件添加到项目中。

二、实战操作指南

1. 创建一个简单的 C++ 项目

  1. 创建一个名为 MyProject 的目录。
  2. 在 MyProject 目录下创建一个名为 src 的子目录。
  3. 在 src 目录下创建一个名为 main.cpp 的文件，内容如下：
#include <iostream>
using namespace std;

int main() {
    cout << "Hello, World!" << endl;
    return 0;
}
  1. 创建一个名为 CMakeLists.txt 的文件，内容如下：
cmake_minimum_required(VERSION 3.10)
project(MyProject 1.0)

add_executable(MyExecutable src/main.cpp)
  1. 打开终端，进入 MyProject 目录，运行以下命令：
mkdir build
cd build
cmake ..
make
  1. 运行生成的可执行文件：
./MyExecutable

这将输出 “Hello, World!”。

2. 创建一个使用多个文件的 C++ 项目

  1. 在 MyProject 目录下创建一个名为 include 的子目录。
  2. 在 include 目录下创建一个名为 myheader.h 的文件，内容如下：
#ifndef MYHEADER_H
#define MYHEADER_H

void myFunction();

#endif
  1. 在 include 目录下创建一个名为 myheader.cpp 的文件，内容如下：
#include "myheader.h"

void myFunction() {
    cout << "Hello, World!" << endl;
}
  1. 在 src 目录下创建一个名为 main.cpp 的文件，内容如下：
#include <iostream>
#include "include/myheader.h"
using namespace std;

int main() {
    myFunction();
    return 0;
}
  1. 修改 CMakeLists.txt 文件，添加以下内容：
include_directories(include)

add_library(MyLibrary src/myheader.h src/myheader.cpp)
add_executable(MyExecutable src/main.cpp)

target_link_libraries(MyExecutable MyLibrary)
  1. 重复步骤 5 和 6，构建和运行项目。

通过以上步骤，您可以创建和使用 CMakeLists.txt 文件来构建 C++ 项目。这只是一个简单的示例，CMake 还支持许多其他功能，例如测试、安装和打包等。随着您对 CMake 的深入了解，您将能够构建更复杂的项目。

-- 展开阅读全文 --