冻结(freezing)您的代码¶
“冻结”您的代码是指创建单个可执行文件,以分发给包含所有程序代码以及Python解释器的终端用户。
像“Dropbox”、“星战前夜”、“文明4”和“BitTorrent 客户端”都是如此。
进行这种分发的好处是您的用户不需要安装好所要求版本的Python(或其他)就可以运行您的应用程序。 在Windows上,甚至许多Linux发行版和OS X,特定的Python版本并不总是安装好的。
此外,终端用户软件应始终是可执行的格式。 以 .py
结尾的文件适用于软件工程师和系统管理员。
冻结的一个缺点是它会增加大约2-12MB的发行大小。另外,如果修补了Python的安全漏洞, 您将负责分发更新版本的应用程序。
冻结的多种方式¶
打包您的代码 是指把您的库或工具分发给其他开发者。
在Linux 一个冻结的待选物是 创建一个Linux分发包 (比如,对于 Debian 或 Ubuntu 是 .deb文件,而对于 Red Hat 与 SuSE 是 .rpm 文件)
Todo
完善 “冻结您的代码” 部分(stub)。
比较冻结工具¶
各解决方案的平台/特性支持性
Solution | Windows | Linux | OS X | Python 3 | License | One-file mode | Zipfile import | Eggs | pkg_resources support |
---|---|---|---|---|---|---|---|---|---|
bbFreeze | yes | yes | yes | no | MIT | no | yes | yes | yes |
py2exe | yes | no | no | yes | MIT | yes | yes | no | no |
pyInstaller | yes | yes | yes | yes | GPL | yes | no | yes | no |
cx_Freeze | yes | yes | yes | yes | PSF | no | yes | yes | no |
py2app | no | no | yes | yes | MIT | no | yes | yes | yes |
Note
从Linux到Windows的冻结只有PyInstaller支持, 其余的。
Note
所有解决方案需要目前机器上安装了MS Visual C++ dll。除了py2app以外。
只有Pyinstaller创建了可以自足运行的exe文件,其绑定了dll,可以传递 --onefile
到
Configure.py
。
Windows¶
bbFreeze¶
前置要求是安装 Python, Setuptools 以及 pywin32 的依赖项。
Todo
补充更多简单的生成 .exe的步骤。
- 安装
bbfreeze
:
$ pip install bbfreeze
- 编写最基本的
bb_setup.py
from bbfreeze import Freezer
freezer = Freezer(distdir='dist')
freezer.addScript('foobar.py', gui_only=True)
freezer()
Note
这将适用于最基本的文件脚本。 要进行更高级的冻结,您必须提供包含和排除类似路径
freezer = Freezer(distdir='dist', includes=['my_code'], excludes=['docs'])
- (可选) 包含图标
freezer.setIcon('my_awesome_icon.ico')
4. 为冻结器(freezer)提供Microsoft Visual C运行时DLL。 将Microsoft Visual Studio 路径
附加您的 sys.path
中是可以的,但我发现在脚本所在同一文件夹中放 msvcp90.dll
则更加容易。
- 冻结!
$ python bb_setup.py
py2exe¶
前置要求是安装了 Python on Windows。py2exe 的最后一个版本是从2014年开始的,且没有处于积极的开发中。
- 下载并且安装 http://sourceforge.net/projects/py2exe/files/py2exe/
- 编写
setup.py
(配置选项清单):
from distutils.core import setup
import py2exe
setup(
windows=[{'script': 'foobar.py'}],
)
$ python setup.py py2exe
6.提供Microsoft Visual C 运行时DLL。两个选项: 在目标机器全局安装dll 或者 与.exe一起分发dll。
OS X¶
py2app¶
PyInstaller¶
PyInstaller可用于在Mac OS X 10.6(Snow Leopard)或更新版本上构建Unix可执行文件和 窗口应用程序。
要安装PyInstaller, 使用pip:
$ pip install pyinstaller
要创建标准的Unix可执行文件, 使用 script.py
:
$ pyinstaller script.py
这会创建,
script.spec
文件, 类似于make
文件build
文件夹, 存放日志文件dist
文件夹, 存放主要的可执行文件script
,和一些依赖的Python库
script.py
会把全部内容放在同一个文件夹中。PyInstaller将所有 script.py
用到的Python库放到 dist
文件夹中。所以在分发可执行文件时,会分发整个 dist
文件夹。
script.spec
文件可以编辑成 自定义构建 ,
比如可以:
- 将数据文件与可执行文件绑定在一起
- 包含PyInstaller无法自动推断的运行时库(
.dll
或.so
文件) - 将Python运行时选项添加到可执行文件中
现在:代码 script.spec
可以用 pyinstaller
(而不是再次使用
script.py
)运行。
$ pyinstaller script.spec
要创建独立的OS X窗口应用程序,请使用 --windowed
选项:
$ pyinstaller --windowed script.spec
这将在 dist
文件夹中创建一个代码 script.app
。请确保在Python代码中
使用GUI软件包,例如 PyQt 或
PySide,来控制应用程序的图形部分。
script.spec
有几个与Mac OS X应用程序捆绑有关的 选项 。
例如,要指定应用程序的图标,请使用 icon=\path\to\icon.icns
选项。