| 1 | Introduction |
|---|
| 2 | ------------ |
|---|
| 3 | |
|---|
| 4 | This is an alpha release of Gajim for OS/X using native GTK+. It is not finished |
|---|
| 5 | nor is it relatively stable. The native port of GTK+ is alpha and not stable |
|---|
| 6 | yet, though it has proven to be usable for Gajim. Having said that it is usable, |
|---|
| 7 | basic functionality works. See the TODO file for a list of what is and is not |
|---|
| 8 | working. |
|---|
| 9 | |
|---|
| 10 | |
|---|
| 11 | |
|---|
| 12 | Installing |
|---|
| 13 | ---------- |
|---|
| 14 | |
|---|
| 15 | Install the GTK+ framework into your /Library/Frameworks directory. It can be |
|---|
| 16 | found at http://codepunks.org/gajim. |
|---|
| 17 | NOTE: If you're able to make it work with official GTK release, we are VERY interested !! |
|---|
| 18 | |
|---|
| 19 | Copy the Gajim.app into the /Applications directory or any other directory. |
|---|
| 20 | |
|---|
| 21 | |
|---|
| 22 | Installing language dictionaries |
|---|
| 23 | -------------------------------- |
|---|
| 24 | |
|---|
| 25 | The codepunks.org build of the GTK+ framework comes with the US English |
|---|
| 26 | dictionary pre-installed. If you wish to install a different dictionary download |
|---|
| 27 | the appropriate dictionary from here: |
|---|
| 28 | |
|---|
| 29 | http://ftp.gnu.org/gnu/aspell/dict/ |
|---|
| 30 | |
|---|
| 31 | Then follow these instructions: |
|---|
| 32 | |
|---|
| 33 | source /Library/Frameworks/GTK+.framework/Versions/Current/bin/env |
|---|
| 34 | tar -jxf aspell-<lang>-<version>.tbz2 |
|---|
| 35 | cd aspell-<lang>-<version> |
|---|
| 36 | ./configure |
|---|
| 37 | make |
|---|
| 38 | make install |
|---|
| 39 | |
|---|
| 40 | |
|---|
| 41 | Compiling Requirements |
|---|
| 42 | ---------------------- |
|---|
| 43 | These instructions were gathered for building a universal binary on a PPC. The |
|---|
| 44 | steps for building on an i386 should be essentially the same. |
|---|
| 45 | |
|---|
| 46 | Requirements: |
|---|
| 47 | - OS/X 10.4, i386 or ppc |
|---|
| 48 | - Universal MacPython 2.5 |
|---|
| 49 | http://www.pythonmac.org/packages/py25-fat/index.html |
|---|
| 50 | - Latest XCode (2.4.0 or greater) |
|---|
| 51 | - py2app |
|---|
| 52 | http://svn.pythonmac.org/py2app/py2app/trunk/doc/index.html |
|---|
| 53 | |
|---|
| 54 | Install all of the requirements. Make sure that the universal MacPython is |
|---|
| 55 | installed before py2app. Then ensure that this is the first python in your |
|---|
| 56 | PATH. |
|---|
| 57 | |
|---|
| 58 | export PATH=/Library/Frameworks/Python.framework/Versions/2.5/bin:$PATH |
|---|
| 59 | |
|---|
| 60 | Then install py2app. |
|---|
| 61 | |
|---|
| 62 | |
|---|
| 63 | Compiling |
|---|
| 64 | --------- |
|---|
| 65 | |
|---|
| 66 | In the top level run the configure script. If this is source is from subversion |
|---|
| 67 | then run the autogen.sh script. Follow it up with a make: |
|---|
| 68 | |
|---|
| 69 | ./configure |
|---|
| 70 | or |
|---|
| 71 | ./autogen.sh |
|---|
| 72 | make |
|---|
| 73 | |
|---|
| 74 | Once that is done Gajim can be run from the source tree. You may also create an |
|---|
| 75 | app bundle suitable for use or distribution. To do that run: |
|---|
| 76 | |
|---|
| 77 | python setup_osx.py build |
|---|
| 78 | |
|---|
| 79 | The Gajim.app bundle is created in the dist directory. This bundle is ready |
|---|
| 80 | for use as is. Copy it to your /Applications directory and you're good to go. |
|---|
| 81 | |
|---|
| 82 | You now have a self contained (almost, requires GTK+.framework still) universal |
|---|
| 83 | native build of Gajim. |
|---|
| 84 | |
|---|
| 85 | Optionally to create a distribution of the Gajim app bundle do: |
|---|
| 86 | |
|---|
| 87 | python setup_osx.py dist |
|---|
| 88 | |
|---|
| 89 | |
|---|
| 90 | |
|---|
| 91 | Development |
|---|
| 92 | ----------- |
|---|
| 93 | |
|---|
| 94 | It is possible to run Gajim correctly from the app bundle but still use the |
|---|
| 95 | python code in the source tree. This line must be added to the _run() function |
|---|
| 96 | in the Gajim.app/Resources/__boot__.py file. It needs to be located just after |
|---|
| 97 | the sys module is imported. Font forget to fix the path to match your |
|---|
| 98 | environment. |
|---|
| 99 | |
|---|
| 100 | sys.path = ["/Users/user/Source/gajim/src"] + sys.path |
|---|
