Beginner

Getting started current branch 9.X

Short guide to get started for newcomers to GCompris/Linux development. This is tested with ubuntu 9.10 and 10.04. It's from scratch to your first own activity.

Git download

git clone git://git.gnome.org/gcompris
cd gcompris

If you want an update of the current repository (like svn update):

git pull

build gcompris development dependencies:

sudo apt-get build-dep gcompris

make sure you have the package "gnome-common" installed.

in gcompris folder:
sh autogen.sh && make

if you want do a 'sudo make install' You should be able to test a GCompris-Activity by running the following command in the 'src' directory:

sh runit.sh connect4-activity

Create a new own activity

In the 'src' directory:

sh createit.sh basuracatcher
make
sh runit.sh basuracatcher-activity/

You are also able to try the installed version by running:

make clean
sh autogen.sh
make
sudo make install
gcompris --experimental --reread-menu

Then happy coding in 'src/basuracatcher-activity/basuracatcher.py'

You can continue reading here

Setting up the IDE

Of course you are able to choose your favorite IDE but in case you haven't one, I'll show you how to do it in my favorite Eclipse. I tried the following steps with "Eclipse Helios"

1) Download Eclipse C/C++: http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/heliosr
2) Install the Python Plug-in:
Open eclipse and goto Help->Install new Software->Add Site:

http://pydev.org/updates

Select the pydev plugin and follow the steps. After restarting you should be able to open and edit Python files.
3) Import GCompris as an eclipse project:
File->new->C/C++-->"Makefile project with existing code" -> choose GCompris source directory
After restarting you should be able to open your created python file in src/basuracatcher-activity/basuracatcher.py
4) Configure PyDev
Goto Window->Preferences->Interpreter Python and select your interpeter (e.g: /usr/bin/python)

5) Run your activity as "External tool" This step is optional. If you like more the Terminal to run and test your activity this is not necessary. But eclipse is an "Integrated Development Environment" so why not use its features. Goto: "Run->External Tools->External Tools Config". Create new and use following details: Name: Your activity name Location: e.g.: /home/fionn/dev/gc/gcsrc1/gcompris/src/runit.sh Working Dir.: e.g.:/home/fionn/dev/gc/gcsrc1/gcompris/src Arguments: ${selected_resource_name} or hardcoded "chat-activity"