py2exe用法举例与调试技巧

发布时间:2019-11-18编辑:脚本学堂
本文分享下python编程中py2exe的用法,以及py2exe的一些调试技巧,有需要的朋友参考下。

一、简介
py2exe是一个将python/ target=_blank class=infotextkey>python脚本转换成windows上的可独立执行的可执行程序(*.exe)的工具,这样,就可以不用装python而在windows系统上运行这个可执行程序。
py2exe已经被用于创建wxPython,Tkinter,Pmw,PyGTK,pygame,win32com client和server,和其它的独立程序。py2exe是发布在开源许可证下的。
 
二、安装py2exe
从http://prdownloads.sourceforge.net/py2exe 下载并运行与你所安装的Python对应的py2exe版本的installer,这将安装py2exe和相应的例子;这些例子被安装在libsite-packagespy2exesamples目录下。
 
三、py2exe的用法
如果有一个名为helloworld.py的python脚本,你想把它转换为运行在windows上的可执行程 序,并运行在没有安装python的 windows系统上,那么首先你应写一个用于发布程序的设置脚本例如mysetup.py,在其中的setup函数前插入语句 import py2exe 。

mysetup.py示例如下:
 

复制代码 代码示例:
from distutils.core import setup 
import py2exe 
 
setup(console=["helloworld.py"])  
 

 
如果显示错误提示的话 “ msvcp90.dll: no such file or directory”
 
请尝试下面的方法:
 

复制代码 代码示例:
from distutils.core import setup 
import py2exe 
 
setup( 
    console=["helloworld.py"], 
    options = { "py2exe": { "dll_excludes": ["MSVCP90.dll"] } } 

 

 
然后按下面的方法运行mysetup.py: (dos:  cmd => cd desktop => mysetup.py py2exe)
python mysetup.py py2exe

上面的命令执行后将产生一个名为dist的子目录,其中包含了helloworld.exe,python24.dll,library.zip这些文件。
如果你的helloworld.py脚本中用了已编译的C扩展模块,那么这些模块也会被拷贝在个子目录中,同样,所有的dll文件在运行时都是需要的,除了系统的dll文件。

dist子目录中的文件包含了你的程序所必须的东西,你应将这个子目录中的所有内容一起发布。
默认情况下,py2exe在目录dist下创建以下这些必须的文件:
1、一个或多个exe文件。
2、python##.dll。
3、几个.pyd文件,它们是已编译的扩展名,它们是exe文件所需要的;加上其它的.dll文件,这些.dll是.pyd所需要的。
4、一个library.zip文件,它包含了已编译的纯的python模块如.pyc或.pyo

上面的mysetup.py创建了一个控制台的helloword.exe程序,如果你要创建一个图形用户界的程序,那么你只需要将mysetup.py中的console=["helloworld.py"]替换为windows=["myscript.py"]既可。
 
py2exe一次能够创建多个exe文件,你需要将这些脚本文件的列表传递给console或windows的关键字参数。如果你有几个相关联的脚本,那么这是很有用的。

运行下面个命令,将显示py2exe命令的所有命令行标记。
python mysetup.py py2exe --help
 

Global options: 
  --verbose (-v)  run verbosely (default) 
  --quiet (-q)    run quietly (turns verbosity off) 
  --dry-run (-n)  don't actually do anything 
  --help (-h)     show detailed help message 
 
Options for 'py2exe' command: 
  --optimize (-O)       optimization level: -O1 for "python -O", -O2 for 
                        "python -OO", and -O0 to disable [default: -O0] 
  --dist-dir (-d)       directory to put final built distributions in (default 
                        is dist) 
  --excludes (-e)       comma-separated list of modules to exclude 
  --dll-excludes        comma-separated list of DLLs to exclude 
  --ignores             comma-separated list of modules to ignore if they are 
                        not found 
  --includes (-i)       comma-separated list of modules to include 
  --packages (-p)       comma-separated list of packages to include 
  --compressed (-c)     create a compressed zipfile 
  --xref (-x)           create and show a module cross reference 
  --bundle-files (-b)   bundle dlls in the zipfile or the exe. Valid levels 
                        are 1, 2, or 3 (default) 
  --skip-archive        do not place Python bytecode files in an archive, put 
                        them directly in the file system 
  --ascii (-a)          do not automatically include encodings and codecs 
  --custom-boot-script  Python file that will be run when setting up the 
                        runtime environment 
 
usage: setup_py2exe.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] 
   or: setup_py2exe.py --help [cmd1 cmd2 ...] 
   or: setup_py2exe.py --help-commands 
   or: setup_py2exe.py cmd --help 

四、指定额外的文件
一些应用程序在运行时需要额外的文件,诸如配置文件、字体、位图。
如果在安装脚本中用data_files可选项指定了那些额外的文件,那么py2exe能将这些文件拷贝到dist子目录中。data_files应包含一个元组(target-dir, files)列表,其中的files是这些额外的文件的列表。

例子:
 

复制代码 代码示例:
# mysetup.py
from distutils.core import setup 
import glob 
import py2exe 
 
setup(console=["helloworld.py"], 
      data_files=[("bitmaps", 
                   ["bm/large.gif", "bm/small.gif"]), 
                  ("fonts", 
                   glob.glob("fonts*.fnt"))], 
)  
 

 
说明:data_files选项将创建一个子目录distbitmaps,其中包含两个.gif文件;一个子目录distfonts,其中包含了所有的.fnt文件。

五、Windows NT services
 
你可以通过传递一个service关键字参数给setup函数来建造Windows NT services
,这个service参数的值必须是一个Python模块名(包含一service类)的列表。

示例:
 

复制代码 代码示例:
# mysetup.py
from distutils.core import setup 
import py2exe 
 
setup(service=["MyService"])  

所建造的可执行的service是可以通过在其后跟一定的命令行参数标记来自行安装和卸载的。
可以通过在这个可执行的service(exe)后跟一-help参数来得到更多的帮助。

六、COM servers
可以通过传递一个com_server 关键字参数给setup函数来建造Windows NT services
,这个service参数的值必须是一个Python模块名(包含一个或多个COM server 类)的列表。

示例:
 

复制代码 代码示例:
# mysetup.py
from distutils.core import setup 
import py2exe 
 
setup(com_server=["win32com.server.interp"])  
 

默认情况下,DLL和EXE servers被建造,你不需要它们的话你可以简单的删除它们。
一个标准的py2exe setup文件编写
 

复制代码 代码示例:
-*- coding: cp936 -*- 
from distutils.core import setup 
 
import py2exe 
 
includes = ["encodings", "encodings.*"]    
#要包含的其它库文件 
 
options = {"py2exe": 
 
    {"compressed": 1, #压缩 
     "optimize": 2, 
     "ascii": 1, 
     "includes":includes, 
     "bundle_files": 1 #所有文件打包成一个exe文件 } 
    } 
setup(     
    options = options,      
    zipfile=None,   #不生成library.zip文件 
    console=[{"script": "hello.py", "icon_resources": [(1, "hello.ico")] }]#源文件,程序图标 
    )  
 

新 版本已经可以打包为一个文件了,以前都是一堆dll,pyd的。具体的变化其实只有一个地方。就是options里增加bundle_files项,值为 1表示pyd和dll文件会被打包到exe文件中,且不能从文件系统中加载python模块;值为2表示pyd和dll文件会被打包到exe文件中,但是 可以从文件系统中加载python模块。另外setup中使用zipfile=None可以不生成library.zip。
 
例如,原来的代码:
 

复制代码 代码示例:
from distutils.core import setup  
import py2exe  
includes = ["encodings", "encodings.*"]  
options = {"py2exe":  
            {   "compressed": 1,  
                "optimize": 2,  
                "includes": includes,                  
            }  
          }  
setup(     
    version = "0.1.0",  
    description = "search panda",  
    name = "search panda",      
    options = options,      
    windows=[{"script": "search.py", "icon_resources": [(1, "search.ico")] }],        
    ) 
 

只需要改为:
 

复制代码 代码示例:
from distutils.core import setup  
import py2exe  
includes = ["encodings", "encodings.*"]  
options = {"py2exe":  
            {   "compressed": 1,  
                "optimize": 2,  
                "includes": includes,  
                "bundle_files": 1  
            }  
          }  
setup(     
    version = "0.1.0",  
    description = "search panda",  
    name = "search panda",  
    options = options,  
    zipfile=None,  
    windows=[{"script": "search.py", "icon_resources": [(1, "search.ico")] }],    
      
    )