Linux 环境打包 QT 程序

目录

前言

一、安装Qt库和编译器

二、编译生成可执行文件

三、准备脚本

四、添加程序依赖库

五、添加 Qt 相关依赖库

六、发布 deb 安装包

参考文章

---

前言

Qt是一个跨平台的GUI框架，可以在多种操作系统上运行，包括Linux、Windows和macOS。因此，将Qt程序打包为Linux可执行文件可以确保在Linux系统上正确运行，而不受其他平台的影响。

在Linux系统中，软件包管理是一个重要的概念。通过打包Qt程序，可以将程序及其依赖项打包到一个文件中，方便在其他Linux系统上部署和运行。这样可以避免用户在安装程序时遇到缺少依赖项的问题，简化了部署流程。

打包Qt程序使其成为一个独立的可执行文件，方便发布和分发。用户可以通过简单地执行该文件来运行程序，而无需进行额外的设置或配置。

开发环境采用：Win 10 + WSL2 + Ubuntu 20.04 + GNOME桌面版

环境配置教程可以看我的上篇文章：

Windows配置Linux环境（Win 10 + WSL2 + Ubuntu 20.04 + GNOME桌面版）

---

一、安装Qt库和编译器

在Linux命令行上编译Qt程序之前，您需要先安装Qt库和编译器。您可以通过在终端中运行以下命令来安装Qt库和编译器：

sudo apt-get update
sudo apt-get install build-essential qt5-default qtcreator

如果项目需要网络通讯模块，需要下载依赖的库：

sudo apt-get install qtdeclarative5-dev qtpositioning5-dev qtwebengine5-dev libqt5webchannel5-dev qml-module-qtwebengine

需要串口通讯模块，下载依赖的库：

sudo apt-get install libqt5serialport5 libqt5serialport5-dev

二、编译生成可执行文件

准备好 qt 源码项目，qt 代码目录结构如下所示，一个简单的switch按钮项目。本教程采用命令行对 qt 源码编译生成可执行文件。也可以通过下载 qt creator 图形化界面进行 release 版本的发布。

SwitchButton.pro 如下所示：

#-------------------------------------------------
#
# Project created by QtCreator 2019-06-20T17:49:03
#
#-------------------------------------------------

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = SwitchButton
TEMPLATE = app


SOURCES += main.cpp\
        FrameSwitchButtons.cpp \
    SwitchButton.cpp

HEADERS  += FrameSwitchButtons.h \
    SwitchButton.h

FORMS    += FrameSwitchButtons.ui

Linux终端命令行使用 qmake 生成一些 makefile 文件 和 debug 和 release 文件夹。大家使用时替换自己项目的 .pro项目文件