Ubuntu20.04 pycharm python打包制作DEB包详细步骤及雷区

记录一次Deb打包过程及踩雷警示

最近写了一个python的小程序,希望能打包成deb文件,便于将写好的软件安装 在其他没有安装工作环境的电脑上,把这安装deb后可以在应用列表和桌面看到。下面介绍一个python工程的打包过程, 分为两大步骤:

1、将工程打包生成一个可执行文件;
2、将可执行文件和工程依赖的所有文件制作成.deb安装包。

需要准备的

1、源代码(前提要可执行)或者编译好的程序,这里只介绍python
2、能用的ubuntu系统
3、用户的密码
4、图标(一定要有!)

这里给大家介绍一个案例,包名叫做debpacktest,整个过程中所有用到名字的地方,统统都是这个名字。xxx也指代这个名字。

一、 将工程打包生成一个可执行文件
1.在pycharm中安装pyinstaller
在这里插入图片描述

2.在工作代码区,鼠标右键调出terminal终端,输入命令pyinstaller -F -w main.py 点击回车,会看到成功提示(main.py 是主文件名)

备注:

pyinstaller -F main.py  打包ubuntu下的可执行文件
pyinstaller -F -w main.py  不带控制台的打包
pyinstaller -F -w -i Aplication.ico main.py  打包指定ubuntu下的可执行文件的图标打包

3.将工程里面除了.py文件(作用:保留源码)外的所有依赖文件(如数据文件)按原来在工程中的目录 拷贝到当前目录的/test/dist/test下,在其他工作目录下运行可执行文件(如/usr/test(绝对路径)),看是否可以执行,若不能运行,可能是以下原因:
(1)、路径中有汉字;
(2)、你的python程序中有路径不会随文件目录变化而变化;
(3)、依赖文件没有拷贝或拷贝不完整。

二、将可执行文件和工程依赖的所有文件制作成.deb安装包。

1.建立目录架构

程序是要放到一个系统中的各个部分去的。其实这个并没有那么严格,不一定全都要挤到/usr/lib里边去,放到/home等都没有太大的问题。这里你需要用一个文件夹模拟出linux的文件架构,只需要模拟你程序需要安放到的位置就行了。比如说我有可执行文件和工程依赖的所有文件,放到的文件夹是/usr/lib/debpacktest。那么我只需要建一个大文件夹(命名随意),cd到这个大文件夹,直接一个mkdir新建/usr /lib /debpacktest,然后把可执行文件和工程依赖的所有文件丢进debpacktest文件夹。下面罗列出来的是目录结构,多余出来的是需要手工添加的deb包配置文件(夹)。(share部分和DEBIAN部分)

├── debpackTotal
│   ├── DEBIAN(这个目录要添加control文件(无后缀名),可选添加postinst等)
│   └── usr
│       ├── lib
│       │   └── debpacktest(预定要安装到系统中的可执行文件和工程依赖的所有文件)
│       │       └── main等
│       └── share
│           ├── applications(在这里添加xxx.desktop,使应用中能够加载出你的应用)
│           └── icons(你的图标,这个必须有) **踩雷一**

在DEBIAN目录下制作control文件

cd到DEBIAN,在命令行输入(当然,你用gedit也行)

vim control

在其中粘贴:

Package: debpacktest
Version: 1.0.0
Architecture: amd64
Maintainer: gao
Description: just a test

Package:你的包名
Version:版本
Architecture:架构
Maintainer:维护者
Description:解释

括号后的内容 根据你自己的需要去改变
然后保存

2.在/usr/share/applications下制作桌面图标 debpacktest.desktop

这一步非常重要 关系到你能否在应用列表出现你自己的程序,清一定按照下面的步骤完成。
首先在/usr/share/applications/下新建debpacktest.desktop这个文件。
里面的内容是:

[Desktop Entry]
Name=debpacktest
Comment=An example
Exec=/usr/lib/debpacktest/main
Icon=/usr/share/icons/debpacktest.ico
Terminal=false
Type=Application
X-Ubuntu-Touch=true
Categories=Development

Name:你的包名

Comment:评论 注释

Exec:这里非常重要!这里如果不对 会直接导致这个图标没有办法显示。对于python来说,一定要具体到执行哪个可执行文件。这里执行的是main。不要忘记chmod +x 文件名,给main加上可执行权限(用pyinstaller打包生成都有可执行权限)。踩雷二

Icon:图标,不可以忽略 踩雷三

Terminal:是否在终端执行。这里是QtPy窗体,不需要。如果需要的话可以参考vim的desktop文件 踩雷四

X-Ubuntu-Touch这个暂时我也不知道是什么用的

Categories:分类。Categories可以取以下值,表示程序的启动快捷方式放在哪个菜单下:应用菜Application; Network放在 互联网 (Internet);办公 Office;图形 Graphics;声音和视AudioVideo; 系统工具 System;编程 Development; 附件Utility;影音 AudioVideo;游戏 Game;首 选项 Settings(GNOME;GTK;Settings;HardwareSettings;); 系统管理System。

剩下的东西 都不要动 都不要动
文件不能有多余的空格! 踩雷五
desktop文件要有可执行权限!

为一个文件添加可执行权限

chmod +x filename

3.打包

到这里,一个基本的deb软件包就大功告成了。
我们返回到debpackTotal的上级目录。我们执行

sudo dpkg -b debpackTotal debpacktest_1.0.0_amd64.deb

包的命名要符合规范,我这里是随便打的。
检验的话,可以输入(安装deb包)

sudo dpkg -i debpacktest_1.0.0_amd64.deb

在我的ubuntu机器上,运行很完美,我在应用列表里看到了我的程序。
如果要卸载,请执行

sudo dpkg -r debpacktest

注意 这里面的参数 是包名,并非包的文件名,就是一开始我让你们注意的那个全局命名。

关于postinst文件(即制作桌面图标)

cd到DEBIAN目录,新建postinst文件,没有后缀。这个文件是在安装完包以后执行的脚本
复制以下内容:

#!/bin/bash
sudo cp /usr/share/applications/debpacktest.desktop ~/桌面
echo POST INSTALLATION FUNCTION EXECUTED

这里是在包安装完成后,执行代码,将desktop文件复制到桌面。不同语言的发行版需要注意桌面的路径。踩雷六
postinst要有可执行权限。踩雷七

重新打包,安装,检验,发现桌面上多了个东东,是我们复制过去的文件,但并没有显示图标。
我们需要右击它,选择允许执行。你想要的结果便出现了。

总结:
以上就是简单制作一个基本的deb文件的全部步骤以及部分扩展。需要耐心。Enjoy it.

GLIBC问题:
这两天我在本公司服务器上(Linux)打包Python代码,然后拷贝到我自己的虚拟机上就无法执行,报错内容如下:

[3513] Error loading Python lib ‘/tmp/_MEIwj9Y1X/libpython3.6m.so.1.0’: dlopen: /lib64/libc.so.6: version `GLIBC_2.25’ not found (required by /tmp/_MEIwj9Y1X/libpython3.6m.so.1.0)

大体意思是:libpython3.6m.so.1.0这个依赖库需要依赖2.25版本或者以上的GLIBC。于是我在命令终端

ldd --version

查了一下我自己虚拟机的GLIBC和公司服务器上的GLIBC 发现我自己的虚拟机上是2.17版本,公司服务器上是2.27版本 于是原因就明白了

原因是:打包时的GLIBC是高版本,因此打包出来的可执行文件所依赖的也是高版本,所以在GLIBC低版本的 Linux系统中就无法执行

我的解决方法:在低版本GLIBC的系统上打包好,这样就都可以运行了

参考&引用:
https://my.oschina.net/u/4323266/blog/4537886
https://blog.csdn.net/yangjian131/article/details/78078853
https://blog.csdn.net/wangziyang777/article/details/107365606

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

皓月盈江

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值