Sugar with sugar-jhbuild

One of the easiest ways to install Sugar is to use sugar-jhbuild.

Sugar-jhbuild will automatically download the latest of sugar's dependencies as well as sugar itself directly from their source repositories, rather than relying on source packages that may have become stale. Below are generic instructions on how to use sugar-jhbuild to get up and running with Sugar.

Checkout sugar-jhbuild

git-clone git://dev.laptop.org/sugar-jhbuild

Build sugar and its dependencies

Change directory and start the build.

cd sugar-jhbuild
./sugar-jhbuild build

Run Sugar

./sugar-jhbuild run

Sugar Keys

Other commands

JHBuild has several other commands that can be useful for development. You can get an overview with:

./sugar-jhbuild --help-commands

Customize

To customize the build create a configuration file, named .olpc.jhbuildrc, in your home directory.

Write access to the repositories

If you have write access to the repositories you can add:

repos['gnome.org'] = ':ext:marco@cvs.gnome.org:/cvs/gnome'
repos['mozilla.org'] = ':ext:marco%gnome.org@cvs.mozilla.org:/cvsroot'
repos['git.laptop.org'] = 'git+ssh://dev.laptop.org/git/artwork'

Notes

sugar-jhbuild is still in early development. In particular, dependencies detection will be improved. It needs a lot of testing, so give it a try and report issues!

Troubleshooting

In the new (as of 2007-01-26) builds it should not be necessary, but if you hit trouble you could verify the build with

./sugar-jhbuild sanitycheck

And fix the reported problems.

Again, as of 2007-01-26, new builds should not have problems when building, but just in case:

get a clean sugar-jhbuild	
cd sugar-jhbuild
./sugar-jhbuild build meta-sugar-base
./sugar-jhbuild build

External links

• JHBuild manual