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

Easy packaging of plugins and themes for MediaBox.


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

The Package Builder is intended to be run inside the Scratchbox maemo-SDK.
You need to run it inside the ARMEL target for building packages for the
Nokia Internet Tablets.


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' as
   a subfolder.
   DO NOT copy the files inside your theme folder directly into 'theme'!

 - If you're packaging a plugin, put the folder of your plugin into
   'components' as a subfolder, and the graphics of your plugin into
   'theme/default'.
   DO NOT copy the files inside your plugin folder directly into 'components'!


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

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

Note: your application will appear as licensed under the GNU GPL


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

Run the script

  ./build-package.sh

in your maemo-SDK, 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 for installing


Step 4: Test your package
-------------------------

You should take the resulting .deb file and try installing it on your tablet
before distributing.


Step 5: 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

