py2exe使用教程(一)——简单的示例

时间:2021-07-13 11:33:38

本文译自Py2exe官网 http://www.py2exe.org/


简介

py2exe 是 Python Distutils 的一个外部扩展,它可以把Python脚本转为可执行的Windows程序,无需安装Python即可运行。

你可以在官网得到更多资源。


说明

py2exe 可以把Python 程序转为包,能够在其他没有安装Python 的电脑上运行。运行py2exe 的电脑需要安装Python ,因为py2exe 是一个 Python 程序并且它创建的包中包含Python 的一部分。

为了更好的完成本教程,你需要了解一些Python 的基本知识(你可以从 python.org's getting started 页面开始)。你还需要知道 怎样从命令行提示符运行 Python 程序

安装完成后,在使用py2exe之前,你需要完成一下几个简单的步骤:

  1. 创建/测试 程序

  2. 创建setup 脚本文件 (setup.py)

  3. 运行setup 脚本

  4. 测试可执行程序

  5. 提供 Microsoft Visual C 运行时库

    • 5.1. Python 2.4 or 2.5

    • 5.2. Python 2.6, 2.7, 3.0, 3.1

      • 5.2.1. 创建C运行时库( C runtime DLL)

        • 5.2.1.1 win32ui 特例

      • 5.2.2. 运行这个可重新发行的 C 运行时安装程序

  6. 如果可以创建一个安装程序

1. 创建/测试程序

最重要的一步几乎总是第一步。好信息是 py2exe 通常在这一步很少或者几乎没有什么障碍。你处理Python 的绝大部分方法同样适用于 py2exe,Pyhton有很多模块是和 py2exe 无缝连接的。但是一些第三方模块需要额外花些时间,幸运的是这里有现成可用的帮助

 WorkingWithVariousPackagesAndModules

在你使用 py2exe 之前,确保每一件事都能正常工作是非常重要的。如果py2exe 安装一个破损的程序,那么很可能会出现一个BUG需要被修复!

在这里我们用的第一个示例是我们的老朋友...

print "Hello World!"

hello.py

我们需要确保他能正常工作...

C:\Tutorial>python hello.py
Hello World!

C:\Tutorial>

看起来不错!

2. 创建 setup 脚本文件 (setup.py)

py2exe 在 Distutils 的基础上扩展了一个新的 "命令"。如果你安装过 Python 的第三方模块,那么你一定至少见过一个 distutils 命令:

C:\Tutorial>python setup.py install

"install" 是 Distutils 的一个用来安装(通常是 Python 模块或者包)命令。Distutils 需要做的细节就包含在 setup.py 文件的设置中(有时候还有一些关联文件)。

"py2exe" 是一个新的 Distutils 命令, 当你导入 py2exe时就会加载进来。为了使用 py2exe ,你需要创建一个 setup.py 文件去告诉Distutils 和 py2exe 你想要做什么。

这是一个适用于我们示例的简单的 setup.py 文件...

from distutils.core import setup
import py2exe

setup(console=['hello.py'])

setup.py

请注意:这是普通的 Python 程序。让我们一行一行的解读...

  1. 在py2exe 下工作时,我们通常需要的 Distutils 的唯一部分就是 setup 函数,所以我们导入它。
  2. 一旦Distutils 加载完成,我们还需要加载 py2exe 以至于加载它的命令。
  3. 空一行总是好的!
  4. 调用 setup 告诉它我们想要一个单控制台应用程序,并且主入口是 "hello.py"。

3. 运行 setup 脚本

接下来就是运行 setup 脚本。确保给出 py2exe 命令并且,将会看到很多很多输出:

C:\Tutorial>python setup.py py2exe
running py2exe
*** searching for required modules ***
*** parsing results ***
creating python loader for extension 'zlib'
creating python loader for extension 'unicodedata'
creating python loader for extension 'bz2'
*** finding dlls needed ***
*** create binaries ***
*** byte compile python files ***
byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\bz2.py to bz2.pyc
byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\unicodedata.py to unicodedata.pyc
byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\zlib.py to zlib.pyc
skipping byte-compilation of c:\Python24\lib\StringIO.py to StringIO.pyc

[skipping many lines for brevity]

skipping byte-compilation of c:\Python24\lib\warnings.py to warnings.pyc
*** copy extensions ***
*** copy dlls ***
copying c:\Python24\lib\site-packages\py2exe\run.exe -> C:\Tutorial\dist\hello.exe

*** binary dependencies ***
Your executable(s) also depend on these dlls which are not included,
you may or may not need to distribute them.

Make sure you have the license if you distribute any of them, and
make sure you don't distribute files belonging to the operating system.

ADVAPI32.dll - C:\WINDOWS\system32\ADVAPI32.dll
USER32.dll - C:\WINDOWS\system32\USER32.dll
SHELL32.dll - C:\WINDOWS\system32\SHELL32.dll
KERNEL32.dll - C:\WINDOWS\system32\KERNEL32.dll

C:\Tutorial>

运行 setup 脚本的时候,会有两个文件目录将会被创建——build 和 dist。目录 build 被用做应用程序被打包时的工作空间,当setup 脚本运行完成后可以放心的删除。目录 dist 下的都是运行应用程序是必需的文件。

4. 测试可执行文件

现在包已经被创建好了,等待着我们来测试:

C:\Tutorial>cd dist

C:\Tutorial\dist>hello.exe
Hello World

太棒了, 一切正常!!!