1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
Setup a development environment
===============================
Sugar is made of several modules and depends on many other libraries.
There are several ways to set up a Sugar environment for doing Sugar development, choose one at a time only;
- for testing or changing Sugar or a Sugar activity, install a [live build](#sugar-live-build), which has all dependencies and source code included, but is nearly 1GB of downloads;
- for writing or changing a Sugar activity, install a [packaged Sugar environment](#packaged-sugar), which will install dependencies automatically; or,
- for packaging Sugar, downstream developers create a [native Sugar build](#native-sugar) and install the necessary dependencies by hand, but Sugar is difficult to remove.
Sugar Live Build
----------------
Sugar Live Build is a complete bootable image containing Sugar, the toolkits, and the demonstration activities;
- can be booted from hard drive, flash drive, and optical media, automatically starting Sugar without persistence,
- can be installed as a virtual machine, with persistence and password protection,
- contains all build dependencies, configured source trees (git clones in `/usr/src`), and binaries (`make install`) for Sugar modules and the demonstration activity set.
See [downloads](http://people.sugarlabs.org/~quozl/sugar-live-build/) for the ISO9660 image file.
Once installed, Sugar Live Build can be used to make changes to Sugar, the toolkits, the demonstration activities, or to write new activities.
- changes to Sugar or the toolkits can be done by editing files in the module source trees in `/usr/src`, followed by per-module [install steps](https://github.com/sugarlabs/sugar-live-build/blob/master/src/config/hooks/normal/0900-sugar.hook.chroot#L42) for each changed module. See [issue 442](https://github.com/sugarlabs/sugar-toolkit-gtk3/issues/442) for details.
- changes to demonstration activities can be done in the activity source trees in `/usr/src/sugar-activities`, and are immediately effective; just start a new instance of the activity in Sugar.
- writing new activities can be done in the `~/Activities/` directory, and the new activity can be started using `sugar-activity3` command in Terminal, or by restarting Sugar so that the new `activity/activity.info` file is read to regenerate the [Home View](https://help.sugarlabs.org/en/home_view.html).
See [sugar-live-build](https://github.com/sugarlabs/sugar-live-build) on GitHub for configuration files to make your own Sugar Live Build using the Debian Live Build software.
Packaged Sugar
--------------
For development of activities without making changes to Sugar desktop.
For Fedora users, see [Using Sugar on Fedora](fedora.md). Once Sugar is installed, development of activities can begin.
For Debian users, see also [Using Sugar on Debian](debian.md), or see how to install `sucrose` below.
For Ubuntu users, see also [Using Sugar on Ubuntu](ubuntu.md), or see how to install `sucrose` below.
Install the `sucrose` package;
sudo apt install sucrose
Log out, then [log in with the Sugar desktop selected](https://github.com/sugarlabs/sugar-docs/blob/master/src/sugar-logging-in.md).
Once Sugar is installed, development of activities can begin.
You can also checkout [SOAS](https://spins.fedoraproject.org/en/soas).
Native Sugar
------------
For experts.
Clone each of the module repositories;
for module in sugar{-datastore,-artwork,-toolkit,-toolkit-gtk3,}; do
git clone https://github.com/sugarlabs/$module.git
done
Install the build dependencies. There are many, and their package
names vary by distribution. A first start is in the Debian or Fedora
packaging files. From 0.113, add Six.
On Debian or Ubuntu, ensure `deb-src` lines are present and enabled in `/etc/apt/sources.list`, and then;
sudo apt update
for module in sugar{-datastore,-artwork,-toolkit,-toolkit-gtk3,}; do
sudo apt build-dep $module
done
sudo apt install python{,3}-six python3-empy
On Fedora, use [dnf builddep](http://dnf-plugins-core.readthedocs.io/en/latest/builddep.html), like this;
for module in sugar{-datastore,-artwork,-toolkit,-toolkit-gtk3,}; do
sudo dnf builddep $module
done
sudo dnf install python{2,3}-six python3-empy
Autogen, configure, make, and install modules for Python 2;
for module in sugar{-toolkit,-toolkit-gtk3}; do
cd $module
./autogen.sh --with-python2
make
sudo make install
cd ..
done
Autogen, configure, make, and install modules for Python 3;
for module in sugar{-artwork,-toolkit-gtk3,-datastore,}; do
cd $module
./autogen.sh --with-python3
make
sudo make install
cd ..
done
On Debian or Ubuntu, try `python3 -c 'import sugar3'` if fails move the `sugar3` directory from `/usr/local/lib/python3.6/site-packages/` to `/usr/local/lib/python3.6/dist-packages/`.
On Fedora, add `/usr/local/lib/python2.7/site-packages/` to `sys.path` for any Python 2 programs, especially `/usr/local/bin/sugar`;
export PYTHONPATH=/usr/local/lib/python2.7/site-packages
export GI_TYPELIB_PATH=/usr/local/lib/girepository-1.0
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
Install the run-time dependencies. There are many, and their package
names vary by distribution. A first start is in the Debian or Fedora
packaging files.
On Debian or Ubuntu, install the Sugar packages;
sudo apt install sucrose
On Fedora, use `dnf deplist` and filter by architecture;
for module in sugar{-datastore,-artwork,-toolkit,-toolkit-gtk3,}; do
echo
echo $module
sudo dnf deplist $module | \
awk '/provider:/ {print $2}' | \
grep -v i686 | \
sort -u | sudo xargs dnf -y install
done
Add the PolicyKit files to the system-wide directory;
sudo ln -sf /usr/local/share/polkit-1/actions/org.sugar.* \
/usr/share/polkit-1/actions/
Sugar is now installed in `/usr/local`. Remove any Sugar or Toolkit packages you installed from Fedora or Debian, otherwise then you start Sugar the packaged files in `/usr/` will be run.
Clone the Browse and Terminal activities;
mkdir -p ~/Activities
cd ~/Activities
git clone https://github.com/sugarlabs/browse-activity.git Browse.activity
git clone https://github.com/sugarlabs/terminal-activity.git Terminal.activity
Log out and [log in again with the Sugar desktop selected](https://github.com/sugarlabs/sugar-docs/blob/master/src/sugar-logging-in.md), or use the remote desktop feature described earlier on this page.
After making changes in a Sugar module, repeat the `sudo make install` step, and log in again.
Change Debugging Level
--------------------
You can enable debugging in Sugar by uncommenting the line
```shell
#export SUGAR_LOGGER_LEVEL=debug
```
present in `~/.sugar/default/debug`
The debug file also allows the enabling of debugging for other parts of the stack, such as collaboration.
|
