Windows下PyInstaller的使用教程

本博客与RayXXZhang的博客保持同步更新,转载请注明来自RayXXZhang的博客-Windows下PyInstaller的使用教程

直接使用Python开发的软件时有许多不方便的地方,如需要安装特定的Python环境,需要安装依赖库。为了便于部署,需要将Python源代码编译成可执行文件,编译后的可执行文件就能脱离python环境运行了。

安装

将py编译成可执行文件需要使用PyInstaller,需要注意,从百度搜索到的下载链接来自SourceForge,而PyInstaller的开发似乎已经转到Github上去了,因此从SourceForge上下载的版本不是最新的。

目前最新的PyInstaller版本是2.1,最方便的安装方式是通过pip使用如下命令安装:

pip install pyinstall

当然,也可以通过下载源代码编译方式安装:

python setup.py install

安装完成后,使用如下命令可以确认版本号:

pyinstaller --version

如果显示Error: Python 2.6+ on Windows support need pywin32,则说明当前没有安装pywin32,安装后即可正常运行PyInstaller。
安装pywin32时需要注意,pywin32的版本和本机Python位数和版本必须相同。

简单使用

最简单的使用方式是运行pyinstaller myscript.py来生成可执行文件,其中myscript.py是需要编译成可执行文件的源代码。
通过这种方式生成的可执行文件默认位于当前文件夹的dist目录下的myscript目录中,该目录下除了有exe文件外,还有若干个其他文件,这些文件都是运行时必须的。
编译完成后可以删除build文件夹,该文件夹存放的是编译过程中的生成的临时文件

如果希望编译出的exe文件不依赖其他文件,可以添加-F选项:

pyinstaller -F myscript.py

编译出的单独的exe文件在启动时速度上略慢于编译成文件夹方式。因为在执行单独的exe时会将资源先释放到临时文件夹中再执行。

常用选项

–distpath=path_to_executable

指定生成的可执行文件存放的目录,默认存放在dist目录下

–workpath=path_to_work_files

指定编译中临时文件存放的目录,默认存放在build目录下

–clean

清理编译时的临时文件

-F, –onefile

生成单独的exe文件而不是文件夹

-d, –debug

编译为debug模式,有助于运行中获取日志信息

–version-file=version_text_file

为exe文件添加版本信息,版本信息可以通过运行pyi-grab_version加上要获取版本信息的exe文件的路径来生成,生成后的版本信息文件可以按需求修改并作为--version-file的参数添加到要生成的exe文件中去

i , -i , –icon=, –icon=

为exe文件添加图标,可以指定图标路径或者从已存在的exe文件中抽取特定的ID的图标作为要生成的exe文件的图标

另外,还可以通过spec文件来生成可执行文件,运行pyi-makespec options script [script ...]可以生成spec文件,修改spec文件后执行:

pyinstaller specfile

或者

pyi-build specfile

就可以生成可执行文件了。

spec文件方式生成可执行文件提供了更多的定制选项,包括自定义python库的位置,要打包的其他文件路径等等。

更多

更多的使用选项及错误解决方法可以参照PyInstaller的官方帮助文档

你可能感兴趣的:(教程,python)