Sugar with 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 installing Sugar to see if they are available.
In a suitable directory, execute
Build sugar base system and its dependencies
Change directory and start the build.
cd sugar-jhbuild git pull ./sugar-jhbuild update ./sugar-jhbuild build
This command launches the Sugar emulator:
To exit the emulator, press Alt-Q.
Running multiple instances
To run multiple instances of sugar you can start it in the following way:
SUGAR_PROFILE=2 ./sugar-jhbuild run
Run an individual activity
Within the sugar shell (./sugar-jhbuild shell), this command launches an individual activity for testing (from the mailing list):
sugar-activity [bundle name]
Configure the mode and resolution of Sugar
You can make Sugar run in a window as well as specify a resolution. Within the sugar-jhbuild directory, backup, then edit the python program file sugar-emulator:
cp build/bin/sugar-emulator build/bin/sugar-emulator.backup nano build/bin/sugar-emulator
Find this piece of code:
cmd = [ 'Xephyr' ] cmd.append(':%d' % display) cmd.append('-ac') if gtk.gdk.screen_width() < 1200 or gtk.gdk.screen_height() < 900: cmd.append('-fullscreen') else: cmd.append('-screen') cmd.append('%dx%d' % (1200, 900))
Comment out the if and else instructions, and specify the screen resolution and mode you want (it's important to delete 4 spaces behind the "cmd.append" lines):
cmd = [ 'Xephyr' ] cmd.append(':%d' % display) cmd.append('-ac') # if gtk.gdk.screen_width() < 1200 or gtk.gdk.screen_height() < 900: # cmd.append('-fullscreen') # else: cmd.append('-screen') cmd.append('%dx%d' % (800, 600))
Sugar will now run on a 800x600 window.
JHBuild has several other commands that can be useful for development. You can get an overview with:
A useful sequence of commands for building Sugar, from the Sugar mailing list:
./sugar-jhbuild update ./sugar-jhbuild build ./sugar-jhbuild run
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:firstname.lastname@example.org:/cvs/gnome' repos['mozilla.org'] = ':ext:email@example.com:/cvsroot' repos['dev.laptop.org'] = 'git+ssh://firstname.lastname@example.org/git/' repos['dev.laptop.org/projects'] = 'git+ssh://email@example.com/git/projects/'