MediaBox Extension Package Builder
==================================

The Package Builder makes it easy to package extensions for MediaBox in a
uniform way.


Requirements
------------

First of all, you need a valid debhelper environment for maemo. The maemo-SDK
in scratchbox with target ARMEL provides one, so you should build your packages
there.

If you want to upload packages to the maemo-extras-devel and maemo-extras
repositories you will also need a valid GPG key.


Step 1: Put everything into place
---------------------------------

The Package Builder contains the two directories 'components' and 'theme'.
If you're packaging a theme, put the folder of your theme into 'theme'.
If you're packaging a plugin, put the folder of your plugin into 'components',
and the graphics of your plugin into 'theme/default'.


Step 2: Edit the configuration
------------------------------

There is a configuration file 'configuration.properties'. Please read this file
and adjust the properties in there. This stuff is required for making your
package appear properly in the maemo application manager.
You can also provide a nice icon to appear in the application manager.


Step 3: Build the package
-------------------------

Run the script
  ./build-package.sh
in your debhelper environment (scratchbox, target ARMEL).

After a few seconds, you should see a success message like this:
  "dpkg-buildpackage: full upload; Debian-native package"

When you look into the parent directory, you will see four new files there:
 - a .dsc file
 - a .changes file
 - a .tar.gz file with the source code
 - a .deb file which can be installed on the internet tablet
 
Please test the .deb file on your device before uploading your extension.


Step 4: Upload to maemo-extras-devel
------------------------------------

There is a webinterface for uploading packages to maemo-extras-devel. Actually,
you don't upload the package (.deb), but the source archive (.tar.gz).
The autobuilder on the upload server then tries to build a package
automatically.

