OlpcProject - Canterbury Technology

PyGame

How to write a complete application
- menus
- buttons
- How to write an XO activity at http://wiki.laptop.org/go/Creating_an_Activity
How to modify existing code
- the actual code is contained in
  - /var/sugar/build/share/
sugarize
- icons in sugar
  1. icons must be SVG format
  2. use icon guidelines at http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines/The_Sugar_Interface/Icons#Icon_Design_Guidelines
  3. OLPC user interface guidelines http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines/The_Sugar_Interface

Darcs

Commands
- darcs init
  - one time only per folder you are pushing/pulling from
  darcs add *
  - adds the file '*' to your current repository
  darcs record
  - creates the patch with the changes
  darcs push olpc@cvs:/var/darcs/olpc/connect
  - pushes the patch so everybody can enjoy (once you do it once you can simply type 'darcs push' to go to the now default directory)
  darcs pull
  - pulls updated patches to your machine (this only works if you have the 'olpc@cvs...' as your default directory)

Emulator

commandline switches
- starting another instance on the same machine...
  - SUGAR_PROFILE=2 ./sugar-jhbuild run
- networking
- disable the presence service
  - PRESENCE_SERVICE_DEBUG=disable-gabble ./sugar-jhbuild run

Sugar

command prompt
package an activity
getting stuff onto it
Packaging:
- Users can download a .xo package, when the package completes downloading, they use the Journal activity to "resume" the downloaded package

Emulating

Before you launch the emulated image, we strongly recommend reading through the Sugar Instructions on how to use the environment -- this does not look like the Windows or Mac operating systems!
Open a command prompt (aka cmd.exe) in the QEMU directory and launch qemu.exe using the appropriate image and "-L ." as first argument, and further arguments as explained on Emulating_the_XO/Quick_Start: (At the time of writing, the arguments are as shown below, but this can change/evolve, so please check the Quick Start page for the latest recommended arguments first!)

cd "\Program Files\Qemu" 
qemu.exe -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda image_name

Where image_name is the newest version you have downloaded. For example:

qemu.exe -L . -m 256 -kernel-kqemu -soundhw es1370 -net user -net nic,model=rtl8139 -hda olpc-redhat-stream-development-build-185-20061117_2030-devel_ext3.img

Running sugar on Ubuntu Feisty

This is recommended as being the least painful way to run and develop for sugar

install needed packages

   sudo aptitude install libloudmouth1-0 libloudmouth1-dev libdbus-glib-1-2 \
   libdbus-glib-1-dev darcs libsqlite3-dev libtheora-dev libxml2-utils libboost-dev \
   automake1.7 bison flex cvs libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev \
   libssl-dev xserver-xephyr libgtk2.0-dev libfribidi-dev libgsf-1-dev \
   libenchant-dev libasound2-dev libtiff4-dev libxt-dev docbook-xsl \
   libgconf2-dev libgnutls-dev intltool libpoppler-dev libpoppler-glib-dev \
   g++ python2.5-dev libtool gtk-doc-tools python-gtk2 python-gtk2-dev \
   python-avahi libavahi-client-dev libavahi-glib-dev liboil0.3-dev \
   libxslt1-dev libglade2-dev automake1.9 python-cairo-dev python-all-dev \
   libncurses5-dev gstreamer0.10-alsa python-gst0.10 subversion python-vte \
   ncurses-dev libsvn-dev gnome-doc-utils python-numpy python-numpy-dev \
   python-json libcurl3-dev libgnome-vfs-dev libxres-dev libxres1

Install git

sudo apt-get install git-core cogito

"git" sugar-jhbuild

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

Build sugar - this can take quite a while... over an hour.....
- ```
cd sugar-jhbuild  
./sugar-jhbuild
   
```
Run and enjoy
- ```
./sugar-jhbuild run 
    
```

These steps from http://wiki.laptop.org/go/Sugar_on_Ubuntu_Linux

PyGame

Darcs

Emulator

Sugar

Links

Emulating

Running sugar on Ubuntu Feisty