Changes

Jump to navigation Jump to search
add howto
== 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 [[Development Team/Jhbuild|sugar-jhbuild]] installed as usual. Make sure it's fully up-to-date and all dependencies are installed (<code>./sugar-jhbuild depscheck</code>).

=== Installation ===
Switch to the <code>sugar-versionsupport</code> JHBuild module set by replacing
moduleset = 'sugar'
with
moduleset = 'sugar-versionsupport'
in <code>sugar-jhbuild/sugar.jhbuildrc</code>.

Move away the old sources for the <code>sugar</code>, <code>sugar-datastore</code> and <code>sugar-toolkit</code> 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 (with broken keyboard) you'll get a VNC viewer. Except for the shortcuts of Xephyr/VNC (try F8) you shouldn't notice much of a difference (except that the keyboard is now working as expected, of course).
344

edits

Navigation menu