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