CMake学习-- install 指令详细说明

Zy100Papa

已于 2025-04-02 16:03:55 修改

阅读量744

点赞数 18

分类专栏： cmake 文章标签： cmake

于 2025-04-02 15:35:06 首次发布

本文链接：https://blog.csdn.net/weixin_41761608/article/details/146948317

版权

cmake 专栏收录该内容

8 篇文章

订阅专栏

CMake中`install`命令的用法

背景知识

在软件开发过程中，构建和安装是两个重要的环节。构建是指将源代码编译成可执行文件或库文件，而安装则是将这些文件复制到指定的位置，以便在系统中使用。

从"手工打包"到"智能制造"

在早期的编程实践中，开发者完成代码编译后，常常需要手动将可执行文件、库文件和头文件复制到系统目录。就像中世纪的手工匠人，每次交付产品都要亲自打包，既容易出错又效率低下。想象一下：每次版本更新都要手动复制十几个文件到不同目录，还要考虑Linux、Windows不同系统的路径差异——这简直是开发者的噩梦。

CMake的install命令就像现代工厂的自动化流水线，它能精确地将编译产物分类打包，自动部署到指定位置。这个功能对于：

跨平台软件分发
软件包管理（deb/rpm）
第三方库的SDK制作
持续集成/持续部署(CI/CD)都至关重要。
据统计，使用规范的install规则可减少80%的部署错误，让开发者更专注于核心代码。

使用方法

项目结构


project/

├── CMakeLists.txt

├── include/

│   └── mylib/

│       └── mylib.h

├── src/

│   ├── mylib.cpp

│   └── main.cpp

└── build/

示例代码

mylib.h


#ifndef MYLIB_H

#define MYLIB_H



void printMessage();



#endif

mylib.cpp


#include <iostream>

#include "mylib.h"



void printMessage() {

    std::cout << "Hello from mylib!" << std::endl;
}

main.cpp


#include "mylib.h"



int main() {

    printMessage();
    return 0;
}

CMakeLists.txt


cmake_minimum_required(VERSION 3.10)

project(MyProject VERSION 1.0)



# 设置安装前缀

set(CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install")



# 添加库

add_library(mylib STATIC src/mylib.cpp)

target_include_directories(mylib PUBLIC include)



# 添加可执行文件

add_executable(myapp src/main.cpp)

target_link_libraries(myapp PRIVATE mylib)



# 安装库和头文件

install(TARGETS mylib

        ARCHIVE DESTINATION lib
        INCLUDES DESTINATION include)


# 安装可执行文件

install(TARGETS myapp

        DESTINATION bin)


# 安装额外的文件

install(FILES README.md

        DESTINATION share/doc/myproject)

构建和安装

在项目根目录下创建build文件夹并进入：


mkdir build

cd build

使用CMake生成构建文件并构建项目：


cmake ..

make

安装项目：


make install

详细介绍

安装库和头文件

使用install(TARGETS)命令安装库目标。
ARCHIVE DESTINATION lib指定静态库文件的安装位置为lib目录。
INCLUDES DESTINATION include指定头文件的安装位置为include目录。

安装可执行文件

使用install(TARGETS)命令安装可执行文件目标。
DESTINATION bin指定可执行文件的安装位置为bin目录。

安装额外的文件

使用install(FILES)命令安装额外的文件。
DESTINATION share/doc/myproject指定文件的安装位置为share/doc/myproject目录。

安装目录结构

安装完成后，install目录的结构如下：


install/

├── bin/

│   └── myapp

├── include/

│   └── mylib/

│       └── mylib.h

└── lib/

    └── libmylib.a

使用安装的库

在其他项目中使用安装的库时，可以通过find_package命令查找并链接库：


find_package(MyProject REQUIRED)

include_directories(${MyProject_INCLUDE_DIRS})

target_link_libraries(myapp ${MyProject_LIBRARIES})

总结

通过CMake的install命令，可以方便地定义安装规则，将构建的文件安装到指定的位置。这对于项目的部署和分发非常重要，因为它确保了软件可以在不同的系统环境中正确运行。在实际项目中，合理使用install命令可以提高项目的可维护性和可扩展性。

当你在终端输入make install时，CMake就像一位经验丰富的管家，将编译产物分门别类地安置在系统的各个角落。掌握这个看似简单的命令，就能让软件部署从繁琐的手工操作升级为优雅的自动化流程，这正是现代软件开发应有的模样。