
Copyright (C) 2005-2007 Nokia Corporation.


This package contains a collection of small example
applications. These example applications demonstrate how to use the
Maemo libraries in your application.

The example applications and their description are:


example_color_selector.c - Example of use HildonColorSelector object
example_file_chooser.c   - Example of use HildonFileChooser object
example_file_details.c   - Example of use HildonFileDetails object
example_findtoolbar.c    - Example of use HildonFileToolbar object
example_font_selector.c  - Example of use HildonFontSelector object
example_gconf.c          - Example of use GConf
example_gtk_print_info.c - Example of use GtkPrintInfo object
example_hard_keys.c      - Example of mapping Hard Keys events
example_hildonapp.c      - Example of use HildonApp object
example_hildonappview.c  - Example of use HildonAppView object
example_libosso.c        - Example of LibOSSO initialization and IPC
example_menu.c           - Example of Hildon menu
example_message.c        - Client LibOSSO IPC test
example_quickstart.c     - Simple Hello World Application
example_toolbar.c        - Example of use Toolbar into HildonApp



Pre-requisites
--------------

Before compiling these example apps you need to have the Scratchbox
together with the Maemo SDK installed into your computer. 


Getting maemo-examples
----------------------

You can get maemo-examples from the maemo repository. Do this:

[sbox-SDK_X86: ] > mkdir src
[sbox-SDK_X86: ] > cd src/

# You can get the maemo-examples code from the repository. You can do:

[sbox-SDK_X86: ~/src] > apt-get source maemo-examples

# note: the version number may differ what is given below (1.4).

[sbox-SDK_X86: ~/src] > tar xvzf maemo-examples-1.4.tar.gz
... snip ...

You have now succesfully extracted the examples under your ~/src directory.

[sbox-SDK_X86: ~/src] > cd maemo-examples-1.4


Build
-----

Compiling "maemo_examples" is easy, just run:


[sbox-SDK_X86: ~/src/maemo-examples-1.4] > make
gcc .... snip ....
.
.

You should now have a collection of binaries staring with "example_".



Running the example applications
--------------------------------

Start the Xephyr outside of Scratchbox (as instructed in the Maemo Tutorial) and start the
Hildon Application framework inside the Scratchbox:

# here we assume that Xephyr is using DISPLAY :2

[sbox-SDK_X86: ] > export DISPLAY=:2

# start HAF 
[sbox-SDK_X86: ] > af-sb-init.sh start
...

# After compiling you can start these apps by running the
# run-standalone.sh script like this:

[sbox-SDK_X86: ~/src/maemo-examples-1.4] > run-standalone.sh ./example_hildonapp


The application example_hildonapp should now be visible inside the Xephyr window.

Please report any bugs or other problems using http://bugs.maemo.org website. 


---
EOF
