|
Packit |
4b6dd7 |
libgdata
|
|
Packit |
4b6dd7 |
========
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
libgdata is a GLib-based library for accessing online service APIs using the
|
|
Packit |
4b6dd7 |
GData protocol --- most notably, Google's services. It provides APIs to access
|
|
Packit |
4b6dd7 |
the common Google services, and has full asynchronous support.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
See the test programs in gdata/tests/ for simple examples of how to use the
|
|
Packit |
4b6dd7 |
code.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
libgdata is API and ABI stable.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Dependencies
|
|
Packit |
4b6dd7 |
============
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
• glib-2.0 ≥ 2.44.0
|
|
Packit |
4b6dd7 |
• libxml-2.0
|
|
Packit |
4b6dd7 |
• gio-2.0 ≥ 2.44.0
|
|
Packit |
4b6dd7 |
• libsoup-2.4 ≥ 2.42.0
|
|
Packit |
4b6dd7 |
• liboauth ≥ 0.9.4
|
|
Packit |
4b6dd7 |
• json-glib ≥ 0.15.0
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
If compiling with --enable-gnome (for GNOME support):
|
|
Packit |
4b6dd7 |
• gcr-base-3
|
|
Packit |
4b6dd7 |
• goa-1.0 ≥ 3.8
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
If compiling the demos:
|
|
Packit |
4b6dd7 |
• gtk+-3.0 ≥ 2.91.2
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Environment variables
|
|
Packit |
4b6dd7 |
=====================
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
If the environment variable LIBGDATA_DEBUG is set to one of the following
|
|
Packit |
4b6dd7 |
values, libgdata will give debug output (at various levels):
|
|
Packit |
4b6dd7 |
0: Output no debug messages or network logs
|
|
Packit |
4b6dd7 |
1: Output debug messages, but not network logs
|
|
Packit |
4b6dd7 |
2: Output debug messages and network traffic headers
|
|
Packit |
4b6dd7 |
3: Output debug messages and full network traffic logs, redacting usernames,
|
|
Packit |
4b6dd7 |
passwords and auth. tokens
|
|
Packit |
4b6dd7 |
4: Output debug messages and full network traffic logs, and don't redact
|
|
Packit |
4b6dd7 |
usernames, passwords and auth. tokens
|
|
Packit |
4b6dd7 |
If LIBGDATA_DEBUG is unset, no debug output will be produced.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
So, to debug a program which uses libgdata, run it from a terminal with the
|
|
Packit |
4b6dd7 |
following command:
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
$ LIBGDATA_DEBUG=3 ./my-program-name &> libgdata.log
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Deprecation guards
|
|
Packit |
4b6dd7 |
==================
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
If LIBGDATA_DISABLE_DEPRECATED is defined when compiling against libgdata, all
|
|
Packit |
4b6dd7 |
deprecated API will be removed from included headers.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Licensing
|
|
Packit |
4b6dd7 |
=========
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
libgdata is licensed under the LGPL; see COPYING for more details.
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Contact
|
|
Packit |
4b6dd7 |
=======
|
|
Packit |
4b6dd7 |
|
|
Packit |
4b6dd7 |
Philip Withnall <philip@tecnocode.co.uk>
|
|
Packit |
4b6dd7 |
https://wiki.gnome.org/Projects/libgdata
|