Differences between revisions 15 and 16
Revision 15 as of 2010-05-28 08:10:05
Size: 12100
Editor: 226
Comment:
Revision 16 as of 2010-08-08 15:01:15
Size: 4766
Editor: 113
Comment:
Deletions are marked like this. Additions are marked like this.
Line 21: Line 21:
== Special Concerns == == Python 2.5 ==
Line 23: Line 23:
Python 2.5x
  * you will need the MS C run time dll 'msvcr71.dll', included with Python
  * the dll 'gdiplus.dll' might also be needed depending on what wxPython widgets you use
  * the appname.manifest file (needed to get the nice themed widgets on XP+) can be generated by checking the appropriate option in [[http://code.google.com/p/gui2exe/|Gui2Exe]]
The setup.py needed for Python 2.5 or lower is shown on [[py2exe-python25|the py2exe for Python 2.5 page]].
Line 28: Line 25:
== Python 2.6 ==
Line 29: Line 27:
Python 2.6x
  * you will need the MS C run time dll's (msvcr90.dll, msvcp90.dll, msvcm90.dll), included with Python (additional information provided below)
  * you will need a copy of the Microsoft.VC90.CRT.manifest file, additional information provided below
  * the dll 'gdiplus.dll' might also be needed depending on what wxPython widgets you use
  * do not check the manifest option in [[http://code.google.com/p/gui2exe/|Gui2Exe]], that caused a problem when I tried it and anyhow it should no longer be needed - so I need to verify this again.
  * I need to remove dist/UxTheme.dll in order having a correct look and feel under XP. It could be specific to my configuration (wxPython 2.8.10.1, python 2.6.4, xp SP3 FR)
  * With 2.6.5 I get an error "msvcp90.dll is not found", the work around is to change py2exe/build_exe.py and add this "excludes_use.append("msvcp90.dll")" around line 1056, or as an alternative you can add "msvcp90.dll" to the "dll_excludes" list.
The setup.py needed for Python 2.6 is shown on the page [[py2exe-python26|the py2exe for Python 2.6 page]].
Line 37: Line 29:

== The setup.py ==

Save the following code in your working folder as a file called 'setup.py'.

Note that I use "bundle=3" and use a "lib/library.zip" to reduce the number of files, I found that "bundle=1 or 2" does not always work. Actually with Py2.6 I could not get them to work at all. To deliver a single file to your end-users check out the InnoSetup page.

To "freeze" the application you run the following command from the command line in your working folder.

\python26\python setup.py py2exe

{{{
#!python

# ======================================================#
# File automagically generated by GUI2Exe version 0.3
# Andrea Gavana, 01 April 2007
# ======================================================#

# Let's start with some default (for me) imports...

from distutils.core import setup
import py2exe
import glob
import os
import zlib
import shutil

# Remove the build folder
shutil.rmtree("build", ignore_errors=True)

# do the save for dist folder
shutil.rmtree("dist", ignore_errors=True)

class Target(object):
    """ A simple class that holds information on our executable file. """
    def __init__(self, **kw):
        """ Default class constructor. Update as you need. """
        self.__dict__.update(kw)
        

# Ok, let's explain why I am doing that.
# Often, data_files, excludes and dll_excludes (but also resources)
# can be very long list of things, and this will clutter too much
# the setup call at the end of this file. So, I put all the big lists
# here and I wrap them using the textwrap module.

data_files = []

includes = []
excludes = ['_gtkagg', '_tkagg', 'bsddb', 'curses', 'email', 'pywin.debugger',
            'pywin.debugger.dbgcon', 'pywin.dialogs', 'tcl',
            'Tkconstants', 'Tkinter']
packages = []
dll_excludes = ['libgdk-win32-2.0-0.dll', 'libgobject-2.0-0.dll', 'tcl84.dll',
                'tk84.dll']
icon_resources = []
bitmap_resources = []
other_resources = []


# This is a place where the user custom code may go. You can do almost
# whatever you want, even modify the data_files, includes and friends
# here as long as they have the same variable name that the setup call
# below is expecting.

baseFolder, progFolder = os.path.split(os.getcwd())

#
# The following will copy the MSVC run time dll's
# (msvcm90.dll, msvcp90.dll and msvcr90.dll) and
# the Microsoft.VC90.CRT.manifest which I keep in the
# "Py26MSdlls" folder to the dist folder
#
# depending on wx widgets you use, you might need to add
# gdiplus.dll to the above collection

py26MSdll = glob.glob(r"c:\dev\Py26MSdlls\*.*")

# following works from Windows XP +
# if you need to deploy to older MS Win versions then I found that on Win2K
# it will also work if the files are put into the application folder without
# using a sub-folder.
data_files += [("Microsoft.VC90.CRT", py26MSdll),
               ("lib\Microsoft.VC90.CRT", py26MSdll),
              ]


# Ok, now we are going to build our target class.
# I chose this building strategy as it works perfectly for me :-D


GUI2Exe_Target_1 = Target(
    # what to build
    script = "simplewx.py",
    icon_resources = icon_resources,
    bitmap_resources = bitmap_resources,
    other_resources = other_resources,
    dest_base = "simplewx",
    version = "0.1",
    company_name = "No Company",
    copyright = "No Copyrights",
    name = "Py2Exe Sample File"
    )



# That's serious now: we have all (or almost all) the options py2exe
# supports. I put them all even if some of them are usually defaulted
# and not used. Some of them I didn't even know about.

setup(

    data_files = data_files,

    options = {"py2exe": {"compressed": 2,
                          "optimize": 2,
                          "includes": includes,
                          "excludes": excludes,
                          "packages": packages,
                          "dll_excludes": dll_excludes,
                          "bundle_files": 3,
                          "dist_dir": "dist",
                          "xref": False,
                          "skip_archive": False,
                          "ascii": False,
                          "custom_boot_script": '',
                         }
              },

    zipfile = "lib\library.zip",
    console = [],
    windows = [GUI2Exe_Target_1]
    )

# This is a place where any post-compile code may go.
# You can add as much code as you want, which can be used, for example,
# to clean up your folders or to do some particular post-compilation
# actions.

# And we are done. That's a setup script :-D

}}}

== The MS manifest ==

Following is the content of the Microsoft manifest file ("Microsoft.VC90.CRT.manifest"), note that the content of "version" and "publicKeyToken" are specific to the version of the dll files.

Installing Python 2.6 on Windows with the option "for this user only" this manifest file is created in the Python26 folder, note that the Py26 installer does not offer the "for this user only" option on Vista.

If you install Python 2.6 for all users then these files are found in "C:\Windows\winsxs", i.e. in "C:\Windows\winsxs\Manifests" you will find guess what the manifest and it would be called "x86_microsoft.vc90.crt_1fc8b3b9a1e18e3b_9.0.21022.8_none_bcb86ed6ac711f91.manifest" and then in "C:\Windows\winsxs\x86_microsoft.vc90.crt_1fc8b3b9a1e18e3b_9.0.21022.8_none_bcb86ed6ac711f91" you will find the dll's.

Note that the folder names contain the version number, so with Python 2.6.2 you should use version 9.0.21022.8 manifest and dll's.

{{{
#!xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- Copyright (c) Microsoft Corporation. All rights reserved. -->
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <noInheritable/>
    <assemblyIdentity
        type="win32"
        name="Microsoft.VC90.CRT"
        version="9.0.21022.8"
        processorArchitecture="x86"
        publicKeyToken="1fc8b3b9a1e18e3b"
    />
    <file name="msvcr90.dll" /> <file name="msvcp90.dll" /> <file name="msvcm90.dll" />
</assembly>
}}}

Using py2exe to freeze your application

The following will explain how to freeze a Python/wxPython application using the py2exe tool.

What Objects are Involved

You will need a working development environment including

* Python

* wxPython

* py2exe

* Gui2Exe - by Andrea Gavana

Process Overview

A small sample wxPython "Hello world" application will be used to demonstrate the process. I created the tiny application using Boa Constructor but you could use any other IDE you use for your wxPython development. I did the initial creation of the setup.py file with Gui2Exe and then keep maintaining it and running it from the IDE (Boa in my case).

Python 2.5

The setup.py needed for Python 2.5 or lower is shown on the py2exe for Python 2.5 page.

Python 2.6

The setup.py needed for Python 2.6 is shown on the page the py2exe for Python 2.6 page.

Sample wxPython application

Save the following code in your working folder as a file called 'simplewx.py'.

Toggle line numbers
   1 #Boa:Frame:Frame1
   2 
   3 import wx
   4 
   5 def create(parent):
   6     return Frame1(parent)
   7 
   8 [wxID_FRAME1, wxID_FRAME1BUTTON1, wxID_FRAME1BUTTON2, wxID_FRAME1PANEL1, 
   9  wxID_FRAME1STATICTEXT1, 
  10 ] = [wx.NewId() for _init_ctrls in range(5)]
  11 
  12 class Frame1(wx.Frame):
  13     def _init_coll_bsPanel_Items(self, parent):
  14         # generated method, don't edit
  15 
  16         parent.AddWindow(self.staticText1, 0, border=10,
  17               flag=wx.ALIGN_CENTER_VERTICAL | wx.ALIGN_CENTER_HORIZONTAL | wx.ALL | wx.EXPAND)
  18         parent.AddSizer(self.fgsButtons, 1, border=2, flag=wx.ALL | wx.EXPAND)
  19 
  20     def _init_coll_fgsButtons_Items(self, parent):
  21         # generated method, don't edit
  22 
  23         parent.AddWindow(self.button1, 1, border=2, flag=wx.ALL | wx.EXPAND)
  24         parent.AddWindow(self.button2, 1, border=2, flag=wx.ALL | wx.EXPAND)
  25 
  26     def _init_coll_bsFrame_Items(self, parent):
  27         # generated method, don't edit
  28 
  29         parent.AddWindow(self.panel1, 1, border=2,
  30               flag=wx.EXPAND | wx.ALL | wx.ALIGN_CENTER_VERTICAL | wx.ALIGN_CENTER_HORIZONTAL)
  31 
  32     def _init_coll_fgsButtons_Growables(self, parent):
  33         # generated method, don't edit
  34 
  35         parent.AddGrowableCol(0)
  36         parent.AddGrowableCol(1)
  37 
  38     def _init_sizers(self):
  39         # generated method, don't edit
  40         self.bsPanel = wx.BoxSizer(orient=wx.VERTICAL)
  41 
  42         self.bsFrame = wx.BoxSizer(orient=wx.VERTICAL)
  43 
  44         self.fgsButtons = wx.FlexGridSizer(cols=2, hgap=0, rows=0, vgap=0)
  45 
  46         self._init_coll_bsPanel_Items(self.bsPanel)
  47         self._init_coll_bsFrame_Items(self.bsFrame)
  48         self._init_coll_fgsButtons_Items(self.fgsButtons)
  49         self._init_coll_fgsButtons_Growables(self.fgsButtons)
  50 
  51         self.SetSizer(self.bsFrame)
  52         self.panel1.SetSizer(self.bsPanel)
  53 
  54     def _init_ctrls(self, prnt):
  55         # generated method, don't edit
  56         wx.Frame.__init__(self, id=wxID_FRAME1, name='', parent=prnt,
  57               pos=wx.Point(642, 279), size=wx.Size(236, 106),
  58               style=wx.DEFAULT_FRAME_STYLE, title='Frame1')
  59         self.SetClientSize(wx.Size(220, 70))
  60 
  61         self.panel1 = wx.Panel(id=wxID_FRAME1PANEL1, name='panel1', parent=self,
  62               pos=wx.Point(2, 2), size=wx.Size(216, 66),
  63               style=wx.TAB_TRAVERSAL)
  64 
  65         self.staticText1 = wx.StaticText(id=wxID_FRAME1STATICTEXT1,
  66               label=u'Hello world!', name='staticText1', parent=self.panel1,
  67               pos=wx.Point(10, 10), size=wx.Size(196, 13),
  68               style=wx.ALIGN_CENTRE)
  69 
  70         self.button1 = wx.Button(id=wxID_FRAME1BUTTON1, label='button1',
  71               name='button1', parent=self.panel1, pos=wx.Point(4, 37),
  72               size=wx.Size(100, 23), style=0)
  73 
  74         self.button2 = wx.Button(id=wxID_FRAME1BUTTON2, label='button2',
  75               name='button2', parent=self.panel1, pos=wx.Point(116, 37),
  76               size=wx.Size(100, 23), style=0)
  77 
  78         self._init_sizers()
  79 
  80     def __init__(self, parent):
  81         self._init_ctrls(parent)
  82         
  83 
  84 if __name__ == '__main__':
  85     app = wx.PySimpleApp()
  86     frame = create(None)
  87     frame.Show()
  88 
  89     app.MainLoop()

Other wiki pages to check

Comments

Please feel free to provide any feedback on this page either here, on the wxPython-user list or to werner.bruhin at free.fr.

py2exe (last edited 2010-08-21 18:54:09 by c-75-72-71-98)

NOTE: To edit pages in this wiki you must be a member of the TrustedEditorsGroup.