【譯】py2exe Tutorial

openspace

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

py2exe 入門(mén)指南

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

                                                                                                      Translated By: openspace
                                                                                                      Date              : 2009-10-14

    py2exe將Python程序轉(zhuǎn)變?yōu)榭梢栽谄渌鸚indows平臺(tái)上運(yùn)行的程序包，而這些機(jī)器上不需要安裝Python。在運(yùn)行py2exe的機(jī)器上需要安裝Python，因?yàn)閜y2exe是一個(gè)Python程序，而且它在構(gòu)建的程序包中會(huì)加入Python的部分組件。
    要掌握該入門(mén)指南，你需要知道Python的基礎(chǔ)知識(shí)（可以從python.org的頁(yè)面getting started獲取這些知識(shí)）。你還需要知道如何在命令行提示符下運(yùn)行Python程序（how to run Python programs from the command prompt）。
    要使用py2exe，在完成安裝之后需要按照一些簡(jiǎn)單的步驟來(lái)操作：
          1. 創(chuàng)建/測(cè)試你的程序
          2. 創(chuàng)建構(gòu)建腳本（setup.py）
          3. 運(yùn)行構(gòu)建腳本
          4. 測(cè)試可執(zhí)行程序
          5. 如果可行的話構(gòu)建安裝程序程序

創(chuàng)建/測(cè)試你的程序

    最難的一步往往是第一步。幸運(yùn)的是，py2exe通常對(duì)這一步幾乎沒(méi)有要求。用Python編寫(xiě)的大多數(shù)模塊都可以和py2exe一起工作。許多模塊可以不加修改地與py2exe一起工作，而一些第三方模塊則需要一些額外的工作。幸運(yùn)的是從WorkingWithVariousPackagesAndModules可以獲取幫助
    注意在使用py2exe之前必須確保程序可以工作。如果py2exe處理了一個(gè)損壞的程序，那么可能在py2exe中有bug需要修復(fù)。
    我們使用的第一個(gè)例子是我們的老朋友：

1.         1 print "Hello World!"

復(fù)制代碼

       hello.py
    我們要確保它可以工作：

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

復(fù)制代碼

       看起來(lái)不錯(cuò)！

創(chuàng)建setup腳本（setup.py）

    py2exe用一個(gè)新的“命令”擴(kuò)展了Distutils。如果你安裝過(guò)第三方Pythong模塊，那么你很可能至少見(jiàn)過(guò)一個(gè)distutils命令：

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

復(fù)制代碼

        “install”是一個(gè)用于安裝（Python模塊或者包）的Distutils命令。Distutils執(zhí)行安裝的細(xì)節(jié)信息保存在setup.py中（有時(shí)是在其他關(guān)聯(lián)文件中）。
    “py2exe”是一個(gè)在import py2exe之后添加的一個(gè)新的Distutils命令。要使用py2exe，需要?jiǎng)?chuàng)建一個(gè)setup.py文件來(lái)告訴Distutils和py2exe你想做什么。這里是一個(gè)setup.py實(shí)例，它很簡(jiǎn)單但對(duì)于示例程序夠用了：

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

復(fù)制代碼

       setup.py
    注意到這是普通的Python代碼。讓我們一行行地走：
        1. 使用py2exe時(shí)，我們要直接引用的Distutils部分是setup函數(shù)，所以我們只
    需要import它就可以了。
        2. 一旦加載了Distutils，我們需要加載py2exe以便可以添加它的命令。
        3. 空格有利于可讀性！
        4. 調(diào)用setup并告訴它我們需要一個(gè)單一的控制臺(tái)應(yīng)用程序，其主入口
    為“hello.py”。

運(yùn)行setup腳本

     接下來(lái)是運(yùn)行構(gòu)建腳本。傳遞給py2exe命令，會(huì)看到大量輸出：

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>
    

復(fù)制代碼

        運(yùn)行setup腳本時(shí)會(huì)創(chuàng)建兩個(gè)目錄：build和dist。build目錄用作程序打包時(shí)的工作區(qū)。setup腳本運(yùn)行完后可以安全的刪除build目錄。運(yùn)行應(yīng)用程序需要dist目錄中的文件。如果你正使用Python 2.4或者更新的版本，那么dist中會(huì)包含MSVCR71.dll文件 - 這是一個(gè)Microsoft動(dòng)態(tài)鏈接庫(kù)，你需要確定你是否有發(fā)布它的合法權(quán)限。
測(cè)試可執(zhí)行程序
    現(xiàn)在程序包已經(jīng)創(chuàng)建完畢，可以準(zhǔn)備測(cè)試了：

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

復(fù)制代碼

    好極了，它正常工作了！��！
    如果程序在你的機(jī)器上工作，但是在用戶的機(jī)器上不工作，那么用戶可能需要安裝Microsoft Visual C++ 2008可重新發(fā)布包�？梢詮奈④浀木W(wǎng)站website下載。這種現(xiàn)象通常發(fā)生在用戶沒(méi)有安裝Python的情況下。

如果可行的話構(gòu)建安裝程序

     py2exe不是一個(gè)安裝程序構(gòu)造器 - 它僅僅是將需要運(yùn)行Python程序的文件組裝起來(lái)。有許多非常好的安裝程序構(gòu)建器，有些是開(kāi)源的（例如NSIS），有些是免費(fèi)的（例如Inno Setup）。

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

smallfish_xy

感謝分享。加精。

litanhe

Thanks

bleem1998

“如果程序在你的機(jī)器上工作，但是在用戶的機(jī)器上不工作，那么用戶可能需要安裝Microsoft Visual C++ 2008可重新發(fā)布包�？梢詮奈④浀木W(wǎng)站website下載。這種現(xiàn)象通常發(fā)生在用戶沒(méi)有安裝Python的情況下�！�


能否掃下盲
‘可重新發(fā)布包’是什么東東？
怎樣確保打包的程序在每臺(tái)機(jī)器上都能運(yùn)行呢？

openspace

Microsoft Visual C++ 微軟發(fā)布了Microsoft Visual C++ 2008運(yùn)行庫(kù)的分發(fā)包，安裝該運(yùn)行庫(kù)后您的計(jì)算機(jī)將可以運(yùn)行Visual C++ 2008編寫(xiě)的程序，即使您并未安裝Visual Studio 2008。比起.NET運(yùn)行庫(kù)來(lái)講，C++的運(yùn)行庫(kù)要小得多，這次發(fā)布的版本大小為2-3M。
Visual C++ 2008運(yùn)行庫(kù)提供了C、標(biāo)準(zhǔn)C++、ATL、MFC、OpenMP以及MSDIA等類庫(kù)的運(yùn)行支持。在支持并行配件的操作系統(tǒng)上，支持并行部署模式的類庫(kù)(CRT, SCL, ATL, MFC, OpenMP)將會(huì)被安裝到WinSxS文件夾。

具體什么也不熟悉，個(gè)人理解是一些系統(tǒng)不自帶的庫(kù)組成的一個(gè)包
安裝它類似于添加新的庫(kù)

bleem1998

真麻煩
希望不要遇到這種情況就好

BTW
翻譯的很流暢
支持一個(gè)

windark

不要使用py2exe for python2.6的，2.6版本的需要安裝VC++2008可發(fā)行包，2.5版本的不需要。

就是因?yàn)檫@個(gè)原因，我將我機(jī)器的python版本降到2.5了。

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

bleem1998

我覺(jué)得應(yīng)該有其他解決辦法吧？
不然誰(shuí)還敢用VS2008啊
搞的跟.NET似的
VC寫(xiě)的程序還要裝運(yùn)行庫(kù)

gawk

支持，感謝

temgy1986

支持一下, 不錯(cuò)的教程