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.


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 three new files there:
 - a .dsc file
 - a .changes file
 - a .tar.gz file with the source code


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

Point your webbrowser to
  https://garage.maemo.org/extras-assistant
for uploading the package. Follow the instructions on the site.
After this, your package will be available in the maemo-extras-devel repository.
If the package is fine and works, you can promote it to the maemo-extras
repository on the site
  https://garage.maemo.org/promoter

