# Packaging &LIBGDA; UI extension

&LIBGDA; UI extension builds on top of &LIBGDA; and GTK+ to provide some graphical widgets, a control center (to manage DSN and list installed providers) and a browser program to analyze the contents of a database.

## Overview of the components

&LIBGDA; UI's components are:

- the runtime files (shared library)

- the GObject introspection files (to be used by the GObject introspection framework)

- the tools, which require the runtime component

- the development files (the includes to compile C programs)

Please note:

- the documentation and localization files are mixed with &LIBGDA;'s ones

- the tools have been described here as a separate component but it is highly recomended to bundle the tools with the runtime as they provide essential tools to the end user.

## Runtime component

This component is the base component for Libgda UI, required by any application which uses &LIBGDA;' UI, extension, it contains the following files (located under the installation directory):

    .
    |-- lib
    |   |-- libgda-5.0
    |   |   |-- plugins
    |   |   |   |-- gdaui-entry-filesel-spec.xml
    |   |   |   |-- gdaui-entry-password.xml
    |   |   |   |-- gdaui-entry-pict-spec.xml
    |   |   |   |-- gdaui-entry-pict-spec_string.xml
    |   |   |   |-- gdaui-entry-text-spec.xml
    |   |   |   `-- libgdaui-plugins.so
    |   |-- libgdaui-5.0.so -> libgdaui-5.0.so.4.1.0
    |   |-- libgdaui-5.0.so.4 -> libgdaui-5.0.so.4.1.0
    |   `-- libgdaui-5.0.so.4.1.0
    `-- share
        `-- libgda-5.0
            |-- language-specs
            |   `-- gda-sql.lang
            |-- server_operation.glade
            `-- ui
                |-- gdaui-entry-string-number.xml
                `-- gdaui-entry-string-string.xml

This component should be made dependent on the &LIBGDA;'s runtime component.

## GObject introspection

If GObject introspection has been compiled, &LIBGDA;'s UI extension's introspection files are:

    |-- share
    |   `-- gir-1.0
    |       `-- Gdaui-5.0.gir
    `-- lib
        `-- girepository-1.0
            `-- Gdaui-5.0.typelib

## Tools

### Control center

The control center's files are:

    .
    |-- bin
    |   `-- gda-control-center-5.0
    `-- share
        |-- applications
        |   `-- gda-control-center-5.0.desktop
        |-- libgda-5.0
        |   `-- pixmaps
        |       `-- gdaui-generic.png
        `-- pixmaps
            |-- gda-control-center-newcnc.png
            `-- gda-control-center.png

### Gda browser

The GdaBrowser can be packaged separately, but it depends on the runtime component and the UI extension runtime component.

    .
    |-- bin
    |   `-- gda-browser-5.0
    `-- share
        |-- applications
        |   `-- gda-browser-5.0.desktop
        |-- gnome
        |   `-- help
        |       `-- gda-browser
        |           |-- C
        |           `[···]
        `-- pixmaps
            |-- gda-browser-auth-big.png
            |[···]
            `-- gda-browser.png

## Development files

The development files are the include files needed to compile C programs, the PKG-CONFIG .pc files, the static libraries and a demo program (like gtk-demo)

    .
    |-- bin
    |   `-- gdaui-demo-5.0
    |-- include
    |   `-- libgda-5.0
    |       `-- libgdaui
    |           [...]
    `-- lib
    |   |-- libgdaui-5.0.a
    |   |-- libgdaui-5.0.la
    |   `-- pkgconfig
    |       `-- libgdaui-5.0.pc
    `-- share
        `-- libgda-5.0
            `-- demo
                [...]