如何将带Bash脚本的Python GUI应用打包为Debian包适配Debian系Linux？

先解决PyInstaller跨版本依赖问题 #

你遇到的pythonlib3.8未找到错误，本质是PyInstaller会绑定编译环境（Ubuntu20）的Python 3.8依赖库，而Ubuntu18默认搭载Python3.6，系统中没有对应库文件。解决这个问题的核心是避免用PyInstaller单文件打包跨发行版应用，改用Debian包的原生方式处理依赖，或者在Ubuntu18环境下重新编译PyInstaller包。更推荐前者，因为完全符合Debian包的规范。

标准Debian包构建步骤 #

1. 创建基础包结构 #

假设你的项目名为mywebgui-app，先建立如下目录结构：

mywebgui-app/
├── debian/
│   ├── control
│   ├── install
│   ├── postinst
│   ├── prerm
│   └── rules
├── mywebgui/
│   ├── __init__.py
│   ├── main.py  # 你的Python GUI主程序
│   └── resources/  # 相关资源文件（如图标、配置）
├── setup.py  # Python包安装脚本
└── link-handler.sh  # 你的系统变量修改脚本

2. 编写Python setup.py #

这是让Debian系统正确识别并安装Python应用的关键，示例内容：

from setuptools import setup, find_packages

setup(
    name="mywebgui-app",
    version="1.0.0",
    packages=find_packages(),
    entry_points={
        'console_scripts': [
            'mywebgui = mywebgui.main:main',  # 定义命令行入口，直接启动GUI
        ]
    },
    install_requires=[
        # 列出你的Python依赖，比如PyQt5、requests等
        'PyQt5>=5.15',
        'requests>=2.25'
    ],
    include_package_data=True,
    package_data={
        'mywebgui': ['resources/*'],
    }
)

3. 配置Debian目录下的核心文件 #

debian/control

定义包的元信息和系统依赖：

Source: mywebgui-app
Section: utils
Priority: optional
Maintainer: Your Name <your.email@example.com>
Build-Depends: debhelper-compat (=12), python3-setuptools, python3-all
Standards-Version: 4.5.1
Homepage: https://your-project-url.com

Package: mywebgui-app
Architecture: all
Depends: ${python3:Depends}, ${misc:Depends}, python3-pyqt5, python3-requests
Description: Web-integrated Python GUI application
 A desktop GUI app that interacts with a web service,
 handles custom URL links via system configuration.

debian/install

指定需要安装的文件路径映射：

mywebgui/ usr/lib/python3/dist-packages/mywebgui/
link-handler.sh usr/share/mywebgui-app/

debian/postinst

安装后自动执行你的Bash脚本（修改系统变量、注册URL协议），记得给该文件添加执行权限：

#!/bin/sh
set -e

# 执行链接处理脚本
/usr/share/mywebgui-app/link-handler.sh

# 注册自定义URL协议（如果需要，比如mywebgui://）
desktop-file-install --dir=/usr/share/applications /usr/share/mywebgui-app/mywebgui.desktop

update-desktop-database /usr/share/applications/

exit 0

debian/prerm

卸载时清理相关配置：

#!/bin/sh
set -e

# 清理URL协议注册文件
rm -f /usr/share/applications/mywebgui.desktop
update-desktop-database /usr/share/applications/

exit 0

debian/rules

简化的构建规则：

#!/usr/bin/make -f

%:
	dh $@ --with python3

4. 构建并安装Debian包 #

在项目根目录执行以下命令：

# 安装构建依赖
sudo apt-get install devscripts debhelper python3-setuptools

# 构建包（-us -uc表示不签名）
debuild -us -uc

构建完成后，上级目录会生成.deb文件，直接在Ubuntu18/20上安装即可：

sudo dpkg -i ../mywebgui-app_1.0.0_all.deb

替代方案：坚持用PyInstaller的处理方式 #

如果一定要用PyInstaller打包，必须在Ubuntu18环境下编译，因为PyInstaller绑定的是编译系统的库。步骤：

1. 在Ubuntu18虚拟机/容器中通过deadsnakes源安装Python3.8
2. 安装PyInstaller和项目所有依赖
3. 执行pyinstaller --onefile mywebgui/main.py生成单文件
4. 把生成的可执行文件和Bash脚本放进Debian包的usr/bin或usr/share目录，通过debian/install指定安装路径

内容的提问来源于stack exchange，提问作者Mohamed Bahaa