【译】py2exe Tutorial

openspace

http://www.py2exe.org/index.cgi/Tutorial

py2exe 入门指南

原文：http://www.py2exe.org/index.cgi/Tutorial

                                                                                                      Translated By: openspace
                                                                                                      Date              : 2009-10-14

    py2exe将Python程序转变为可以在其他Windows平台上运行的程序包，而这些机器上不需要安装Python。在运行py2exe的机器上需要安装Python，因为py2exe是一个Python程序，而且它在构建的程序包中会加入Python的部分组件。
    要掌握该入门指南，你需要知道Python的基础知识（可以从python.org的页面getting started获取这些知识）。你还需要知道如何在命令行提示符下运行Python程序（how to run Python programs from the command prompt）。
    要使用py2exe，在完成安装之后需要按照一些简单的步骤来操作：
          1. 创建/测试你的程序
          2. 创建构建脚本（setup.py）
          3. 运行构建脚本
          4. 测试可执行程序
          5. 如果可行的话构建安装程序程序

创建/测试你的程序

    最难的一步往往是第一步。幸运的是，py2exe通常对这一步几乎没有要求。用Python编写的大多数模块都可以和py2exe一起工作。许多模块可以不加修改地与py2exe一起工作，而一些第三方模块则需要一些额外的工作。幸运的是从WorkingWithVariousPackagesAndModules可以获取帮助
    注意在使用py2exe之前必须确保程序可以工作。如果py2exe处理了一个损坏的程序，那么可能在py2exe中有bug需要修复。
    我们使用的第一个例子是我们的老朋友：

1.         1 print "Hello World!"

复制代码

       hello.py
    我们要确保它可以工作：

1. 
   
2.         C:\Tutorial>python hello.py
   
3.         Hello World!
   
4. 
   
5.         C:\Tutorial>
   

复制代码

       看起来不错！

创建setup脚本（setup.py）

    py2exe用一个新的“命令”扩展了Distutils。如果你安装过第三方Pythong模块，那么你很可能至少见过一个distutils命令：

1.         C:\Tutorial>python setup.py install

复制代码

        “install”是一个用于安装（Python模块或者包）的Distutils命令。Distutils执行安装的细节信息保存在setup.py中（有时是在其他关联文件中）。
    “py2exe”是一个在import py2exe之后添加的一个新的Distutils命令。要使用py2exe，需要创建一个setup.py文件来告诉Distutils和py2exe你想做什么。这里是一个setup.py实例，它很简单但对于示例程序够用了：

1. 
   
2.         1 from distutils.core import setup
   
3.         2 import py2exe
   
4.         3
   
5.         4 setup(console=['hello.py'])
   

复制代码

       setup.py
    注意到这是普通的Python代码。让我们一行行地走：
        1. 使用py2exe时，我们要直接引用的Distutils部分是setup函数，所以我们只
    需要import它就可以了。
        2. 一旦加载了Distutils，我们需要加载py2exe以便可以添加它的命令。
        3. 空格有利于可读性！
        4. 调用setup并告诉它我们需要一个单一的控制台应用程序，其主入口
    为“hello.py”。

运行setup脚本

     接下来是运行构建脚本。传递给py2exe命令，会看到大量输出：

1. 
   
2. C:\Tutorial>python setup.py py2exe
   
3. running py2exe
   
4. *** searching for required modules ***
   
5. *** parsing results ***
   
6. creating python loader for extension 'zlib'
   
7. creating python loader for extension 'unicodedata'
   
8. creating python loader for extension 'bz2'
   
9. *** finding dlls needed ***
   
10. *** create binaries ***
    
11. *** byte compile python files ***
    
12. byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\bz2.py to bz2.pyc
    
13. byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\unicodedata.py to unicodedata.pyc
    
14. byte-compiling C:\Tutorial\build\bdist.win32\winexe\temp\zlib.py to zlib.pyc
    
15. skipping byte-compilation of c:\Python24\lib\StringIO.py to StringIO.pyc
    
16. 
    
17. [skipping many lines for brevity]
    
18. 
    
19. skipping byte-compilation of c:\Python24\lib\warnings.py to warnings.pyc
    
20. *** copy extensions ***
    
21. *** copy dlls ***
    
22. copying c:\Python24\lib\site-packages\py2exe\run.exe -> C:\Tutorial\dist\hello.exe
    
23. 
    
24. *** binary dependencies ***
    
25. Your executable(s) also depend on these dlls which are not included,
    
26. you may or may not need to distribute them.
    
27. 
    
28. Make sure you have the license if you distribute any of them, and
    
29. make sure you don't distribute files belonging to the operating system.
    
30. 
    
31.    ADVAPI32.dll - C:\WINDOWS\system32\ADVAPI32.dll
    
32.    USER32.dll - C:\WINDOWS\system32\USER32.dll
    
33.    SHELL32.dll - C:\WINDOWS\system32\SHELL32.dll
    
34.    KERNEL32.dll - C:\WINDOWS\system32\KERNEL32.dll
    
35. 
    
36. C:\Tutorial>
    

复制代码

        运行setup脚本时会创建两个目录：build和dist。build目录用作程序打包时的工作区。setup脚本运行完后可以安全的删除build目录。运行应用程序需要dist目录中的文件。如果你正使用Python 2.4或者更新的版本，那么dist中会包含MSVCR71.dll文件 - 这是一个Microsoft动态链接库，你需要确定你是否有发布它的合法权限。
测试可执行程序
    现在程序包已经创建完毕，可以准备测试了：

1.         
   
2. C:\Tutorial>cd dist
   
3. 
   
4. C:\Tutorial\dist>hello.exe
   
5. Hello World

复制代码

    好极了，它正常工作了！！！
    如果程序在你的机器上工作，但是在用户的机器上不工作，那么用户可能需要安装Microsoft Visual C++ 2008可重新发布包。可以从微软的网站website下载。这种现象通常发生在用户没有安装Python的情况下。

如果可行的话构建安装程序

     py2exe不是一个安装程序构造器 - 它仅仅是将需要运行Python程序的文件组装起来。有许多非常好的安装程序构建器，有些是开源的（例如NSIS），有些是免费的（例如Inno Setup）。

[ 本帖最后由 openspace 于 2009-10-14 23:08 编辑 ]

smallfish_xy

感謝分享。加精。

litanhe

Thanks

bleem1998

“如果程序在你的机器上工作，但是在用户的机器上不工作，那么用户可能需要安装Microsoft Visual C++ 2008可重新发布包。可以从微软的网站website下载。这种现象通常发生在用户没有安装Python的情况下。”


能否扫下盲
‘可重新发布包’是什么东东？
怎样确保打包的程序在每台机器上都能运行呢？

openspace

Microsoft Visual C++ 微软发布了Microsoft Visual C++ 2008运行库的分发包，安装该运行库后您的计算机将可以运行Visual C++ 2008编写的程序，即使您并未安装Visual Studio 2008。比起.NET运行库来讲，C++的运行库要小得多，这次发布的版本大小为2-3M。
Visual C++ 2008运行库提供了C、标准C++、ATL、MFC、OpenMP以及MSDIA等类库的运行支持。在支持并行配件的操作系统上，支持并行部署模式的类库(CRT, SCL, ATL, MFC, OpenMP)将会被安装到WinSxS文件夹。

具体什么也不熟悉，个人理解是一些系统不自带的库组成的一个包
安装它类似于添加新的库

bleem1998

真麻烦
希望不要遇到这种情况就好

BTW
翻译的很流畅
支持一个

windark

不要使用py2exe for python2.6的，2.6版本的需要安装VC++2008可发行包，2.5版本的不需要。

就是因为这个原因，我将我机器的python版本降到2.5了。

http://blog.solrex.cn/articles/py2exe-for-python-26-sucks.html

bleem1998

我觉得应该有其他解决办法吧？
不然谁还敢用VS2008啊
搞的跟.NET似的
VC写的程序还要装运行库

gawk

支持，感谢

temgy1986

支持一下, 不错的教程