cmake常用的几个操作
-
mkdir build
: 创建一个名为build
的目录,通常用于存放构建过程中生成的文件。这种做法能够避免把编译生成的文件混在源代码目录中,保持源代码目录干净。 -
cd build
: 进入刚刚创建的build
目录,这样后续的构建操作都将在这个目录内进行。 -
cmake ..
: 使用CMake
工具生成构建配置文件。..
表示上级目录,也就是源代码所在的目录(假设源代码和CMakeLists.txt
文件位于build
目录的上一级)。CMake 会读取上级目录中的CMakeLists.txt
文件,并生成适合当前系统的构建文件(例如,Makefile、Visual Studio 项目文件等)。 -
make
: 通过make
工具,根据cmake
生成的构建文件(例如Makefile
)进行实际的编译操作。这一步会编译源代码并生成二进制可执行文件或库文件。 -
make install
: 将编译生成的文件安装到系统指定的目录,通常是/usr/local/
或者其他指定路径中。这一步会将可执行文件、库文件和可能的配置文件等安装到系统的相应位置,以便用户或其他程序使用。
在一些 C++ 项目中,直接执行 make
命令就能编译,是因为项目已经包含了一个名为 Makefile
的文件。Makefile
是一种构建脚本,它定义了如何编译和链接程序,告诉 make
工具应该执行哪些步骤来生成可执行文件。
以下是一些关键原因:
-
Makefile 文件的存在:
项目根目录中有一个Makefile
文件。make
会自动读取这个文件,并按照其中的规则执行编译。Makefile
通常包括以下内容:- 编译器(如
g++
)的使用方式。 - 源代码文件和头文件的依赖关系。
- 编译和链接命令。
- 编译器(如
-
自动化编译过程:
Makefile
定义了如何从源代码生成可执行文件,可以自动处理文件依赖,避免每次都手动输入复杂的编译命令。只要源代码中有修改,make
就会智能地重新编译受影响的文件。 -
标准化项目结构:
很多 C++ 项目采用类似的目录结构和Makefile
格式。例如,源代码通常放在src/
目录,头文件在include/
,编译后的对象文件在build/
。Makefile
会根据这些规则自动找到需要编译的文件。 -
简化构建过程:
Makefile
可以简化编译过程,尤其是当项目有多个文件或依赖库时。它可以将不同的编译选项、库链接等复杂操作封装为简单的make
命令。 -
支持增量编译:
make
只会重新编译修改过的文件,从而加快编译过程。每个源文件编译成.o
(对象文件)后,make
仅会对已改变的部分重新编译。
通过这些机制,直接执行 make
就可以编译项目,而无需每次手动输入编译指令。
Makefile
和 CMakeLists.txt
都是用于自动化编译的文件,但它们有很大的区别,尤其是在使用场景和灵活性方面。以下是二者的主要区别:
1. 用途和定位
-
Makefile:
Makefile
是make
工具使用的文件,主要用于定义如何编译和链接程序。- 它是针对特定平台和编译器的构建脚本,编写者需要手动定义编译命令和规则。
Makefile
通常比较简单,适合小型项目,但对于大型项目,维护难度会增加。
-
CMakeLists.txt:
CMakeLists.txt
是CMake
构建系统的配置文件,用于跨平台项目的自动构建。- CMake 本身并不编译代码,而是生成特定平台的构建系统文件,比如在 Linux 上生成
Makefile
,在 Windows 上生成 Visual Studio 项目的.sln
文件。 - 它能自动处理不同编译器、操作系统等细节,适合跨平台和大型项目。
2. 平台依赖性
-
Makefile:
- 是基于具体系统的构建工具,通常适用于 Unix-like 系统(如 Linux 和 macOS)。在 Windows 上使用
Makefile
需要额外的工具(如MinGW
或Cygwin
)。 - 编写的命令通常与特定的编译器和系统相关,因此不具备良好的跨平台能力。
- 是基于具体系统的构建工具,通常适用于 Unix-like 系统(如 Linux 和 macOS)。在 Windows 上使用
-
CMakeLists.txt:
CMake
是跨平台的构建工具,能够根据目标操作系统生成相应的构建文件,支持多种平台和编译器。CMake
可以为 Windows、Linux、macOS 以及嵌入式设备生成适合的构建文件。开发者只需编写一个通用的CMakeLists.txt
文件,无需关心不同系统的细节。
3. 灵活性与自动化
-
Makefile:
Makefile
通常比较硬编码,用户必须手动指定所有的编译器选项、文件路径、库链接等内容。- 它不具备自动发现依赖库、自动生成配置文件等功能。如果项目需要改变编译器、目标平台或依赖库,
Makefile
需要手动调整。
-
CMakeLists.txt:
CMake
能够自动检测编译器、依赖库、系统特性等,可以通过一系列命令来查找库、头文件等。例如,使用find_package()
可以自动检测依赖项。- CMake 提供了很多高级特性,如构建目录结构、单元测试集成、安装包生成等,适合更复杂的构建需求。
4. 构建过程
-
Makefile:
- 使用
Makefile
时,用户直接调用make
工具来根据Makefile
中的规则编译项目。 - 例如,执行
make
会触发文件中的编译命令,生成目标文件。
- 使用
-
CMakeLists.txt:
- 使用
CMakeLists.txt
时,先通过cmake
命令生成特定系统的构建文件(如Makefile
或 Visual Studio 项目文件)。 - 例如,在 Unix-like 系统上,执行
cmake .
会生成Makefile
,然后再执行make
进行编译;在 Windows 上,执行cmake
会生成.sln
,之后可以用 Visual Studio 打开并编译。
- 使用
5. 可维护性
-
Makefile:
- 对于简单的项目,
Makefile
非常易于维护,但当项目变得复杂(例如有多个库、不同的构建配置等),维护Makefile
可能会变得困难,因为所有步骤都必须显式编写。
- 对于简单的项目,
-
CMakeLists.txt:
- 对于复杂的项目,
CMakeLists.txt
更加灵活和可维护。CMake
提供了很多内建命令来处理项目配置,可以通过模块化和查找库等方式简化管理。 - 它能根据不同平台、编译器自动生成合适的构建规则,减少人为错误。
- 对于复杂的项目,
6. 依赖管理
-
Makefile:
Makefile
的依赖管理相对简单,通常使用显式的依赖定义。如果需要处理复杂的依赖关系,需要手动配置。
-
CMakeLists.txt:
CMake
提供了内置的依赖管理工具,可以自动发现和配置项目依赖项,支持外部库的查找与链接,简化依赖项的管理。
结论
- Makefile 更加适合简单的、面向单一平台的项目,适合那些不需要复杂依赖管理和跨平台支持的场景。
- CMakeLists.txt 则是跨平台、可扩展的现代构建工具,适合大型项目和需要跨平台支持的环境。通过 CMake,项目可以灵活适应不同平台和编译器,同时简化了依赖管理和项目配置。
对于现代复杂项目,特别是需要在多个平台上编译的项目,使用 CMake
通常会是一个更好的选择。
是否需要在执行 make
之后再执行 make install
,取决于项目的具体构建流程和目标。通常情况下,make
和 make install
扮演不同的角色:
1. make
make
命令的主要作用是根据Makefile
中定义的规则,编译源代码并生成目标文件(如.o
文件)和可执行文件。- 执行
make
后,项目的二进制文件会生成在当前目录下或指定的输出目录中,但它们通常还没有被安装到系统的标准目录中(如/usr/bin
、/usr/local/bin
等)。
2. make install
make install
的作用是将生成的可执行文件、库文件、配置文件等安装到系统的标准目录中,方便其他用户和系统全局使用。make install
通常会将文件复制到指定的安装路径,默认路径通常是/usr/local
,但这可以通过在运行configure
时指定--prefix
参数进行更改。- 一般情况下,
make install
会做以下事情:- 将可执行文件复制到
/usr/bin
或/usr/local/bin
等可执行路径。 - 将库文件复制到
/usr/lib
或/usr/local/lib
。 - 将头文件复制到
/usr/include
或/usr/local/include
。 - 安装配置文件到
/etc
或指定的配置文件目录。
- 将可执行文件复制到
3. 什么时候需要执行 make install
?
- 需要安装到系统中:
如果你希望把项目的可执行文件或库安装到系统的全局路径下,供其他用户或系统使用,或者希望能够在任意位置直接通过命令调用它们,通常需要执行make install
。 - 不需要全局安装:
如果你只是在本地开发或者调试代码,不需要全局安装,通常执行make
生成可执行文件后,直接在生成目录中使用这些文件即可,不需要执行make install
。
4. 如何判断是否需要执行 make install
- 检查
Makefile
或CMakeLists.txt
中是否有安装目标(如install
规则),或者查阅项目文档,通常会说明是否需要执行make install
。 - 对于库或工具包项目,通常建议执行
make install
,因为安装步骤会将库和头文件复制到系统路径下,方便其他项目引用。 - 对于独立的可执行程序,如果只在当前目录下运行,可能不需要
make install
。
5. 常见场景
- 本地开发:执行
make
后,直接在当前目录运行生成的可执行文件,不需要执行make install
。 - 系统安装:当需要把程序安装到系统目录,或者需要让多个用户或程序使用该程序或库时,通常需要执行
make install
。 - Docker、虚拟环境:在一些隔离环境中,如 Docker 或虚拟环境,可能并不需要执行
make install
,因为程序只需要在该环境内运行。
6. 安装路径自定义
- 默认情况下,
make install
会将文件安装到/usr/local
或其他系统默认路径。如果你希望自定义安装路径,可以在配置过程中通过--prefix
参数指定,例如:
然后执行./configure --prefix=/custom/install/path
make
和make install
,所有文件会安装到指定的路径中。
总结
- 执行
make
:生成项目的可执行文件或库文件。 - 执行
make install
:将生成的文件安装到系统的全局路径下(如/usr/local/bin
等)。
如果你只需要在本地运行程序,并不需要把程序安装到系统目录中,可以省略 make install
。但如果希望将项目安装到系统目录供全局使用,则需要执行 make install
。
./configure
是在编译许多开源项目时常用的一个命令,它用于生成适合当前系统的构建配置。该命令通常是 autotools
构建系统的一部分,特别是在基于 Makefile
的项目中。./configure
是一个脚本,通常由项目的开发者编写或通过工具生成,目的是根据当前系统的环境来准备项目的编译。
./configure
命令的作用
-
检测系统环境:
./configure
会检查你的系统是否满足编译该项目的所有依赖项和条件,比如编译器版本、库的路径、操作系统特性等。- 它可以自动检查系统上是否安装了所需的库(如 OpenSSL、zlib 等),并根据结果生成适合的
Makefile
。
-
配置编译选项:
- 根据系统的不同,
./configure
脚本会为编译器和链接器设置适当的选项,比如目标架构(32 位或 64 位)、调试模式或优化级别。 - 生成的配置文件(如
config.h
或Makefile
)会根据这些选项包含对应的编译指令和库路径。
- 根据系统的不同,
-
指定安装路径:
./configure
可以让用户指定安装路径。例如,使用--prefix
选项指定安装路径:
这样,编译完成后执行./configure --prefix=/custom/install/path
make install
时,文件会被安装到/custom/install/path
路径下,而不是系统的默认路径(如/usr/local
)。
-
启用或禁用特定功能:
./configure
允许用户根据需要启用或禁用项目的某些功能或模块。例如:
这种方式可以定制项目的功能,使其更适合特定的使用场景。./configure --enable-feature-x --disable-feature-y
./configure
常见选项
-
--prefix
:用于指定程序的安装目录。例如:./configure --prefix=/usr/local
这会将编译后的可执行文件安装到
/usr/local/bin
,库安装到/usr/local/lib
,头文件安装到/usr/local/include
。 -
--enable
和--disable
:启用或禁用特定的功能。例如:./configure --enable-debug ./configure --disable-shared
可以启用调试模式或禁用共享库的生成。
-
--with
和--without
:指定是否使用某个库或依赖。例如:./configure --with-openssl=/path/to/openssl ./configure --without-zlib
指定 OpenSSL 的安装路径,或不使用 zlib。
-
--help
:查看./configure
支持的所有选项。运行以下命令会列出所有可用的配置选项:./configure --help
./configure
的工作流程
- 检测环境:脚本检查你的操作系统、编译器和所需的库是否已经安装。
- 生成配置文件:根据检查的结果,生成特定于当前环境的配置文件,最常见的是
Makefile
,它包含了项目构建的具体规则。 - 后续步骤:
- 运行
make
:在./configure
生成的Makefile
基础上,使用make
命令进行编译。 - 运行
make install
:编译成功后,可以通过make install
将生成的文件复制到系统指定的位置。
- 运行
使用场景
./configure
通常用于那些需要跨平台编译的开源项目。在不同的平台上(Linux、macOS 等),项目的编译环境和依赖库可能各不相同。configure
脚本的作用就是自动根据系统的情况调整项目的编译配置,使项目可以在不同的系统上顺利编译和运行。
总结
./configure
是一个用于检测系统编译环境并生成构建配置的脚本,通常作为编译开源项目的第一步。- 它会根据系统的特定条件(如依赖库、编译器)生成适当的
Makefile
,然后通过make
进行编译。 - 通过选项,用户可以定制安装路径、启用/禁用功能、指定依赖库等,提供灵活的编译方式。
这使得 ./configure
在构建跨平台项目时非常有用。
编译和链接是生成可执行文件的关键过程。这两个步骤一起将源代码转换成一个可以在计算机上运行的可执行文件。下面详细解释这两个阶段:
1. 编译过程
编译是指将源代码(如 .c
或 .cpp
文件)转换成目标代码(.o
或 .obj
文件)的过程。这个过程分为多个子步骤:
-
预处理:处理代码中的预处理指令,如
#include
和#define
。预处理器会展开宏,包含头文件,并处理条件编译等。gcc -E main.c -o main.i # 生成预处理后的文件
-
编译:将预处理后的代码翻译成汇编代码。编译器会进行语法检查、优化和生成汇编代码。
gcc -S main.i -o main.s # 生成汇编代码文件
-
汇编:将汇编代码转换为机器代码,生成目标文件(
.o
或.obj
文件)。gcc -c main.s -o main.o # 生成目标文件
最终,编译生成的文件是一个目标文件(.o
),它包含了机器码,但不是一个可执行文件。
2. 链接过程
链接是将一个或多个目标文件和库文件合并,生成可执行文件的过程。链接器会处理符号解析、地址调整和库的引用。这个过程分为以下几部分:
-
符号解析:链接器会查找目标文件和库中定义的函数和变量,并将它们连接起来。如果有未定义的符号(例如某个函数未在目标文件中找到),链接器会报错。
-
地址调整:链接器会将每个目标文件中的代码和数据地址进行调整,使它们在内存中正确对齐,生成一个可以直接运行的可执行文件。
-
库链接:将目标文件与库文件进行链接。库可以是静态库(嵌入到可执行文件中)或动态库(在运行时加载)。
gcc main.o -o myprogram # 链接生成可执行文件
最终生成的是一个可执行文件,它可以直接在系统上运行。
3. 编译与链接的区别与联系
- 编译:是将源代码转换成目标代码的过程。目标文件包含了程序的一部分代码,但无法独立运行。
- 链接:是将多个目标文件和库合并,生成一个完整的可执行文件的过程。
在很多现代编译器(如 gcc
和 clang
)中,编译和链接可以一步完成:
gcc main.c -o myprogram
这条命令会先编译 main.c
为目标文件 main.o
,然后将它链接为可执行文件 myprogram
。
4. 编译和链接的输出文件
- 编译的输出:目标文件(
.o
或.obj
),它包含编译过的机器码,但不能单独运行。 - 链接的输出:可执行文件(在 Linux 上通常没有扩展名,在 Windows 上是
.exe
),可以直接在系统上运行。
5. 生成可执行文件的完整流程
源代码 (.c/.cpp) → 预处理 → 编译 → 汇编 → 目标文件 (.o) → 链接 → 可执行文件
6. 编译和链接的工具
- 编译器:例如
gcc
(GNU Compiler Collection)、clang
、msvc
(Microsoft Visual C++)。它负责将源代码转换为目标文件。 - 链接器:例如
ld
(GNU Linker),负责将目标文件和库文件链接为可执行文件。
总结
编译和链接的过程是生成可执行文件的必经之路。编译是将源代码转化为机器码的过程,生成目标文件;链接是将这些目标文件和必要的库组合成一个可执行的二进制文件。
标签:文件,make,知识,Makefile,C++,生成,编译,install From: https://www.cnblogs.com/chentiao/p/18509162