Editing Maemo packaging

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
-
#REDIRECT [[Packaging]]
+
Maemo packaging is generally similar to Debian packaging, with a few small differences, this article aims to illustrate some of those differences and aggregate the various resources on Maemo packaging.
 +
 
 +
== Packaging policy ==
 +
 
 +
Most of the specifics for Maemo packaging are outlined in the [http://maemo.org/forrest-images/pdf/maemo-policy.pdf Maemo packaging policy]. The policy is still in the draft stage, though, so certain parts are still incomplete or not entirely up to date.
 +
 
 +
== Sections ==
 +
This is the list used in Fremantle/Maemo5 and is the same as the [http://lists.maemo.org/pipermail//maemo-developers/2008-October/035437.html final] list for Diablo as [[Task:Package_categories|discussed in the task]].
 +
 
 +
{| class="wikitable"
 +
! Key
 +
! Example English i18n
 +
! Example apps
 +
|-
 +
| user/desktop
 +
| Desktop
 +
| Home, statusbar and taskbar applets
 +
|-
 +
| user/development
 +
| Programming
 +
| py2deb
 +
|-
 +
| user/education
 +
| Education
 +
| Flashcard apps
 +
|-
 +
| user/games
 +
| Games
 +
| Doom, Duke Nukem 3D
 +
|-
 +
| user/graphics
 +
| Graphics
 +
| Photo apps, GIMP, Inkscape, fonts
 +
|-
 +
| user/multimedia
 +
| Multimedia ''or'' Sound & Video
 +
| Canola, mplayer, Kagu, UKMP, MediaBox
 +
|-
 +
| user/navigation
 +
| (Location &) Navigation
 +
| maemo-mapper, Navit
 +
|-
 +
| user/network
 +
| Internet & Networking
 +
| Web browsers, Samba clients, OpenAFS, Transmission
 +
|-
 +
| user/office
 +
| Office
 +
| GPE, Claws, AbiWord
 +
|-
 +
| user/science
 +
| Science
 +
| gnuplot, Octave
 +
|-
 +
| user/system
 +
| System
 +
| rotation-support, enhanced kernels, themes
 +
|-
 +
| user/utilities
 +
| Utilities ''or'' Accessories
 +
| Calculators, terminals, text editors
 +
|-
 +
|}
 +
 
 +
If the package's section starts "user/", but is not any of the above, the ''Application Manager'' forces them into an "Other" section.
 +
 
 +
== Maemo-specific fields ==
 +
 
 +
There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.
 +
 
 +
== Displaying an icon in the Application Manager next to your package ==
 +
 
 +
Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.
 +
 
 +
# Make an image that is '''48x48'''. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.
 +
# base64 encode the image. This can be done in many ways, depending on the platform, but I'll assume you are in scratchbox.
 +
<pre>
 +
apt-get update
 +
apt-get install sharutils
 +
uuencode -m <name of 48x48 image> <name of 48x48 image> > <name of 48x48 image>.base64
 +
</pre>
 +
# Add the field ''XB-Maemo-Icon-26'' to your debian/control (in Maemo4 the size of the icons was 26x26, hence the name of the field, '''which has not changed''')
 +
# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 48x48 image>'' to the line above the ''===''
 +
# Add this to the ''XB-Maemo-Icon-26'' field.
 +
# Add a space in front of every line of the encoded icon.
 +
 
 +
Here is an example of a properly formatted Maemo-Icon-26: (of wrong image size)
 +
<pre>
 +
Description: Chess...
 +
XB-Maemo-Icon-26:
 +
iVBORw0KGgoAAAANSUhEUgAAABoAAAAaCAYAAACpSkzOAAAABGdBTUEAAK/INwWK6QAAABl0
 +
RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALxSURBVHja3FZNTBNREP669J/S
 +
XYxtKRWl1JOSFBIPhkitCQeNiaKBmzdj9Ggk0ZOBxHDWixcTjV6MF+WiIB40YEyMBMGYEqQK
 +
tLS2lG7pdre0pF3WtxslgJRuD2J0kpfdTN7O976Z782sRpIk7IZR2C2TGW1cv8xaY5WuXLy8
 +
iW5XV5fk8/kkr9e7ya/T6SSNRiOViikvbbmDDD590SusZBGYDiDwJbDud7vdvYIgIJfLYXV1
 +
tSwhrQrSfRX6/26N/j+gkjW6ce06HE4HGEctGuj9oEwUzFYz5ubmEA6HQVEUisUi8vn8b4rd
 +
zjRbNxCZrr+3t7XTzjrnvMfdxMi7xj6OIRaPIbWcQjabVdRWKBTkrX4SZ2SjvCtKXf+tkxxD
 +
M5MetwfHj/lwwueHy+WCVqvdehdHKq7R6JvbpfNMAGiGhs1mg9ls3sS+4hodbDqCwef9mA9P
 +
7vhhVVWV3BGUOomiaCSufEWMxNwimlweMFYbpoMfyp70J6t8xanLZgWs8Ak07N0Hau0P3qOs
 +
wIHnl5FJx2E1WlUFuXrzIS713KusRplMCoLAgl2O4N34ODQ4VRaot6cbUzMRNNQ/w/uJWXWM
 +
eH5JARkYHsLQMIe1NZEpB7Sn1uKFhkL3maO4cL5NHVAo+hkPnrzEq2HqQIf/3ICzvr7FXmeH
 +
3qBXlslkgtFoVBS3YfbcKRRFfJpagE6vUwd0//FbjI7mkcvnGoNfg51ORx3sNju+hWYxMxsk
 +
jHlF2jJgdXU1DAaDrDx/kQAVRREJlldXo8kJoPlQ8wHSevosFgs5MmE5H0IingDP8eAzPAQC
 +
tkJakDz05Hsks+poPzwg6+Luo9chVb2O3Hilv7V6W5nO02cVX3wxjsj3CMKRBUSjUcQWY0iy
 +
SQVoi6XJaiQxubKpI02yj2xk6BoaBr0BqXRKCZpYSiCZlIXCguM4pWtvY0ypyUtt87PSIj/t
 +
pJ/JICzLKiBLySTYVArpdFrp3DuMhRZVqfvnJ+wPAQYA1hdr5EDqltYAAAAASUVORK5CYII=
 +
</pre>
 +
 
 +
[[Category:Development]]

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)