100 lines
2.8 KiB
Text
100 lines
2.8 KiB
Text
|
Introduction
|
||
|
|
------------
|
||
|
|
|
||
|
|
This is an alpha release of Gajim for OS/X using native GTK+. It is not finished
|
||
|
|
nor is it relatively stable. The native port of GTK+ is alpha and not stable
|
||
|
|
yet, though it has proven to be usable for Gajim. Having said that it is usable,
|
||
|
|
basic functionality works. See the TODO file for a list of what is and is not
|
||
|
|
working.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Installing
|
||
|
|
----------
|
||
|
|
|
||
|
|
Install the GTK+ framework into your /Library/Frameworks directory. It can be
|
||
|
|
found at http://codepunks.org/misc/gtk/osx.
|
||
|
|
|
||
|
|
Copy the Gajim.app into the /Applications directory or any other directory.
|
||
|
|
|
||
|
|
|
||
|
|
Installing language dictionaries
|
||
|
|
--------------------------------
|
||
|
|
|
||
|
|
The codepunks.org build of the GTK+ framework comes with the US English
|
||
|
|
dictionary pre-installed. If you wish to install a different dictionary download
|
||
|
|
the appropriate dictionary from here:
|
||
|
|
|
||
|
|
http://ftp.gnu.org/gnu/aspell/dict/
|
||
|
|
|
||
|
|
Then follow these instructions:
|
||
|
|
|
||
|
|
source /Library/Frameworks/GTK+.framework/Versions/Current/bin/env
|
||
|
|
tar -jxf aspell-<lang>-<version>.tbz2
|
||
|
|
cd aspell-<lang>-<version>
|
||
|
|
./configure
|
||
|
|
make
|
||
|
|
make install
|
||
|
|
|
||
|
|
|
||
|
|
Compiling Requirements
|
||
|
|
----------------------
|
||
|
|
These instructions were gathered for building a universal binary on a PPC. The
|
||
|
|
steps for building on an i386 should be essentially the same.
|
||
|
|
|
||
|
|
Requirements:
|
||
|
|
- OS/X 10.4, i386 or ppc
|
||
|
|
- Universal MacPython 2.5
|
||
|
|
http://www.pythonmac.org/packages/py25-fat/index.html
|
||
|
|
- Latest XCode (2.4.0 or greater)
|
||
|
|
- py2app
|
||
|
|
http://svn.pythonmac.org/py2app/py2app/trunk/doc/index.html
|
||
|
|
|
||
|
|
Install all of the requirements. Make sure that the universal MacPython is
|
||
|
|
installed before py2app. Then ensure that this is the first python in your
|
||
|
|
PATH.
|
||
|
|
|
||
|
|
export PATH=/Library/Frameworks/Python.framework/Versions/2.5/bin:$PATH
|
||
|
|
|
||
|
|
Then install py2app.
|
||
|
|
|
||
|
|
|
||
|
|
Compiling
|
||
|
|
---------
|
||
|
|
|
||
|
|
In the top level run the configure script. If this is source is from subversion
|
||
|
|
then run the autogen.sh script. Follow it up with a make:
|
||
|
|
|
||
|
|
./configure
|
||
|
|
or
|
||
|
|
./autogen.sh
|
||
|
|
make
|
||
|
|
|
||
|
|
Once that is done Gajim can be run from the source tree. You may also create an
|
||
|
|
app bundle suitable for use or distribution. To do that run:
|
||
|
|
|
||
|
|
python setup_osx.py build
|
||
|
|
|
||
|
|
The Gajim.app bundle is created in the dist directory. This bundle is ready
|
||
|
|
for use as is. Copy it to your /Applications directory and you're good to go.
|
||
|
|
|
||
|
|
You now have a self contained (almost, requires GTK+.framework still) universal
|
||
|
|
native build of Gajim.
|
||
|
|
|
||
|
|
Optionally to create a distribution of the Gajim app bundle do:
|
||
|
|
|
||
|
|
python setup_osx.py dist
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Development
|
||
|
|
-----------
|
||
|
|
|
||
|
|
It is possible to run Gajim correctly from the app bundle but still use the
|
||
|
|
python code in the source tree. This line must be added to the _run() function
|
||
|
|
in the Gajim.app/Resources/__boot__.py file. It needs to be located just after
|
||
|
|
the sys module is imported. Font forget to fix the path to match your
|
||
|
|
environment.
|
||
|
|
|
||
|
|
sys.path = ["/Users/user/Source/gajim/src"] + sys.path
|