git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@42102 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
		
			
				
	
	
		
			713 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			713 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| <?xml version="1.0" encoding="iso-8859-1" ?>
 | |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 | |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 | |
| <head>
 | |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 | |
| <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
 | |
| <title>Building wxPython 2.7 for Development and Testing</title>
 | |
| <style type="text/css">
 | |
| 
 | |
| /*
 | |
| :Author: David Goodger
 | |
| :Contact: goodger@users.sourceforge.net
 | |
| :Date: $Date$
 | |
| :Revision: $Revision$
 | |
| :Copyright: This stylesheet has been placed in the public domain.
 | |
| 
 | |
| Default cascading style sheet for the HTML output of Docutils.
 | |
| 
 | |
| See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
 | |
| customize this style sheet.
 | |
| */
 | |
| 
 | |
| /* used to remove borders from tables and images */
 | |
| .borderless, table.borderless td, table.borderless th {
 | |
|   border: 0 }
 | |
| 
 | |
| table.borderless td, table.borderless th {
 | |
|   /* Override padding for "table.docutils td" with "! important".
 | |
|      The right padding separates the table cells. */
 | |
|   padding: 0 0.5em 0 0 ! important }
 | |
| 
 | |
| .first {
 | |
|   /* Override more specific margin styles with "! important". */
 | |
|   margin-top: 0 ! important }
 | |
| 
 | |
| .last, .with-subtitle {
 | |
|   margin-bottom: 0 ! important }
 | |
| 
 | |
| .hidden {
 | |
|   display: none }
 | |
| 
 | |
| a.toc-backref {
 | |
|   text-decoration: none ;
 | |
|   color: black }
 | |
| 
 | |
| blockquote.epigraph {
 | |
|   margin: 2em 5em ; }
 | |
| 
 | |
| dl.docutils dd {
 | |
|   margin-bottom: 0.5em }
 | |
| 
 | |
| /* Uncomment (and remove this text!) to get bold-faced definition list terms
 | |
| dl.docutils dt {
 | |
|   font-weight: bold }
 | |
| */
 | |
| 
 | |
| div.abstract {
 | |
|   margin: 2em 5em }
 | |
| 
 | |
| div.abstract p.topic-title {
 | |
|   font-weight: bold ;
 | |
|   text-align: center }
 | |
| 
 | |
| div.admonition, div.attention, div.caution, div.danger, div.error,
 | |
| div.hint, div.important, div.note, div.tip, div.warning {
 | |
|   margin: 2em ;
 | |
|   border: medium outset ;
 | |
|   padding: 1em }
 | |
| 
 | |
| div.admonition p.admonition-title, div.hint p.admonition-title,
 | |
| div.important p.admonition-title, div.note p.admonition-title,
 | |
| div.tip p.admonition-title {
 | |
|   font-weight: bold ;
 | |
|   font-family: sans-serif }
 | |
| 
 | |
| div.attention p.admonition-title, div.caution p.admonition-title,
 | |
| div.danger p.admonition-title, div.error p.admonition-title,
 | |
| div.warning p.admonition-title {
 | |
|   color: red ;
 | |
|   font-weight: bold ;
 | |
|   font-family: sans-serif }
 | |
| 
 | |
| /* Uncomment (and remove this text!) to get reduced vertical space in
 | |
|    compound paragraphs.
 | |
| div.compound .compound-first, div.compound .compound-middle {
 | |
|   margin-bottom: 0.5em }
 | |
| 
 | |
| div.compound .compound-last, div.compound .compound-middle {
 | |
|   margin-top: 0.5em }
 | |
| */
 | |
| 
 | |
| div.dedication {
 | |
|   margin: 2em 5em ;
 | |
|   text-align: center ;
 | |
|   font-style: italic }
 | |
| 
 | |
| div.dedication p.topic-title {
 | |
|   font-weight: bold ;
 | |
|   font-style: normal }
 | |
| 
 | |
| div.figure {
 | |
|   margin-left: 2em ;
 | |
|   margin-right: 2em }
 | |
| 
 | |
| div.footer, div.header {
 | |
|   clear: both;
 | |
|   font-size: smaller }
 | |
| 
 | |
| div.line-block {
 | |
|   display: block ;
 | |
|   margin-top: 1em ;
 | |
|   margin-bottom: 1em }
 | |
| 
 | |
| div.line-block div.line-block {
 | |
|   margin-top: 0 ;
 | |
|   margin-bottom: 0 ;
 | |
|   margin-left: 1.5em }
 | |
| 
 | |
| div.sidebar {
 | |
|   margin-left: 1em ;
 | |
|   border: medium outset ;
 | |
|   padding: 1em ;
 | |
|   background-color: #ffffee ;
 | |
|   width: 40% ;
 | |
|   float: right ;
 | |
|   clear: right }
 | |
| 
 | |
| div.sidebar p.rubric {
 | |
|   font-family: sans-serif ;
 | |
|   font-size: medium }
 | |
| 
 | |
| div.system-messages {
 | |
|   margin: 5em }
 | |
| 
 | |
| div.system-messages h1 {
 | |
|   color: red }
 | |
| 
 | |
| div.system-message {
 | |
|   border: medium outset ;
 | |
|   padding: 1em }
 | |
| 
 | |
| div.system-message p.system-message-title {
 | |
|   color: red ;
 | |
|   font-weight: bold }
 | |
| 
 | |
| div.topic {
 | |
|   margin: 2em }
 | |
| 
 | |
| h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
 | |
| h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
 | |
|   margin-top: 0.4em }
 | |
| 
 | |
| h1.title {
 | |
|   text-align: center }
 | |
| 
 | |
| h2.subtitle {
 | |
|   text-align: center }
 | |
| 
 | |
| hr.docutils {
 | |
|   width: 75% }
 | |
| 
 | |
| img.align-left {
 | |
|   clear: left }
 | |
| 
 | |
| img.align-right {
 | |
|   clear: right }
 | |
| 
 | |
| ol.simple, ul.simple {
 | |
|   margin-bottom: 1em }
 | |
| 
 | |
| ol.arabic {
 | |
|   list-style: decimal }
 | |
| 
 | |
| ol.loweralpha {
 | |
|   list-style: lower-alpha }
 | |
| 
 | |
| ol.upperalpha {
 | |
|   list-style: upper-alpha }
 | |
| 
 | |
| ol.lowerroman {
 | |
|   list-style: lower-roman }
 | |
| 
 | |
| ol.upperroman {
 | |
|   list-style: upper-roman }
 | |
| 
 | |
| p.attribution {
 | |
|   text-align: right ;
 | |
|   margin-left: 50% }
 | |
| 
 | |
| p.caption {
 | |
|   font-style: italic }
 | |
| 
 | |
| p.credits {
 | |
|   font-style: italic ;
 | |
|   font-size: smaller }
 | |
| 
 | |
| p.label {
 | |
|   white-space: nowrap }
 | |
| 
 | |
| p.rubric {
 | |
|   font-weight: bold ;
 | |
|   font-size: larger ;
 | |
|   color: maroon ;
 | |
|   text-align: center }
 | |
| 
 | |
| p.sidebar-title {
 | |
|   font-family: sans-serif ;
 | |
|   font-weight: bold ;
 | |
|   font-size: larger }
 | |
| 
 | |
| p.sidebar-subtitle {
 | |
|   font-family: sans-serif ;
 | |
|   font-weight: bold }
 | |
| 
 | |
| p.topic-title {
 | |
|   font-weight: bold }
 | |
| 
 | |
| pre.address {
 | |
|   margin-bottom: 0 ;
 | |
|   margin-top: 0 ;
 | |
|   font-family: serif ;
 | |
|   font-size: 100% }
 | |
| 
 | |
| pre.literal-block, pre.doctest-block {
 | |
|   margin-left: 2em ;
 | |
|   margin-right: 2em ;
 | |
|   background-color: #eeeeee }
 | |
| 
 | |
| span.classifier {
 | |
|   font-family: sans-serif ;
 | |
|   font-style: oblique }
 | |
| 
 | |
| span.classifier-delimiter {
 | |
|   font-family: sans-serif ;
 | |
|   font-weight: bold }
 | |
| 
 | |
| span.interpreted {
 | |
|   font-family: sans-serif }
 | |
| 
 | |
| span.option {
 | |
|   white-space: nowrap }
 | |
| 
 | |
| span.pre {
 | |
|   white-space: pre }
 | |
| 
 | |
| span.problematic {
 | |
|   color: red }
 | |
| 
 | |
| span.section-subtitle {
 | |
|   /* font-size relative to parent (h1..h6 element) */
 | |
|   font-size: 80% }
 | |
| 
 | |
| table.citation {
 | |
|   border-left: solid 1px gray;
 | |
|   margin-left: 1px }
 | |
| 
 | |
| table.docinfo {
 | |
|   margin: 2em 4em }
 | |
| 
 | |
| table.docutils {
 | |
|   margin-top: 0.5em ;
 | |
|   margin-bottom: 0.5em }
 | |
| 
 | |
| table.footnote {
 | |
|   border-left: solid 1px black;
 | |
|   margin-left: 1px }
 | |
| 
 | |
| table.docutils td, table.docutils th,
 | |
| table.docinfo td, table.docinfo th {
 | |
|   padding-left: 0.5em ;
 | |
|   padding-right: 0.5em ;
 | |
|   vertical-align: top }
 | |
| 
 | |
| table.docutils th.field-name, table.docinfo th.docinfo-name {
 | |
|   font-weight: bold ;
 | |
|   text-align: left ;
 | |
|   white-space: nowrap ;
 | |
|   padding-left: 0 }
 | |
| 
 | |
| h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
 | |
| h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
 | |
|   font-size: 100% }
 | |
| 
 | |
| tt.docutils {
 | |
|   background-color: #eeeeee }
 | |
| 
 | |
| ul.auto-toc {
 | |
|   list-style-type: none }
 | |
| 
 | |
| </style>
 | |
| </head>
 | |
| <body>
 | |
| <div class="document" id="building-wxpython-2-7-for-development-and-testing">
 | |
| <h1 class="title">Building wxPython 2.7 for Development and Testing</h1>
 | |
| <p>This file describes how I build wxWidgets and wxPython while doing
 | |
| development and testing, and is meant to help other people that want
 | |
| to do the same thing.  I'll assume that you are using either a CVS
 | |
| snapshot from <a class="reference" href="http://wxWidgets.org/snapshots/">http://wxWidgets.org/snapshots/</a>, a checkout from CVS, or
 | |
| one of the released wxPython-src-2.7.* tarballs.  I'll also assume that
 | |
| you know your way around your system, the compiler, etc. and most
 | |
| importantly, that you know what you are doing!  ;-)</p>
 | |
| <p>If you want to also install the version of wxPython you build to be in
 | |
| your site-packages dir and be your default version of wxPython, then a
 | |
| few additional steps are needed, and you may want to use slightly
 | |
| different options.  See the <a class="reference" href="INSTALL.html">INSTALL</a> document for more details.  If
 | |
| you only use the instructions in this <a class="reference" href="BUILD.html">BUILD</a> document file then you
 | |
| will end up with a separate installation of wxPython and you can
 | |
| switch back and forth between this and the release version that you
 | |
| may already have installed.</p>
 | |
| <p>If you want to make changes to any of the <tt class="docutils literal"><span class="pre">*.i</span></tt> files, (SWIG
 | |
| interface definition files,) or to regenerate the extension sources or
 | |
| renamer modules, then you will need an up to date version of SWIG,
 | |
| plus some patches.  Get the sources for version 1.3.29, and then apply
 | |
| the patches in wxPython/SWIG and then build SWIG like normal.  See the
 | |
| README.txt in the wxPython/SWIG dir for details about each patch and
 | |
| also info about those that may already have been applied to the SWIG
 | |
| sources.  If you install this build of SWIG to a location that is not
 | |
| on the PATH (so it doesn't interfere with an existing SWIG install for
 | |
| example) then you can use a setup.py command-line option named SWIG
 | |
| set to the full path name of the executable and the wxPython build will
 | |
| use it.  See below for an example.</p>
 | |
| <p>In the text below I'll use WXDIR with environment variable syntax
 | |
| (either $WXDIR or %WXDIR%) to refer to the top level directory where
 | |
| your wxWidgets and wxPython sources are located.  It will equate to
 | |
| whereever you checked out the wxWidgets module from CVS, or untarred
 | |
| the wxPython-src tarball to.  You can either substitute the $WXDIR text
 | |
| below with your actual dir, or set the value in the environment and
 | |
| use it just like you see it below.</p>
 | |
| <p>If you run into what appears to be compatibility issues between
 | |
| wxWidgets and wxPython while building wxPython, be sure you are using
 | |
| the wxWidgets sources included with the wxPython-src tarball or the
 | |
| CVS snapshot, and not a previously installed version or a version
 | |
| installed from one of the standard wxWidgets installers.  With the
 | |
| "unstable" releases (have a odd-numbered minor release value, where
 | |
| the APIs are allowed to change) there are often significant
 | |
| differences between the W.X.Y release of wxWidgets and the W.X.Y.Z
 | |
| release of wxPython.</p>
 | |
| <div class="section">
 | |
| <h1><a id="building-on-unix-like-systems-e-g-linux-and-os-x" name="building-on-unix-like-systems-e-g-linux-and-os-x">Building on Unix-like Systems (e.g. Linux and OS X)</a></h1>
 | |
| <p>These platforms are built almost the same way while in development
 | |
| so I'll combine the descriptions about their build process here.
 | |
| First we will build wxWidgets and install it to an out of the way
 | |
| place, then do the same for wxPython.</p>
 | |
| <ol class="arabic">
 | |
| <li><p class="first">Create a build directory in the main wxWidgets dir, and configure
 | |
| wxWidgets.  If you want to have multiple builds with different
 | |
| configure options, just use different subdirectories.  I normally
 | |
| put the configure command in a script named ".configure" in each
 | |
| build dir so I can easily blow away everything in the build dir and
 | |
| rerun the script without having to remember the options I used
 | |
| before:</p>
 | |
| <pre class="literal-block">
 | |
| cd $WXDIR
 | |
| mkdir bld
 | |
| cd bld
 | |
| ../configure --prefix=/opt/wx/2.7 \
 | |
|              --with-gtk \
 | |
|              --with-gnomeprint \
 | |
|              --with-opengl \
 | |
|              --enable-debug \
 | |
|              --enable-geometry \
 | |
|              --enable-graphics_ctx \
 | |
|              --enable-sound --with-sdl \
 | |
|              --enable-mediactrl \
 | |
|              --enable-display \
 | |
|              --disable-debugreport \
 | |
| </pre>
 | |
| <p>On OS X of course you'll want to use --with-mac instead of
 | |
| --with-gtk and --with-gnomeprint.</p>
 | |
| <p>Notice that above I used a prefix option of "/opt/wx/2.7".  You can
 | |
| use whatever path you want, such as a path in your HOME dir or even
 | |
| one of the standard prefix paths such as /usr or /usr/local if you
 | |
| like, but using /opt this way lets me easily have multiple versions
 | |
| and ports of wxWidgets "installed" and makes it easy to switch
 | |
| between them, without impacting any versions of wxWidgets that may
 | |
| have been installed via an RPM or whatever.  For the rest of the
 | |
| steps below be sure to also substitute "/opt/wx/2.7" with whatever
 | |
| prefix you choose for your build.</p>
 | |
| <p><strong>NOTE</strong>: Due to a recent change there is currently a dependency
 | |
| problem in the multilib builds of wxWidgets on OSX, so I have
 | |
| switched to using a monolithic build.  That means that all of the
 | |
| core wxWidgets code is placed in in one shared library instead of
 | |
| several.  wxPython can be used with either mode, so use whatever
 | |
| suits you on Linux and etc. but use monolithic on OSX.  To switch
 | |
| to the monolithic build of wxWidgets just add this configure flag:</p>
 | |
| <pre class="literal-block">
 | |
| --enable-monolithic \
 | |
| </pre>
 | |
| <p>By default GTK 2.x will be used for the build.  If you would rather
 | |
| use GTK 1.2.x for some reason then you can force configure to use
 | |
| it by changing the --with-gtk flag to specify it like this:</p>
 | |
| <pre class="literal-block">
 | |
| --with-gtk=1 \
 | |
| </pre>
 | |
| <p>To make the wxWidgets build be unicode enabled (strongly
 | |
| recommended unless you are building with GTK1) then add the
 | |
| following flag.  When wxPython is unicode enabled then all strings
 | |
| that are passed to wx functions and methods will first be converted
 | |
| to unicode objects, and any 'strings' returned from wx functions
 | |
| and methods will actually be unicode objects.:</p>
 | |
| <pre class="literal-block">
 | |
| --enable-unicode \
 | |
| </pre>
 | |
| <p>If you want to use the image and zlib libraries included with
 | |
| wxWidgets instead of those already installed on your system, (for
 | |
| example, to reduce dependencies on 3rd party libraries) then you
 | |
| can add these flags to the configure command:</p>
 | |
| <pre class="literal-block">
 | |
| --with-libjpeg=builtin \
 | |
| --with-libpng=builtin \
 | |
| --with-libtiff=builtin \
 | |
| --with-zlib=builtin \
 | |
| </pre>
 | |
| </li>
 | |
| <li><p class="first">To build and install wxWidgets you could just use the "make"
 | |
| command but there are a couple other libraries besides the main
 | |
| wxWidgets libs that also need to be built so again I make a script
 | |
| to do it all for me so I don't forget anything.  This time it is
 | |
| called ".make" (I use the leading "."  so when I do <tt class="docutils literal"><span class="pre">rm</span> <span class="pre">-r</span> <span class="pre">*</span></tt> in
 | |
| my build dir I don't lose my scripts too.)  This is what it looks
 | |
| like:</p>
 | |
| <pre class="literal-block">
 | |
| make $* \
 | |
|     && make -C contrib/src/gizmos $* \
 | |
|     && make -C contrib/src/stc $*
 | |
| </pre>
 | |
| <p>So you just use .make as if it where make, but don't forget to set
 | |
| the execute bit on .make first!:</p>
 | |
| <pre class="literal-block">
 | |
| .make
 | |
| .make install
 | |
| </pre>
 | |
| <p>When it's done you should have an installed set of files under
 | |
| /opt/wx/2.7 containing just wxWidgets.  Now to use this version of
 | |
| wxWidgets you just need to add /opt/wx/2.7/bin to the PATH and set
 | |
| LD_LIBRARY_PATH (or DYLD_LIBRARY_PATH on OS X) to /opt/wx/2.7/lib.</p>
 | |
| </li>
 | |
| <li><p class="first">I also have a script to help me build wxPython and it is checked in
 | |
| to the CVS as wxWidgets/wxPython/b, but you probably don't want to
 | |
| use it as it's very cryptic and expects that you want to run SWIG,
 | |
| so if you don't have the latest patched up version of SWIG then
 | |
| you'll probably get stuck.  So in this document I'll just give the
 | |
| raw commands instead.</p>
 | |
| <p>We're not going to install the development version of wxPython with
 | |
| these commands, so it won't impact your already installed version
 | |
| of the latest release.  You'll be able test with this version when
 | |
| you want to, and use the installed release version the rest of the
 | |
| time.  If you want to install the development version please read
 | |
| INSTALL.txt.</p>
 | |
| <p>If you have more than one version of Python on your system then be
 | |
| sure to use the version of Python that you want to use when running
 | |
| wxPython programs to run the setup.py commands below.  I'll be
 | |
| using python2.5.</p>
 | |
| <p>Make sure that the first wx-config found on the PATH is the one
 | |
| belonging to the wxWidgets that you installed above, and then
 | |
| change to the $WXDIR/wxPython dir and run the this command:</p>
 | |
| <pre class="literal-block">
 | |
| cd $WXDIR/wxPython
 | |
| python2.5 setup.py build_ext --inplace --debug
 | |
| </pre>
 | |
| <p>If your new wx-config script is not on the PATH, or there is some
 | |
| other version of it found first, then you can add this to the
 | |
| command line to ensure your new one is used instead:</p>
 | |
| <pre class="literal-block">
 | |
| WX_CONFIG=/opt/wx/2.7/bin/wx-config
 | |
| </pre>
 | |
| <p>By default setup.py will assume that you built wxWidgets to use
 | |
| GTK2.  If you built wxWidgets to use GTK 1.2.x then you should add
 | |
| this flag to the command-line:</p>
 | |
| <pre class="literal-block">
 | |
| WXPORT=gtk
 | |
| </pre>
 | |
| <p>Setup.py will assume by default that you are using a unicode build
 | |
| of wxWidgets.  If not then you can use this flag:</p>
 | |
| <pre class="literal-block">
 | |
| UNICODE=0
 | |
| </pre>
 | |
| <p>If you are wanting to have the source files regenerated with swig,
 | |
| (only neccessary if you make modifications to the <tt class="docutils literal"><span class="pre">*.i</span></tt> files,)
 | |
| then you need to turn on the USE_SWIG flag and optionally tell it
 | |
| where to find the new swig executable, so add these flags:</p>
 | |
| <pre class="literal-block">
 | |
| USE_SWIG=1 SWIG=/opt/swig/bin/swig
 | |
| </pre>
 | |
| <p>If you get errors about being unable to find libGLU, wxGLCanvas
 | |
| being undeclared, or something similar then you can add
 | |
| BUILD_GLCANVAS=0 to the setup.py command line to disable the
 | |
| building of the glcanvas module.</p>
 | |
| <p>When the setup.py command is done you should have a fully populated
 | |
| (but uninstalled) wx package located in your $WXDIR/wxPython/wx
 | |
| directory.</p>
 | |
| </li>
 | |
| <li><p class="first">To run code with the development version of wxPython, just set the
 | |
| PYTHONPATH to the wxPython dir located in the source tree.  For
 | |
| example:</p>
 | |
| <pre class="literal-block">
 | |
| export LD_LIBRARY_PATH=/opt/wx/2.7/lib
 | |
| export PYTHONPATH=$WXDIR/wxPython
 | |
| cd $WXDIR/wxPython/demo
 | |
| python2.5 demo.py
 | |
| </pre>
 | |
| <p>OS X NOTE: Depending on your version of OS X and Python you may
 | |
| need to use "pythonw" on the command line to run wxPython
 | |
| applications.  This version of the Python executable is part of the
 | |
| Python Framework and is allowed to interact with the display.  You
 | |
| can also double click on a .py or a .pyw file from the finder
 | |
| (assuming that the PythonLauncher app is associated with these file
 | |
| extensions) and it will launch the Framework version of Python for
 | |
| you.  For information about creating Applicaiton Bundles of your
 | |
| wxPython apps please see the wiki and the mail lists.</p>
 | |
| <p>SOLARIS NOTE: If you get unresolved symbol errors when importing
 | |
| wxPython and you are running on Solaris and building with gcc, then
 | |
| you may be able to work around the problem by uncommenting a bit of
 | |
| code in config.py and building again.  Look for 'SunOS' in config.py
 | |
| and uncomment the block containing it.  The problem is that Sun's ld
 | |
| does not automatically add libgcc to the link step.</p>
 | |
| </li>
 | |
| </ol>
 | |
| </div>
 | |
| <div class="section">
 | |
| <h1><a id="building-on-windows" name="building-on-windows">Building on Windows</a></h1>
 | |
| <p>The Windows builds currently require the use of Microsoft Visual C++.
 | |
| Theoretically, other compilers (such as mingw32 or the Borland
 | |
| compilers) can also be used but I've never done the work to make that
 | |
| happen.  If you want to try that then first you'll want to find out if
 | |
| there are any tricks that have to be done to make Python extension
 | |
| modules using that compiler, and then make a few changes to setup.py
 | |
| to accommodate that.  (And send the patches to me.)</p>
 | |
| <p>The standard Python 2.3 and earlier are built with MS Visual C 6.0 and
 | |
| so you must also build with MSVC 6 in order to be used with the stock
 | |
| python.exe.  If you woudl rather use a different version of
 | |
| VisualStudio keep in mind that you'll also have to build Python and
 | |
| any other extension modules that you use with that compiler because a
 | |
| different version of the C runtime library is used.  The stock Python
 | |
| 2.4 and 2.5 executables are built with MSVC 7.1, and the same rules
 | |
| apply to it.</p>
 | |
| <p>If you want to build a debuggable version of wxWidgets and wxPython you
 | |
| will need to have also built a debug version of Python and any other
 | |
| extension modules you need to use.  You can tell if you have them
 | |
| already if there is a _d in the file names, for example python_d.exe
 | |
| or python25_d.dll.  If you don't need to trace through the C/C++ parts
 | |
| of the code with the debugger then building the normal (or hybrid)
 | |
| version is fine, and you can use the regular python executables with
 | |
| it.</p>
 | |
| <p>Starting with 2.5.3.0 wxPython can be built for either the monlithic
 | |
| or the multi-lib wxWidgets builds.  (Monolithic means that all the
 | |
| core wxWidgets code is in one DLL, and multi-lib means that the core
 | |
| code is divided into multiple DLLs.)  To select which one to use
 | |
| specify the MONOLITHIC flag for both the wxWidgets build and the
 | |
| wxPython build as shown below, setting it to either 0 or 1.</p>
 | |
| <p>Just like the unix versions I also use some scripts to help me build
 | |
| wxWidgets, but I use some non-standard stuff to do it.  So if you have
 | |
| bash (cygwin or probably MSYS too) or 4NT plus unix-like cat and sed
 | |
| programs then there is a copy of my wxWidgets build scripts in
 | |
| %WXDIR%\wxPython\distrib\msw.  Just copy them to
 | |
| %WXDIR%\build\msw and you can use them to do your build, otherwise
 | |
| you can do everything by hand as described below.  But if you do work
 | |
| by hand and something doesn't seem to be working correctly please
 | |
| refer to the build scripts to see what may need to be done
 | |
| differently.</p>
 | |
| <p>The *.btm files are for 4NT and the others are for bash.  They are:</p>
 | |
| <pre class="literal-block">
 | |
| .make/.make.btm        Builds the main lib and the needed contribs
 | |
| .mymake/.mymake.btm    Builds just one lib, used by .make
 | |
| .makesetup.mk          A makefile that will copy and edit setup.h
 | |
|                        as needed for the different types of builds
 | |
| </pre>
 | |
| <p>Okay.  Here's what you've been waiting for, the instructions!  Adapt
 | |
| accordingly if you are using the bash shell.</p>
 | |
| <ol class="arabic">
 | |
| <li><p class="first">Set an environment variable to the root of the wxWidgets source
 | |
| tree.  This is used by the makefiles:</p>
 | |
| <pre class="literal-block">
 | |
| set WXWIN=%WXDIR%
 | |
| </pre>
 | |
| </li>
 | |
| <li><p class="first">Copy setup0.h to setup.h:</p>
 | |
| <pre class="literal-block">
 | |
| cd %WXDIR%\include\wx\msw
 | |
| copy setup0.h setup.h
 | |
| </pre>
 | |
| </li>
 | |
| <li><p class="first">Edit %WXDIR%\include\wx\msw\setup.h and change a few settings:</p>
 | |
| <pre class="literal-block">
 | |
| wxUSE_DEBUGREPORT              0
 | |
| wxUSE_EXCEPTIONS               0
 | |
| wxUSE_DIALUP_MANAGER           0
 | |
| wxUSE_GRAPHICS_CONTEXT         1
 | |
| wxUSE_GLCANVAS                 1
 | |
| wxUSE_POSTSCRIPT               1
 | |
| wxUSE_DIB_FOR_BITMAP           1
 | |
| </pre>
 | |
| <p>If you are using my build scripts then a few more settings will be
 | |
| changed automatically and then a copy of setup.h is placed in a
 | |
| subdir of %WXWIN%\libvc_dll.  If you are doing it by hand and
 | |
| making a UNICODE build, then also change these:</p>
 | |
| <pre class="literal-block">
 | |
| wxUSE_UNICODE                  1
 | |
| wxUSE_UNICODE_MSLU             1
 | |
| </pre>
 | |
| <p>If you are doing a "hybrid" build (which is the same as the
 | |
| binaries that I release) then also change these:</p>
 | |
| <pre class="literal-block">
 | |
| wxUSE_MEMORY_TRACING           0
 | |
| wxUSE_DEBUG_CONTEXT            0
 | |
| </pre>
 | |
| </li>
 | |
| <li><p class="first">Make sure that %WXDIR%\lib\vc_dll directory is on the PATH.  The
 | |
| wxWidgets DLLs will end up there as part of the build and so you'll
 | |
| need it on the PATH for them to be found at runtime.</p>
 | |
| </li>
 | |
| <li><p class="first">Change to the %WXDIR%\build\msw directory</p>
 | |
| <blockquote>
 | |
| <p>cd %WXDIR%\build\msw</p>
 | |
| </blockquote>
 | |
| </li>
 | |
| <li><p class="first">If using my scripts then use the .make.btm command to build
 | |
| wxWidgets.  It needs one command-line parameter which controls what
 | |
| kind of build(s) to do.  Use one of the following:</p>
 | |
| <pre class="literal-block">
 | |
| debug          Build debug version
 | |
| hybrid         Build hybrid version
 | |
| both           Both debug and hybrid
 | |
| debug-uni      Build a debug unicode library
 | |
| hybrid-uni     Hybrid unicode (see the pattern yet? ;-)
 | |
| both-uni       and finally both unicode libraries
 | |
| </pre>
 | |
| <p>For example:</p>
 | |
| <pre class="literal-block">
 | |
| .make hybrid
 | |
| </pre>
 | |
| <p>You can also pass additional command line parameters as needed and
 | |
| they will all be passed on to the nmake commands, for example to
 | |
| clean up the build:</p>
 | |
| <pre class="literal-block">
 | |
| .make hybrid clean
 | |
| </pre>
 | |
| <p>If <em>not</em> using my scripts then you can do it by hand by directly
 | |
| executing nmake with a bunch of extra command line parameters.
 | |
| The base set are:</p>
 | |
| <pre class="literal-block">
 | |
| nmake -f makefile.vc OFFICIAL_BUILD=1 SHARED=1 MONOLITHIC=0 USE_OPENGL=1 USE_GDIPLUS=1
 | |
| </pre>
 | |
| <p>If doing a debug build then add:</p>
 | |
| <pre class="literal-block">
 | |
| BUILD=debug
 | |
| </pre>
 | |
| <p>otherwise add these:</p>
 | |
| <pre class="literal-block">
 | |
| DEBUG_FLAG=1 CXXFLAGS=/D__NO_VC_CRTDBG__ WXDEBUGFLAG=h BUILD=release
 | |
| </pre>
 | |
| <p>If doing a Unicode build then add these flags:</p>
 | |
| <pre class="literal-block">
 | |
| UNICODE=1 MSLU=1
 | |
| </pre>
 | |
| <p>Now, from the %WXDIR%\build\msw directory run nmake with your
 | |
| selection of command-line flags as described above.</p>
 | |
| </li>
 | |
| <li><p class="first">When that is all done it will have built the main wxWidgets DLLs
 | |
| and also some of the contribs DLLs.  There should be a ton of DLLs
 | |
| and lots of lib files and other stuff in %WXDIR%\lib\vc_dll.</p>
 | |
| </li>
 | |
| <li><p class="first">Building wxPython on Windows is very similar to doing it for the
 | |
| unix systems.  We're not going to install the development version
 | |
| of wxPython with these commands, so it won't impact your already
 | |
| installed version of the latest release.  You'll be able to test
 | |
| with this version when you want to, and use the installed release
 | |
| version the rest of the time.  If you ever do want to install the
 | |
| development version please refer to INSTALL.txt.</p>
 | |
| <p>Change to the %WXDIR%\wxPython dir and run the this command,
 | |
| making sure that you use the version of python that you want to
 | |
| build for (if you have more than one on your system) and to match
 | |
| the MONOLITHIC flag with how you built wxWidgets:</p>
 | |
| <pre class="literal-block">
 | |
| cd %WXDIR%\wxPython
 | |
| python setup.py build_ext --inplace MONOLITHIC=0
 | |
| </pre>
 | |
| <p>If you are wanting to have the source files regenerated with swig,
 | |
| (only neccessary if you make modifications to the <tt class="docutils literal"><span class="pre">*.i</span></tt> files,)
 | |
| then you need to turn on the USE_SWIG flag and optionally tell it
 | |
| where to find the new swig executable, so add these flags:</p>
 | |
| <pre class="literal-block">
 | |
| USE_SWIG=1 SWIG=e:\\projects\\SWIG-1.2.29\\swig.exe
 | |
| </pre>
 | |
| <p>If you built a Unicode version of wxWidgets and want to also build
 | |
| the Unicode version of wxPython then add this flag:</p>
 | |
| <pre class="literal-block">
 | |
| UNICODE=1
 | |
| </pre>
 | |
| <p>If you have a debug version of Python and wxWidgets and want to
 | |
| build a debug version of wxPython too, add the --debug flag to the
 | |
| command line.  You should then end up with a set of <tt class="docutils literal"><span class="pre">*_d.pyd</span></tt>
 | |
| files in the wx package and you'll have to run <tt class="docutils literal"><span class="pre">python_d.exe</span></tt> to
 | |
| use them.  The debug and hybrid(release) versions can coexist.</p>
 | |
| <p>When the setup.py command is done you should have fully populated
 | |
| wxPython and wx packages locally in %WXDIR%/wxPython/wxPython and
 | |
| %WXDIR%/wxPython/wx, with all the extension modules (<tt class="docutils literal"><span class="pre">*.pyd</span></tt>
 | |
| files) located in the wx package.</p>
 | |
| </li>
 | |
| <li><p class="first">To run code with the development version of wxPython, just set the
 | |
| PYTHONPATH to the wxPython dir in the CVS tree.  For example:</p>
 | |
| <pre class="literal-block">
 | |
| set PYTHONPATH=%WXDIR%\wxPython
 | |
| cd %WXDIR\wxPython\demo
 | |
| python demo.py
 | |
| </pre>
 | |
| </li>
 | |
| </ol>
 | |
| </div>
 | |
| </div>
 | |
| </body>
 | |
| </html>
 |