Mac OS X

This was experimental work for evaluating OSGi and no longer applies.

Download the Launcher

Download  the Mac OSX launcher and unpack it.

Note: change "~" in all of the following examples to any directory you'd like.

cd ~
gunzip mac_osgi.tar.gz
tar -xvf mac_osgi.tar

Download the External Jar Bundles

Export the external jar bundles using SVN.

svn export https://code.kepler-project.org/code/kepler/external external

move or copy all of the jars from the external directory to the plugins directory.

mv external/*.jar ~/mac_osgi/plugins/
rmdir external

Download the kepler.kernel Jar Bundle

Download the kepler.kernel bundle and place it in the plugins directory along side all of the external bundles.

Unpack the kepler.kernel bundle to your .kepler/kepler.kernel.resources directory.  (This is an ugly kludge to get around reading resources from the bundle - see Steps to OSGi conversion)

mkdir ~/.kepler
cd ~/.kepler
rm -rf *
mkdir ~/.kepler/kepler.kernel.resources
cd ~/.kepler/kepler.kernel.resources
mv ~/mac_osgi/plugins/kepler.kernel_1.0.0.v*.jar .
jar -xvf kepler.kernel_1.0.0.v*.jar
mv kepler.kernel_1.0.0.v*.jar ~/mac_osgi/plugins

Launching Kepler

From the command line: change directory to mac_osgi and run the kepler executable there

cd ~/mac_osgi
./kepler

Or from the Finder you can  double click on Eclipse.app

Notes:

useful command line switches

./kepler -clean -consoleLog -console

-clean  (this will rebuild the Equinox cache on startup - without this switch the cache is used to start Kepler)

-consoleLog  (with an upper case L - this will display console messages as the framework starts, otherwise you will find timestamped .log files in the configuration directory)

-console  (this will bring up the OSGi console (if you don't see it at first press enter) type help to get a list of commands you can run there while Kepler is running - the "ss" command will let you see the state of all the bundles)

for more switches.

Configuration for the launcher is found in the following two files

mac_osgi/configuration/config.ini

mac_osgi/Eclipse.app/Contents/MacOS/eclipse.ini

Disclaimer:

If these instructions aren't working out of the box, try messing around with kepler.kernel.resources/kar/actors

deleting or adding kars

Building the Kepler Jar Bundle

Note: this may not work with the current HEAD if new jars have been added there and have not been added to the external directory (this is the case at the moment).  Try an earlier revision from maybe September 3rdish in the meantime.

cd ~/mac_osgi/
svn co https://code.kepler-project.org/code/kepler/trunk kepler.kernel
cd kepler.kernel
svn export svn://source.eecs.berkeley.edu/chess/ptII/trunk ptII
export KEPLER=~/mac_osgi/kepler.kernel
export PTII=~/mac_osgi/kepler.kernel/ptII
ant -f bundle_build.xml all