wxPython/BUILD.osx.txt

   1 Building wxPython on Mac OS X
   2 -----------------------------
   3
   4 NOTE:  OS X support is HIGHLY EXPERIMENTAL at this time.  Most things
   5        are working now, but a few still don't.  I know about most of
   6        them and am addressing them as I have time.  If you have any
   7        ideas about a fix for the stuff that's still broken then
   8        please persue them and send the fixes to me.
   9
  10
  11 These are the steps I have used for building wxPython on Mac OS X 10.1
  12 with the Apple Developer Tools, a.k.a the Darwin version.  I assume
  13 that you know your way around a command line and that you know how to
  14 get things from various CVS repositories as needed.
  15
  16
  17 1. Python 2.2 is required.  There is a disk image with an installer
  18    package in the wxPython Sourceforge download area, in this group:
  19
  20    http://sourceforge.net/project/showfiles.php?group_id=10718&release_id=84730
  21
  22    If, for some reason you need to build your own Python, get the
  23    source from www.python.org and follow theinstructions in the
  24    Mac/OSX/README file to build and install Python.app and the
  25    Python.framework.
  26
  27    If you build your own Python then you may want to make a symlink or
  28    two in /usr/local/bin so that this version of Python can be found
  29    from the command line.  For example:
  30
  31         cd /usr/local/bin
  32         sudo ln -s /Library/Frameworks/Python.framework/Versions/2.2/bin/python2.2 python2.2
  33         sudo ln -s python2.2 python
  34
  35    Also, if you create a /usr/local/bin/pythonw script like the
  36    following then you can run Python GUI apps (like wxPython) directly
  37    from the command line:
  38
  39        #!/bin/sh
  40        exec /Applications/Python.app/Contents/MacOS/python $@
  41
  42    Be sure to give this script execute permissions:
  43
  44        sudo chmod +x /usr/local/bin/pythonw
  45
  46    If you would like to make a MachoPython installer from what you
  47    built then you may want to look at the scripts I use to do it
  48    located in wxPython/distrib/mac/buildPython.
  49
  50    One last thing, make sure that /usr/local/bin is in your PATH
  51    environment variable.
  52
  53
  54 2. In a wxWindows CVS tree make a build directory.
  55
  56         cd ~/proj/wxWindows     # or wherever you put it
  57         mkdir build
  58
  59 3. Run configure from that build directory.
  60
  61         cd build
  62         ../configure --with-mac --with-opengl --enable-debug
  63
  64 4. Make and install wxMac.
  65
  66         make
  67         sudo make install
  68
  69 5. Build and install wxPython.
  70
  71         cd ../wxPython
  72         python setup.py IN_CVS_TREE=1 build install
  73
  74 6. Test.  Just navigate in the Finder to the demo directory and double
  75    click demo.py, or simple.py, or whatever you want to run.  Or from
  76    a command line you can run it this way:
  77
  78         cd demo
  79         pythonw demo.py
  80
  81 7. Figure out what's wrong, figure out how to fix it, and then send
  82    the patches to me.  <wink>
  83
  84 --Robin
  85
  86
  87
  88
  89
  90