Python 程序打包成 exe 可执行文件

 Python 程序打包工具
python

Python 是一个脚本语言,被解释器解释执行。它的发布方式:windows

.py 文件:对于开源项目或者源码没那么重要的,直接提供源码,须要使用者自行安装 Python 而且安装依赖的各类库。(Python 官方的各类安装包就是这样作的)。
.pyc 文件:有些公司或我的由于机密或者各类缘由,不肯意源码被运行者看到,可使用 pyc 文件发布,pyc 文件是 Python 解释器能够识别的二进制码,故发布后也是跨平台的,须要使用者安装相应版本的 Python 和依赖库。
可执行文件:对于非码农用户或者一些小白用户,你让他装个 Python 同时还要折腾一堆依赖库,那简直是个灾难。对于此类用户,最简单的方式就是提供一个可执行文件,只须要把用法告诉他便可。比较麻烦的是须要针对不一样平台须要打包不一样的可执行文件(Windows, Linux, Mac,…)。
.py 和.pyc 都比较简单,Python 自己就能够搞定。将 Python 脚本打包成可执行文件有多种方式。网络

PyInstaller

安装 pyinstaller

对于那些网络比较稳定,可以流畅使用 pip 源地址的用户,直接下面的命令就能够搞定:函数

pip install pyinstaller

 

一般咱们会下载源码包,而后进入包目录,执行下面的命令(须要安装 setuptools):工具

python setup.py install

 

安装完后,检查安装成功与否:字体

pyinstaller --version

 

安装成功后,就可使用下面的命令了:ui

pyinstaller : 打包可执行文件的主要命令,详细用法下面会介绍。
pyi-archive_viewer : 查看可执行包里面的文件列表。
pyi-bindepend : 查看可执行文件依赖的动态库(.so 或.dll 文件)
pyi-… : 等等。spa

使用 PyInstaller

        pyinstaller 的语法:pyinstaller [options] script [script…] | specfile操作系统

        最简单的用法,在和 myscript.py 同目录下执行命令:命令行

         pyinstaller mycript.py

         而后会看到新增长了两个目录 build 和 dist,dist 下面的文件就是能够发布的可执行文件,对于上面的命令你会发现 dist 目录下面有一堆文件,各类都动态库文件和 myscrip 可执行文件。有时这样感受比较麻烦,须要打包 dist 下面的全部东西才能发布,万一丢掉一个动态库就没法运行了,好在 pyInstaller 支持单文件模式,只须要执行:

        pyinstaller -F mycript.py

        你会发现 dist 下面只有一个可执行文件,这个单文件就能够发布了,能够运行在你正在使用的操做系统相似的系统的下面。固然,pyinstaller 还有各类选项,有通用选项,如 -d 选项用于 debug。

        在执行 pyInstaller 命令的时候,会在和脚本相同目录下,生成一个.spec 文件,该文件会告诉 pyinstaller 如何处理你的全部脚本,同时包含了命令选项。通常咱们不用去理会这个文件,若须要打包数据文件,或者给打包的二进制增长一些 Python 的运行时选项时…一些高级打包选项时,须要手动编辑.spec 文件。可使用:

        pyi-makespec optionsscript [script …]

        建立一个.spec 文件,对于手动编辑的.spec 文件,咱们可使用下面任意一条命令:

        pyinstaller specfile

        pyi-build specfile

PyInstaller 原理简介

        PyInstaller 其实就是把 python 解析器和你本身的脚本打包成一个可执行的文件,和编译成真正的机器码彻底是两回事,因此千万不要期望成打包成一个可执行文件会提升运行效率,相反可能会下降运行效率,好处就是在运行者的机器上不用安装 python 和你的脚本依赖的库。在 Linux 操做系统下,它主要用的 binutil 工具包里面的 ldd 和 objdump 命令。

        PyInstaller 输入你指定的的脚本,首先分析脚本所依赖的其余脚本,而后去查找,复制,把全部相关的脚本收集起来,包括 Python 解析器,而后把这些文件放在一个目录下,或者打包进一个可执行文件里面。

        能够直接发布输出的整个文件夹里面的文件,或者生成的可执行文件。你只须要告诉用户,你的应用 App 是自我包含的,不须要安装其余包,或某个版本的 Python,就能够直接运行了。

        须要注意的是,PyInstaller 打包的执行文件,只能在和打包机器系统一样的环境下。也就是说,不具有可移植性,若须要在不一样系统上运行,就必须针对该平台进行打包。

实践问题

        pyinstaller 打包后的 exe 运行怎么去掉弹出的命令行提示窗口?

        1. 若是使用.spec 文件的话, 在该文件中找到 console=True 修改成 console=False

        2. 若是是直接指定 python 文件进行 pyinstaller 打包的话,须要添加—noconsole

        pyinstaller path\mycode.py–noconsole

        若是想只打包成一个 exe:

        pyinstaller -F path\mycode.py –noconsole(注意:noconsole前面必须是两个  -  -,一个 - 不起做用

       或:

        pyinstaller -F -wpath\mycode.py

        更换最终 exe 生成路径

        在 cmd 中,一开始就要 cd D:\PythonEXE\ 切换到输出文件夹,而后在用上面的代码,说明:各个参数的做用,

        例子:pyinstaller -F -w -pD:\tmp\core-python\libs -i d:\tmp\main.ico main.py

        -F 表示生成单个可执行文件;

        -D  –onedir 建立一个目录,包含 exe 文件,但会依赖不少文件(默认选项)。

        -w 表示去掉控制台窗口,这在 GUI 界面时很是有用。不过若是是命令行程序的话那就把这个选项删除吧!;

        -c  –console, –nowindowed 使用控制台,无界面 (默认);

        -p 表示你本身自定义须要加载的类路径,通常状况下用不到;

        -i 表示可执行文件的图标。

py2exe

         (py2exe 彷佛只能支持 python3.3 和 pyhton3.4)

         py2exe 是一个将 python 脚本转换成 windows 上的可独立执行的可执行程序 (*.exe) 的工具,这样,你就能够不用装 python 而在 windows 系统上运行这个可执行程序。 

        py2exe 已经被用于建立 wxPython, Tkinter, Pmw, PyGTK, pygame,win32com client 和 server, 和其它的独立程序。py2exe 是发布在开源许可证下的。

py2exe 的用法 

        若是你有一个名为 myscript.py 的 python 脚本,你想把它转换为运行在 windows 上的可执行程序,并运行在没有安装 python 的 windows 系统上,那么首先你应写一个用于发布程序的设置脚本例如 mysetup.py,在其中的 setup 函数前插入语句 import py2exe 。 

mysetup.py 示例以下: 


# mysetup.py 

from distutils.core import setup 

import py2exe 

setup(console=["myscript.py"]) 

 

而后按下面的方法运行 mysetup.py: 

python mysetup.py py2exe 

        上面的命令执行后将产生一个名为 dist 的子目录,其中包含了 myscript.exe,python24.dll,library.zip 这些文件。

        若是你的 myscript.py 脚本中用了已编译的 C 扩展模块,那么这些模块也会被拷贝在个子目录中,一样,全部的 dll 文件在运行时都是须要的,除了系统的 dll 文件。dist 子目录中的文件包含了你的程序所必须的东西,你应将这个子目录中的全部内容一块儿发布。

        默认状况下,py2exe 在目录 dist 下建立如下这些必须的文件: 

        一、一个或多个 exe 文件。

        二、python##.dll。

        三、几个.pyd 文件,它们是已编译的扩展名,它们是 exe 文件所须要的;加上其它的.dll 文件,这些.dll 是.pyd 所须要的。 

        四、一个 library.zip 文件,它包含了已编译的纯的 python 模块如.pyc 或.pyo 上面的 mysetup.py 建立了一个控制台的 myscript.exe 程序,若是你要建立一个图形用户界的程序,那么你只须要将 mysetup.py 中的 console=[“myscript.py”] 替换为 windows=[“myscript.py”] 既可。 

        py2exe 一次可以建立多个 exe 文件,你须要将这些脚本文件的列表传递给 console 或 windows 的关键字参数。若是你有几个相关联的脚本,那么这是颇有用的。 

        运行下面个命令,将显示 py2exe 命令的全部命令行标记。 

        python mysetup.py py2exe–help 

指定额外的文件 
       一些应用程序在运行时须要额外的文件,诸如配置文件、字体、位图。 若是在安装脚本中用 data_files 可选项指定了那些额外的文件,那么 py2exe 能将这些文件拷贝到 dist 子目录中。data_files 应包含一个元组 (target-dir, files) 列表,其中的 files 是这些额外的文件的列表。 

示例以下: 


# mysetup.py

from distutils.core import setup

import glob

import py2exe 

 

setup(console=["myscript.py"], 

data_files=[("bitmaps", ["bm/large.gif","bm/small.gif"]), ("fonts", glob.glob("fonts\\*.fnt"))], ) 

 

说明:data_files 选项将建立一个子目录 dist\bitmaps,其中包含两个.gif 文件;一个子目录 dist\fonts,其中包含了全部的.fnt 文件。

 

Windows NTservices 
        你能够经过传递一个 service 关键字参数给 setup 函数来建造 Windows NT services , 这个 service 参数的值必须是一个 Python 模块名 (包含一 service 类) 的列表。 

示例以下: 


# mysetup.py

from distutils.core import setup

import py2exe

setup(service=["MyService"]) 

 

所建造的可执行的 service 是能够经过在其后跟必定的命令行参数标记来自行安装和卸载的。

附——pyinstaller打包参数说明: