Version support for datastore/Howto

From Sugar Labs
Jump to: navigation, search

How to try out the latest version support prototype

Backup

If you've used Sugar before, it is highly recommended to create a backup of your data store as it will be updated on first startup and cannot be read by older versions of Sugar afterwards:

cp -a ~/.sugar/default/datastore ~/.sugar/default/datastore.v2

Prerequisites

You need to have sugar-jhbuild installed as usual. Make sure it's fully up-to-date and all dependencies are installed (./sugar-jhbuild depscheck).

Installation

Switch to the sugar-versionsupport JHBuild module set by replacing

moduleset = 'sugar'

with

moduleset = 'sugar-versionsupport'

in sugar-jhbuild/sugar.jhbuildrc.

Move away the old sources for the sugar, sugar-datastore and sugar-toolkit packages (JHBuild cannot switch between different git modules):

cd sugar-jhbuild
for pkg in sugar{,-datastore,-toolkit} ; do
    mv "${pkg}" "${pkg}-upstream"
done

Get and build the new sources:

cd sugar-jhbuild
./sugar-jhbuild updateone sugar{,-datastore,-toolkit}
./sugar-jhbuild buildone sugar{,-datastore,-toolkit}

Usage

Run as usual:

cd sugar-jhbuild
./sugar-jhbuild run sugar-emulator --fullscreen

Please note that it's based on my VNC support branch, so instead of Xephyr you'll get a VNC viewer. You shouldn't notice much of a difference, with the exception of non-US keyboards working properly. To bring up the VNC menu press F8.