记录一次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