0

0

c++如何利用cmake导出项目安装包_c++ CPack配置与可执行文件打包【指南】

冰火之心

冰火之心

发布时间:2026-01-06 18:21:09

|

169人浏览过

|

来源于php中文网

原创

cpack生成安装包前必须设置project_name和project_version,否则默认版本0.0.0导致包名不可用;需用install(targets...)显式声明可执行文件及依赖库;linux下需设cpack_generator为"tgz"以稳定生成.tar.gz;windows nsis需配置显示名、图标、许可证等且路径须用正斜杠。

c++如何利用cmake导出项目安装包_c++ cpack配置与可执行文件打包【指南】

CPack 生成安装包前必须设置 PROJECT_NAME 和 PROJECT_VERSION

CPack 不会自动读取 CMakeLists.txt 中的 project() 指令以外的信息,如果漏写或只写了 project(MyApp) 而没带版本,cpack 会默认用 0.0.0,导致生成的安装包名变成 MyApp-0.0.0-Linux.sh 这类不可用名称。

正确写法是:

project(MyApp VERSION 1.2.3 LANGUAGES CXX)

这样 CPack 才能从 CMAKE_PROJECT_VERSION 提取版本号。Windows 下若用 NSIS 生成 exe 安装包,还要求 PROJECT_NAME 不能含空格或特殊字符,否则 NSIS 编译失败并报错:Invalid character in output filename

可执行文件必须通过 install(TARGETS ...) 显式声明安装规则

仅靠 add_executable(myapp main.cpp) 不会让 CPack 打包它——CPack 只打包被 install() 命令明确指定的目标。

立即学习C++免费学习笔记(深入)”;

常见错误是只写:

add_executable(myapp main.cpp)
# 忘了 install() —— myapp 不会被包含进安装包

正确做法是补上:

install(TARGETS myapp
  RUNTIME DESTINATION bin
  COMPONENT runtime)

RUNTIME 表示这是 Windows 的 .exe 或 Linux/macOS 的可执行文件;DESTINATION bin 决定它在安装后路径(如 /usr/local/bin);COMPONENT runtime 是可选分组,方便后续用 cpack -C runtime 单独打包运行时部分。

MemFree
MemFree

MemFree - 来自知识库和互联网的混合AI搜索,更快获取准确答案

下载

如果你的程序依赖动态库,也要对 add_library(... SHARED) 目标加 install(TARGETS ... LIBRARY ...),否则安装后直接运行会报 libxxx.so: cannot open shared object file

Linux 下生成 tar.gz 需启用 PACKAGE_FORMAT 和设置 CPACK_GENERATOR

默认运行 cpack 只生成 tar.gz,但实际行为取决于 CMake 版本和系统环境:CMake 3.21+ 默认启用 TBZ2(.tar.bz2),老版本可能 fallback 到 TAR(无压缩)。想稳定输出 .tar.gz,必须显式设置:

set(CPACK_GENERATOR "TGZ")
set(CPACK_PACKAGE_FILE_NAME "${CMAKE_PROJECT_NAME}-${CMAKE_PROJECT_VERSION}-Linux")

注意:TGZ 是唯一对应 .tar.gz 的生成器名,别写成 TAR.GZGZIP——CPack 会静默忽略并退回到默认行为。

另外,CPACK_PACKAGE_EXECUTABLES 可用于标记哪些文件是“主程序”,让 Windows 安装器在桌面/开始菜单创建快捷方式,Linux 下虽不生效,但设了也没副作用:

set(CPACK_PACKAGE_EXECUTABLES "myapp" "My Application")

Windows NSIS 安装包需额外配置图标、许可证和安装路径

NSIS 是 CPack 在 Windows 上最常用的生成器,但默认生成的安装包非常简陋:无图标、无许可协议、默认装到 C:/Program Files/...(普通用户无权限),且卸载项里显示名字是 MyApp 而不是你期望的完整产品名。

关键配置项包括:

  • CPACK_NSIS_DISPLAY_NAME:控制控制面板“已安装程序”里显示的名字
  • CPACK_NSIS_PACKAGE_NAME:安装向导窗口标题栏文字
  • CPACK_RESOURCE_FILE_LICENSE:指向 LICENSE.txt 的绝对路径(必须存在,否则 NSIS 编译失败)
  • CPACK_NSIS_MUI_ICONCPACK_NSIS_MUI_UNIICON:分别指定安装/卸载界面图标(.ico 格式)
  • CPACK_NSIS_INSTALL_ROOT:推荐设为 C:/Program FilesC:/Program Files (x86),避免写死用户家目录

这些变量要在 project() 之后、include(CPack) 之前设置,否则无效。

CPack 对路径敏感,所有资源文件路径(如图标、许可证)必须用正斜杠 / 或双反斜杠 \,单反斜杠 会导致 NSIS 解析失败并中断构建。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1474

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1169

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

835

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

461

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2361

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

874

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

1948

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

1669

2023.08.30

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

4

2026.03.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.4万人学习

Git 教程
Git 教程

共21课时 | 4.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号