blob: 0eb6cbe8dc243f290bea12d9147fb203415fa50d (
plain)
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
|
# Handy
[](https://gitlab.gnome.org/GNOME/libhandy/commits/master)
[](https://gitlab.gnome.org/GNOME/libhandy/commits/master)
The aim of the Handy library is to help with developing UI for mobile devices
using GTK/GNOME.
## License
libhandy is licensed under the LGPL-2.1+.
## Build dependencies
To build libhandy you need to first install the build-deps defined by [the debian/control file](https://gitlab.gnome.org/GNOME/libhandy/blob/master/debian/control#L6).
If you are running a Debian based distribution, you can easily install all those the dependencies making use of the following command
```sh
sudo apt-get build-dep .
```
## Building
We use the Meson (and thereby Ninja) build system for libhandy. The quickest
way to get going is to do the following:
```sh
meson . _build
ninja -C _build
ninja -C _build install
```
For build options see [meson_options.txt](./meson_options.txt). E.g. to enable documentation:
```sh
meson . _build -Dgtk_doc=true
ninja -C _build libhandy-doc
```
## Usage
There's a C example:
```sh
_build/examples/example
```
and one in Python. When running from the built source tree it
needs several environment variables so use \_build/run to set them:
```sh
_build/run examples/example.py
```
### Glade
To be able to use Handy's widgets in the glade interface designer without
installing the library use:
```sh
_build/run glade
```
## Documentation
The documentation can be found online
[here](https://gnome.pages.gitlab.gnome.org/libhandy).
## Getting in touch
Matrix room: [#libhandy:talk.puri.sm](https://gnome.element.io/#/room/#libhandy:talk.puri.sm)
|
