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

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

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

1.         1 print "Hello World!"

復(fù)制代碼

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

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

復(fù)制代碼

       看起來不錯！

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

    py2exe用一個新的“命令”擴展了Distutils。如果你安裝過第三方Pythong模塊，那么你很可能至少見過一個distutils命令：

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

復(fù)制代碼

        “install”是一個用于安裝（Python模塊或者包）的Distutils命令。Distutils執(zhí)行安裝的細節(jié)信息保存在setup.py中（有時是在其他關(guān)聯(lián)文件中）。
    “py2exe”是一個在import py2exe之后添加的一個新的Distutils命令。要使用py2exe，需要創(chuàng)建一個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'])
   

復(fù)制代碼

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

運行setup腳本

     接下來是運行構(gòu)建腳本。傳遞給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>
    

復(fù)制代碼

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

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

復(fù)制代碼

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

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

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

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

smallfish_xy

感謝分享。加精。

litanhe

Thanks

bleem1998

“如果程序在你的機器上工作，但是在用戶的機器上不工作，那么用戶可能需要安裝Microsoft Visual C++ 2008可重新發(fā)布包。可以從微軟的網(wǎng)站website下載。這種現(xiàn)象通常發(fā)生在用戶沒有安裝Python的情況下�！�


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

openspace

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

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

bleem1998

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

BTW
翻譯的很流暢
支持一個

windark

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

就是因為這個原因，我將我機器的python版本降到2.5了。

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

bleem1998

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

gawk

支持，感謝

temgy1986

支持一下, 不錯的教程