A library full of GTK+ widgets for mobile phones

Guido Günther 36bb094c94 Merge branch 'rah/show-action-buttons' of bob.ham/libhandy into master 6 days ago
data afae9dcb50 Add glade catalog file 3 weeks ago
debian 133935495a debian: honor DEB_BUILD_OPTIONS=nocheck 2 weeks ago
doc 73045aec5f docs: Add meson dependency name 3 weeks ago
examples b30df9ded9 example-window: Make the default size more phone-like 1 week ago
src 2b6cc6ede7 dialer: Add "show-action-buttons" property 1 week ago
tests f38ecb9c31 dialer: fix emission of number property change signals 3 weeks ago
.dir-locals.el 669a0cc633 Use linux style indentation 2 months ago
.editorconfig 4d034dbbcf Add an editorconfig file 2 months ago
.gitignore 9e3a99f103 gitignore: Ignore Meson and GNOME Builder files 2 months ago
COPYING f6dd5606b1 license: Use LGPL-2.1+ instead of LGPL-3.0+ 2 months ago
HACKING.md 5c3f9717d9 Initial HACKING document 1 month ago
README.md 2cb581a693 README: Document build dependencies 3 weeks ago
gir1.2-libhandy-0.0.install ab0168e36d Add Debian packaging 3 weeks ago
libhandy-0.0-0.install ab0168e36d Add Debian packaging 3 weeks ago
libhandy-0.0-dev.install ab0168e36d Add Debian packaging 3 weeks ago
libhandy.doap ef295f00c6 Add libhandy.doap 1 month ago
meson.build 127b657163 run.in: Set GLADE_CATALOG_SEARCH_PATH as well 3 weeks ago
meson_options.txt afae9dcb50 Add glade catalog file 3 weeks ago
run.in 127b657163 run.in: Set GLADE_CATALOG_SEARCH_PATH as well 3 weeks ago

README.md

Handy

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 the following build-deps:

sudo apt-get -y install gtk-doc-tools libgirepository1.0-dev libgnome-desktop-3-dev libgtk-3-dev meson pkg-config valac

Building

We use the meson (and thereby Ninja) build system for libhandy. The quickest way to get going is to do the following:

meson . _build
ninja -C _build
ninja -C _build install

For build options see meson_options.txt. E.g. to enable documentation:

 meson . _build -Dgtk_doc=true
 ninja -C _build/ libhandy-doc

Usage

There's a C example:

 _build/examples/example

and one in Python. When running from the built source tree it needs several environment varibles so use _build/run to set them:

 _build/run examples/example.py

Glade

To be able to use Handy's widgets in the glade interface designer without installing the library use:

 _build/run glade