PyQT5 封装独立程序,优先推荐 pyinstaller,而非 py2app 或者 py2exe。事实上,PyInstaller 封装 Windows 端的 exe 文件也是不错的选择。
这是因为 py2app 等不会将程序环境(如 python 的 frameworks 等),因此并不会封装为一个独立的软件(standalone app),具体表现为仅能在本机正常运行,在别人的电脑上运行会报错。然而 pyinstaller 则封装完整,可在同系统的不同机器上运行。
封装步骤
首先安装工具包:
pip3 install pyinstaller
然后在 terminal 中依次键入:
pyinstaller --windowed --onefile --clean --noconfirm main.py
pyinstaller --clean --noconfirm --windowed --onefile main.spec
其中,如果要自行设计 Mac 系统下的图标的话,那么可以替换第 1 条指令为:
pyinstaller --windowed --onefile --icon=sat_tool_icon.icns --clean --noconfirm main.py
其中图片转换地址为 https://iconverticons.com/online/
而 windows 系统下的图片格式应为 .ico。
调测
一般而言,很少有同学能一次跑通,经常莫名其妙就闪退了或者报错,非常遗憾大家都得根据本机环境进行一些修改。
那么我们到底要调测哪些东西呢?从哪里看我们的报错呢?
STEP 1: 找到 exec 文件
对于 mac 系统来说,方法有两个(其实本质是一个):
- 大家双键单击 app 文件选择 show package contents,如下图找到你们的 exec 文件(文件名字是自己起的,主要看文件类型);
-
直接打开 exec 文件(文件名字是自己起的,主要看文件类型):
image.png
STEP2: 使用 exec 文件运行,并查看报错
image.png如上是正确时候的运行输出,但如果有错,这里会有具体的报错信息,每个人可能不同。对应不同的报错信息,大家可以直接复制黏贴到 google 或者 Bing 国际版中查看,建议优先查阅英文网页。
经历过的坑与解决方案
我来列举一下我们团队历经过的坑。
坑1:没选对当前 python 版本
大多数同学的电脑中都不止一个 python 版本,比如 mac 自己本身默认的是 python 2.7。
注意一定要选对 python 的版本,pyinstaller 一定要存在你当前 project 的 interpreter 对应的 python 版本下。
坑2:各工具包版本不适配
你可能有不同的包冲突、不适配,解决的方法也是类似的。
以我经历的坑为例,我电脑的 pandas 版本比较高,在使用 pyinstaller 时报错“Pandas missing pandas._libs.tslibs.timedeltas.so
”,导致在程序运行时终端总是报错。
解决的方法是:以 pandas 为例,手动增加 hook 文件,将 pandas 的 hiddenimports(即 Pandas missing pandas._libs.tslibs.timedeltas.so
) 写入。其实很简答的,具体如下:。
STEP 1
找到 pyinstaller 下 hook 文件所在地。鉴于我们使用了 pip3 下载 pyinstaller,我们可以通过 pip3 的相关指令具体方法为:
pip3 show pyinstaller
在我的本地机器中,我的 hooks 文件夹地址在于 /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/PyInstaller
STEP 2
在 hook 文件夹中手动增加 hook-pandas.py 文件,在文件中手动写入:hiddenimports = ["XXXX"],其中 XXX 是指你在运行 exec 文件中报错缺失的那个 module 的名字,对着抄写即可。
比如我的情况为写入:
hiddenimports = ['pandas._libs.tslibs.timedeltas']
网友评论