桌面应用打包:pyinstaller | 京东物流技术团队

京东云开发者
• 阅读 157

1 背景

在使用python开发一些小工具时,如果其他人电脑中没有python环境或者没有安装相应的第三方库,是没办法运行的,而要求对方安装又不现实,尤其是对方不是技术人员,因此如何将一个独立的python程序,使它成为成为一个不用考虑环境,双击即可运行的桌面应用呢?使用pyinstaller打包是一个不错的选择。

2 什么是pyinstaller

pyinstaller是一个支持跨平台使用的第三方库,它可以将脚本执行所需的模块和库,自动分析、收集并生成一个文件夹或者可执行文件。

桌面应用打包:pyinstaller | 京东物流技术团队

以下示例使用windows环境,由于pyinstaller的跨平台性,与类unix环境命令一样,只是最终生成的可执行文件不一样。

3 如何安装

安装pyinstaller模块与安装其他python模块一样,使用pip命令安装即可。
pip install pyinstaller
安装输出结果:

桌面应用打包:pyinstaller | 京东物流技术团队

其中的 altgraph、future等代表 PyInstaller 模块依赖环境。

4 如何使用

4.1 常用命令介绍

pyinstaller + 选项 + python入口源文件

主要选项包括:

  • -F 打包成一个exe文件(如果是多个py文件,下面有解决办法)
  • -D 自动创建一个包含桌面应用文件的目录,包括所有运行依赖文件(默认选项)
  • -w 指定程序运行时,不显示命令行窗口(仅对windows有效)
  • -i + ico路径 可以更换应用图标(如果是当前文件夹下,不用添加ico路径)
  • -d 产生debug版本的exe文件
  • -o 指定.spec文件生成目录,如果没有指定,将会在当前根目录下输出
  • -n 指定.spec文件名字,如果省略,主文件名将作为.spec的文件名字
  • -p 设置导入路径,可以使用路径分隔符(windows是分号,类unix是冒号)

4.2 常用方式举例

4.2.1 打包成单个文件

使用以下命令将会使python脚本,打包成为一个exe文件。
pyinstaller -F -w -i “./dian_128.ico” start_dian.py

其中:

  • -F 命令打包成单个文件
  • -w 无命令行窗口
  • -i 指定exe文件icon图标

执行成功后,将会在根目录生成两个文件夹,其中“build”文件中包含的是所有依赖文件,“dist”文件夹中存放着本次生成的exe文件。

桌面应用打包:pyinstaller | 京东物流技术团队

4.2.2 打包成文件夹

使用以下命令将会使python脚本,打包成为一个文件夹。
pyinstaller -D -w -i “./dian_128.ico” start_dian.py

其中:

  • -D 命令打包成一个文件夹
  • -w 无命令行窗口
  • -i 指定exe文件icon图标

命令行执行成功后,将会在dist目录下生成一个start_dian的子目录,该目录中包含了大量的.dll文件和.pyz文件,都是exe文件的支撑文件。

桌面应用打包:pyinstaller | 京东物流技术团队

4.3 使用.spec文件配置编译

上面讲解的都是通用版本,不太灵活,如果想要加入新的资源,或每次编译不想输入很长的命令,可以使用.spec文件,进行定制化配置编译。

4.3.1 生成.spec文件

使用上面的方式进行编译后,如未指定.spec生成目录,会在当前根目录生成一个与编译py文件同名的.spec文件;
或使用命令pyi-makespec -F start_dian.py,将会直接生成.spec文件;

桌面应用打包:pyinstaller | 京东物流技术团队

4.3.2 spec文件内容介绍

打开spec文件

桌面应用打包:pyinstaller | 京东物流技术团队

这里仅对涉及到的几个关键变量进行解释:

1.Analysis:

  • [‘start_dian.py’]:是主文件以及全部依赖文件,如果依赖文件都在同一目录下可以不写;
  • oathex:项目的绝对路径;
  • datas:添加资源文件,例如文件夹、图片、excel等等,以元组入参,第一个参数为原始路径,第二个参数为编译后的目标路径;

桌面应用打包:pyinstaller | 京东物流技术团队

2.EXE:

  • console:是否开启命令行,默认为True(开启);
  • icon:编译出exe可执行文件产物的图标,必须使用绝对路径;
  • name:EXE内和COLLECT内的name都是编译后的文件名,默认与编译主文件同名;

4.3.3 spec文件编译

配置好的spec文件,执行命令进行编译,不再需要其他参数:
pyinstaller start_dian.spec

桌面应用打包:pyinstaller | 京东物流技术团队

4.3.4 以下四种情况,修改spec文件比较好:

  1. 当您需要将资源文件与exe文件捆绑在一起时;
  2. 当您的依赖文件包括.dll或.so文件时;
  3. 当您运行exe需要运行参数时;
  4. 当您需要合并多程序包成为通用模块时;

5 常见问题

1.多文件如何打包

  • 在.spec文件中Analysis参数hiddenimports中添加导入模块名称,修改后,可再次进行打包,将会解决exe文件依赖包找不到的问题;
  • 在命令中使用-p 主文件 + -p 引入文件 …,可以直接生成exe文件。

2.exe文件过大

  • 安装python虚拟环境;
  • 导入包时,使用form + 包名 + import + 功能函数,不要直接import + 包名。

3.出现莫名其妙的错误

  • python文件所在的全路径,尽量不要有中文存在。

4.打包成一个文件夹后,发送给其他人无法使用

  • 需要将dist下面的文件夹整体发送,保持exe文件与dist下面文件夹的路径不变。

5.运行exe文件后,没有达到预期效果

  • 文件报错了,重新打包文件,使用控制台(去掉-w参数),将会在控制台显示程序运行过程与打印错误。

6.python脚本主要是命令行输出,但是程序执行完后就退出无法查看输出信息

  • 在python脚本最后一行添加命令:os.system(“pause”)或者raw_input(“输出任意按键即可退出”)。

作者:京东物流 骆铜磊

来源:京东云开发者社区 自猿其说Tech

点赞
收藏
评论区
推荐文章
菜鸟阿都 菜鸟阿都
2年前
将python文件打包成exe可运行文件
目前有好几种方法可以将python文件打包成exe应用程序文件,例如py2exe,pyinstaller等,比较下来,还是觉得pyinstaller使用起来比较简单。  首先第一步下载安装pyinstaller, 如果已经安装过python3的用户比较方便,可以使用python3文件下的Scripts文件中的pip安装,python2好像没有,使用pip
CuterCorley CuterCorley
3年前
Python小应用 百度接口实现图片文字识别,并打包成安装包软件
本文给大家分享的主题是用百度的接口实现图片的文字识别。1.环境和配置要求整体是用Python实现,所需要使用的第三方库包括aip、PIL、keyboard、pyinstaller,如未安装,可在CMD中使用pipinstallBaiduAIP/pillow/keyboard/pyinstaller指令安装。百度接口打开https://
Irene181 Irene181
2年前
Python编写的桌面图形程序,如何实现版本更新和下载?
在Python中我们有很多种方案来编写桌面图形用户界面程序,譬如内置的Tkinter、强大的PyQt5和PySide2,还有wxPython。借助这些或内置或第三方的模块,我们可以轻松地编写跨平台的桌面图形界面程序。同时,我们还能直接使用PyInstaller、Nuitka、cxFreeze等Python第三方程序打包模块,将编写好桌面图形界面程序打包为
Alonso095 Alonso095
3年前
Python的环境搭建和下载
Python是一个跨平台、可移植的编程语言,因此可在windows、Linux和MacOSX系统中安装使用。安装完成后,你会得到Python解释器环境,可以通过终端输入python命令查看本地是否已经按照python以及python版本。这里有一点需要注意的是,如果没有将python的安装目录添加到环境变量中,会报错(python不是内部命令或外部命
Stella981 Stella981
2年前
Python打包EXE文件
Python程序打包工具Python是一个脚本语言,被解释器解释执行。它的发布方式:.py文件:对于开源项目或者源码没那么重要的,直接提供源码,需要使用者自行安装Python并且安装依赖的各种库。(Python官方的各种安装包就是这样做的)。.pyc文件:有些公司或个人因为机密或者各种原因,不愿意源码被运行者看到,可以使用pyc文件发布,pyc文件是
Stella981 Stella981
2年前
Scapy 从入门到放弃
0x00前言最近闲的没事,抽空了解下地表最强的嗅探和收发包的工具:scapy。scapy是一个python模块,使用简单,并且能灵活地构造各种数据包,是进行网络安全审计的好帮手。0x01安装因为2020年python官方便不再支持python2,所以使用python3安装。!(https://oscimg.oschina.net/os
Stella981 Stella981
2年前
Python在window平台打包工具pyinstaller
!(https://oscimg.oschina.net/oscnet/1ab25a08f08541d2b6c406e3c7b168e1.png)Java一次编译到处运行,Python没有这么好本事,但是也有一个pyinstaller可以打包exe,在window平台下运行pyinstaller安装
Stella981 Stella981
2年前
Python3.x:打包为exe执行文件(window系统)
Python3.x:打包为exe执行文件(window系统)window系统下发布:一、安装pyinstaller(PyInstaller3.3.1)  cmd安装命令:pipinstallpyinstaller二、pyt
Python进阶者 Python进阶者
5个月前
如果我生成了exe,那我还需要安装py环境吗?需不需要留一个chromedrive啊?
大家好,我是皮皮。一、前言前几天在Python最强王者交流群【黑科技·鼓包】问了一个Python打包的问题,一起来看看吧。还有个问题想请教下,用pyinstaller生成的,如果我生成了exe,那我还需要安装py环境吗?需不需要留一个chromedrive
Python进阶者 Python进阶者
5个月前
盘点一个pyinstaller打包失败的问题
大家好,我是皮皮。一、前言前几天在Python白银交流群【JethroShen】问了一个mac机器下pyinstaller打包的问题,一起来看看吧。问题如下:群里有会使用pyinstaller的大佬吗?有个问题打包后正常运行程序也不报错但是就是不能生成想要