PyInstaller 打包 python 脚本的一些心得

Cover image

![Pyinstaller][./images/pyinstaller.png]

因为在公司经常要帮同事做一个从excel表格中提取出需要的内容的重复工作,比较繁琐还容易出错;于是就想着要写个程序,但是同事又不可能在电脑上也装上python以及相关的包依赖(别人一看就觉得太麻烦而且太冗余),于是就想着将写好的python脚本打包成exe,直接双击使用,方便快捷。

说干就干,先是花点时间写完了脚本;然后搜索了相关的关键词,找到了py2exe、PyInstaller、cx_Freeze等工具,最后确定使用PyInstaller

使用PyInstaller有几个原因:

  • PyInstaller现在仍然在更新
  • PyInstaller使用方法简单,py2exe比较繁琐
  • PyInstaller网上教程比较多

安装PyInstaller

推荐使用pip安装

pip install pyinstaller -i https://pypi.douban.com/simple

后面加的-i https://pypi.douban.com/simple是使用豆瓣的源镜像,在天朝速度会快很多;如果你担心安全问题或者网速够快,可以不加,使用官方的源。

安装完后,直接

pyinstaller
usage: pyinstaller-script.py [-h] [-v] [-D] [-F] [--specpath DIR] [-n NAME]
                             [-p DIR] [--hidden-import MODULENAME]
                             [--additional-hooks-dir HOOKSPATH]
                             [--runtime-hook RUNTIME_HOOKS]
                             [--exclude-module EXCLUDES] [--key KEY] [-d] [-s]
                             [--noupx] [-c] [-w]
                             [-i <FILE.ico or FILE.exe,ID or FILE.icns>]
                             [--version-file FILE] [-m <FILE or XML>]
                             [-r RESOURCE] [--uac-admin] [--uac-uiaccess]
                             [--win-private-assemblies]
                             [--win-no-prefer-redirects]
                             [--osx-bundle-identifier BUNDLE_IDENTIFIER]
                             [--distpath DIR] [--workpath WORKPATH] [-y]
                             [--upx-dir UPX_DIR] [-a] [--clean]
                             [--log-level LEVEL] [--upx UPX]
                             scriptname [scriptname ...]
pyinstaller-script.py: error: the following arguments are required: scriptname

可以看到PyInstaller的信息,说明安装完成,可以使用了;详细帮助可以pyinstaller -h查看。

使用PyInstaller

PyInstaller的使用非常简单:

# 打包成一个文件
pyinstaller -F test.py
# 打包成文件夹(默认)
pyinstaller test.py

因为要精简到底,所以我选择打包成一个文件,打包完成后,打开dist文件夹,里面的那个exe文件就是打包好的程序,运行测试一下是否打包成功。

PyInstaller本身也是有很多选项的。这里挑几个主要的说明一下:

  • -D, --one-dir打包成一个文件夹,默认
  • -F, --one-file打包成一个exe文件
  • -p DIR, --paths DIR添加路径,一般用来添加程序所用到的包的所在位置
  • -c, --console, --nowindowed提供程序视窗,程序有输入输出的界面,默认
  • -w, --windowed, --noconsole无视窗,程序后台运行
  • -i <FILE.ico or FILE.exe,ID or FILE.icns>, --icon <FILE.ico or FILE.exe,ID or FILE.icns>添加icon图标

openpyxl的一个错误

程序打包之后一定要测试一下是否能成功运行,不然会在同事面前出糗,另外还需要用另一台电脑测试一下。

当我试着运行程序时,发生了报错:

Traceback (most recent call last):
  File "test.py", line 72, in <module>
  File "site-packages\pandas\core\frame.py", line 1414, in to_excel
  File "site-packages\pandas\io\excel.py", line 609, in __new__
  File "site-packages\pandas\io\excel.py", line 59, in get_writer
AttributeError: module 'openpyxl' has no attribute '__version__'
Failed to execute script test

于是就上网查找原因,一开始是去打包生成的build文件夹下面,查看一个名为warntest.txt的文件(这里是warn[yourscriptname].txt),发现有很多module都是miss,没有加载到。

missing module named 'win32com.gen_py' - imported by win32com, c:\python35\lib\site-packages\PyInstaller\loader\rthooks\pyi_rth_win32comgenpy.py
missing module named sys.exc_info - imported by sys, openpyxl.reader.excel, win32com.server.dispatcher
missing module named pywintypes.IIDType - imported by pywintypes, win32com.client.dynamic
missing module named win32com.client._get_good_object_ - imported by win32com.client, win32com.client.util
...

于是就想着会不会是包的路径没有加载,尝试着使用-p path去加载python下面储存package的目录,结果,重新打包一次仍然还是同样的报错。

于是我重新通过AttributeError: module 'openpyxl' has no attribute '__version__'去搜索结果,发现有人遇到同样的bug,原因是使用了Pandas,但是pyinstaller在pandas引用的‘openpyxl’包中,无法读取版本信息。(一般使用Python处理科学数据都会使用到Pandas,我是处理excel文件的脚本,当然会用到openpyxl来读写excel)

解决的办法是在PyInstaller的hook文件夹中添加‘openpyxl’的一个读取版本信息的hook。这个hook文件是在PyInstaller的Github issue上找到的。于是添加了这个hook,再重新打包,然后运行测试,终于成功了。

关于前面说到的warn[youscriptname].txt文件,有一种说法是如果你在其中没有找到你所用到的包,那么里面的错误信息一般可以忽略,anyway,我是直接忽略掉的。

添加版本信息

辛辛苦苦写了个程序,当然希望给程序签个名;PyInstaller是可以添加你自己的个人版本信息的,详细可以参考《Creating an Executable from a Python Script》,写的非常详细,依照相同的格式修改version.txt即可。但不知什么原因,我试了好几次都没有成功。如果以后找到原因,我再更新这篇文章。

关于32位和64位

这个算是后续剧情了。当把程序发给一位同事时,没想到同事的win系统是32位的,而我一直使用的都是64位的系统和64位的程序,而PyInstaller好像没有能选择生成32位/64位exe的选项;也算是PyInstaller的一个缺点吧。最后我是安装了32位的Python以及依赖的库重新生成32位的exe才解决这个问题;所以以后也许生成32位的程序兼容性更好。

Reference

◀ ANNOVAR (2): 关于注释数据库今天是万圣节 ▶