wxPython/BUILD.osx.txt

   1 Building wxPython on Mac OS X
   2 -----------------------------
   3
   4
   5 These are the steps I have used for building wxPython on Mac OS X 10.x
   6 with the Apple Developer Tools, a.k.a the Darwin version.  I assume
   7 that you know your way around a command line and that you know how to
   8 get things from various CVS repositories as needed.
   9
  10
  11 1. "MacPython-OSX" 2.3 is required.  If you don't have it already there is a disk image with an
  12    installer package at
  13
  14    http://homepages.cwi.nl/~jack/macpython/download.html
  15
  16    If, for some reason you need to build your own Python, get the
  17    source from www.python.org and follow the instructions in the
  18    Mac/OSX/README file to build and install the Python.framework and
  19    Python tools.
  20
  21    One last thing, make sure that /usr/local/bin is in your PATH
  22    environment variable since that is where the new python and pythonw
  23    commands will be located.
  24
  25
  26 2. In a wxWindows CVS tree make a build directory.  (You can also use
  27    a CVS snapshot located in http://wxwindows.org/snapshots/ or the
  28    released wxPythonSrc-*.tr.gz archive.)
  29
  30         cd ~/proj/wxWindows     # or wherever you put it
  31         mkdir build
  32
  33 3. Run configure from that build directory.
  34
  35         cd build
  36         ../configure --with-mac \
  37                      --with-opengl \
  38                      --enable-geometry \
  39                      --enable-optimise \
  40                      --with-libjpeg=builtin \
  41                      --with-libpng=builtin \
  42                      --with-libtiff=builtin \
  43
  44    If you want to add code that activates various runtime checks and
  45    assertion exceptions then add --enable-debug_flag.
  46
  47 4. Make and install wxMac.
  48
  49         make
  50         sudo make install
  51
  52 5. Build and install wxPython.
  53
  54         cd ../wxPython
  55         python setup.py build install
  56
  57    If you would like to install to someplace besides the Python
  58    site-packages directory (such as to your home directory) then you
  59    can add "--root=<path>" after the "install" command.  To use
  60    wxPython like this you'll need to ensure that the directory
  61    containing wxPyrthon is contained in in the PYTHONPATH environment
  62    variable.
  63
  64 6. Test.  Just navigate in the Finder to the demo directory and double
  65    click demo.py, or simple.py, or whatever you want to run.  Or from
  66    a command line you can run it this way:
  67
  68         cd demo
  69         pythonw demo.py
  70
  71 7. Figure out what's wrong, figure out how to fix it, and then send
  72    the patches to me.  <wink>
  73
  74 --Robin
  75
  76
  77
  78
  79
  80