| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1 | Building a MacPython distribution |
| 2 | ================================= |
| 3 | |
| 4 | The ``build-install.py`` script creates MacPython distributions, including |
| 5 | sleepycat db4, sqlite3 and readline support. It builds a complete |
| 6 | framework-based Python out-of-tree, installs it in a funny place with |
| 7 | $DESTROOT, massages that installation to remove .pyc files and such, creates |
| 8 | an Installer package from the installation plus other files in ``resources`` |
| 9 | and ``scripts`` and placed that on a ``.dmg`` disk image. |
| 10 | |
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 11 | Prerequisites |
| 12 | ------------- |
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 13 | |
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 14 | * A MacOS X 10.4 (or later) |
| 15 | |
| 16 | * XCode 2.2 (or later), with the universal SDK |
| 17 | |
| 18 | * No Fink (in ``/sw``) or DarwinPorts (in ``/opt/local``), those could |
| 19 | interfere with the build. |
| 20 | |
| 21 | * The documentation for the release must be available on python.org |
| 22 | because it is included in the installer. |
| 23 | |
| 24 | |
| 25 | The Recipe |
| 26 | ---------- |
| 27 | |
| 28 | Here are the steps you need to follow to build a MacPython installer: |
| 29 | |
| 30 | * Run ``./build-installer.py``. Optionally you can pass a number of arguments |
| 31 | to specify locations of various files. Please see the top of |
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 32 | ``build-installer.py`` for its usage. |
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 33 | |
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 34 | Running this script takes some time, I will not only build Python itself |
| 35 | but also some 3th-party libraries that are needed for extensions. |
| 36 | |
| 37 | * When done the script will tell you where the DMG image is (by default |
| 38 | somewhere in ``/tmp/_py``). |
| 39 | |
| Ronald Oussoren | 1943f86 | 2009-03-30 19:39:14 +0000 | [diff] [blame] | 40 | Building a 4-way universal installer |
| 41 | .................................... |
| 42 | |
| 43 | It is also possible to build a 4-way universal installer that runs on |
| 44 | OSX Leopard or later:: |
| 45 | |
| 46 | $ ./build-installer.py --dep-target=10.5 --universal-archs=all --sdk=/ |
| 47 | |
| 48 | This requires that the deployment target is 10.5 (or later), and hence |
| 49 | also that your building on at least OSX 10.5. |
| 50 | |
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 51 | Testing |
| 52 | ------- |
| 53 | |
| 54 | The resulting binaries should work on MacOSX 10.3.9 or later. I usually run |
| 55 | the installer on a 10.3.9, a 10.4.x PPC and a 10.4.x Intel system and then |
| 56 | run the testsuite to make sure. |
| 57 | |
| 58 | |
| 59 | Announcements |
| 60 | ------------- |
| 61 | |
| 62 | (This is mostly of historic interest) |
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 63 | |
| 64 | When all is done, announcements can be posted to at least the following |
| 65 | places: |
| 66 | - pythonmac-sig@python.org |
| 67 | - python-dev@python.org |
| 68 | - python-announce@python.org |
| 69 | - archivist@info-mac.org |
| 70 | - adcnews@apple.com |
| 71 | - news@macnn.com |
| 72 | - http://www.macupdate.com |
| 73 | - http://guide.apple.com/usindex.lasso |
| 74 | - http://www.apple.com/downloads/macosx/submit |
| 75 | - http://www.versiontracker.com/ (userid Jack.Jansen@oratrix.com) |
| 76 | - http://www.macshareware.net (userid jackjansen) |
| 77 | |
| 78 | Also, check out Stephan Deibels http://pythonology.org/market contact list |