A library full of GTK+ widgets for mobile phones

Guido Günther f4b6747ba0 Merge branch 'rpm' of julianrichen/libhandy into master 4 hours ago
data 728f3a0140 [Packaging] Add *.spec file for RPM builds 1 day ago
debian 6044f48ab6 debian: New git snapshot release 2 days ago
doc 4ee0366c39 Add an arrows widget 4 days ago
examples d37f19d3df Add arrows widget example 4 days ago
src 4f1d689587 Add symbols file to link step 2 days ago
tests fbf60410dc dialer: Make it simple to clear the stored number 3 weeks ago
.dir-locals.el 669a0cc633 Use linux style indentation 3 months ago
.editorconfig 4d034dbbcf Add an editorconfig file 3 months ago
.gitignore 9e3a99f103 gitignore: Ignore Meson and GNOME Builder files 3 months ago
COPYING f6dd5606b1 license: Use LGPL-2.1+ instead of LGPL-3.0+ 3 months ago
HACKING.md 5c3f9717d9 Initial HACKING document 2 months ago
README.md 2cb581a693 README: Document build dependencies 1 month ago
gir1.2-libhandy-0.0.install ab0168e36d Add Debian packaging 1 month ago
libhandy-0.0-0.install ab0168e36d Add Debian packaging 1 month ago
libhandy-0.0-dev.install ab0168e36d Add Debian packaging 1 month ago
libhandy.doap ef295f00c6 Add libhandy.doap 2 months ago
libhandy.syms 4f1d689587 Add symbols file to link step 2 days ago
meson.build 127b657163 run.in: Set GLADE_CATALOG_SEARCH_PATH as well 1 month ago
meson_options.txt afae9dcb50 Add glade catalog file 1 month ago
run.in 127b657163 run.in: Set GLADE_CATALOG_SEARCH_PATH as well 1 month 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