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>
 |