Changes

2,227 bytes added ,  11:43, 27 February 2007
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.

'''Note:''' Some Linux distributions may need or have special procedures; you can check the pages on [[:Category:Installing Sugar|installing Sugar]] to see if they are available.

==Checkout sugar-jhbuild==

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

==Build sugar base system and its dependencies==

Change directory and start the build.

cd sugar-jhbuild
./sugar-jhbuild build

For the base packages (i.e. <tt>build-base</tt>), you should be able to use the binary packages from your GNU distribution instead of building them from scratch. Check the [[:Category:Installing Sugar|Installing]] or [[:Category:Linux distributions|Linux]] categories for specific distro info.

==Run Sugar==

This command launches the Sugar emulator:

./sugar-jhbuild run

To exit the emulator, press Alt-Q.

== Other commands ==

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

./sugar-jhbuild --help-commands

A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]:

./sugar-jhbuild update
./sugar-jhbuild build-base
./sugar-jhbuild build
./sugar-jhbuild run

== 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'

==External links==

* [http://www.gnome.org/~jamesh/jhbuild.html JHBuild manual]
* [http://www.redhatmagazine.com/2007/02/23/building-the-xo-introducing-sugar/ Red Hat Magazine article: Introducing Sugar]

[[Category:Installing Sugar]]
Anonymous user