Development:IDE:XCode

This article is a work in progress

Creating XCode Project Files

This requires CMake. Open a terminal and cd into the adonthell directory. Then run

 cmake -G XCode .

to generate the Adonthell.xcproj that can be opened by XCode. Note that you might have to repeat this step as new source files get added (or you need to add them manually later on).

Issues

To be resolved

• Older versions of CMake have trouble escaping \ characters. The generated project file will fail to load unless edited manually.
• Adonthell contains multiple targets with the same name (but different directories). This is not handled well by XCode (or CMake's XCode generator?).

Creating Universal Binaries

No perfect way to do this yet. Adonthell PPC binaries run fine on Intel Macs, however.

Creating An App Bundle

To package Adonthell, all its modules and dependencies need to be included in the Application bundle. The script make-bundle.sh exists to mostly automate this process. It (currently) relies on adonthell and all its dependencies being installed to /usr/local and can be executed as follows

 install-bundle.sh /path/to/executable/

to create Executable.app in the current directory.

Building Adonthell Tools

The tools used to create content for Adonthell rely on GTK+, which used to require X11 to run. However, there is Gtk+ for Mac OS X, which provides GTK+ with a native Cocoa backend. It also has simple installation instructions, summarized below:

 # Install jhbuild into ~/bin:
 svn co http://svn.gnome.org/svn/jhbuild/trunk jhbuild
 cd jhbuild && make -f Makefile.plain install
 
 # Get GTK+ jhbuild configuration for OSX
 svn co http://developer.imendio.com/svn/gtk-osx-build/
 ln -s gtk-osx-build/jhbuildrc-gtk-osx ~/.jhbuildrc
 
 # Bootstrap build environment (required once)
 ~/bin/jhbuild bootstrap
 
 # Install GTK+ in /opt/gtk
 ~/bin/jhbuild build