Maemo packaging

(Displaying an icon in the Application Manager next to your package)
(redirect to Packcaging after merge)
 
(One intermediate revision not shown)
Line 1: Line 1:
-
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.
+
#REDIRECT [[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.
+
-
 
+
-
'''These instructions are for Maemo4. For Maemo5 (Fremantle), the icons should be 48x48 but the field name is still ''XB-Maemo-Icon-26''.'''
+
-
 
+
-
# Make an image that is 26x26. 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 26x26 image> <name of 26x26 image> > <name of 26x26 image>.base64
+
-
</pre>
+
-
# Add the field ''XB-Maemo-Icon-26'' to your debian/control
+
-
# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 26x26 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:
+
-
<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]]
+

Latest revision as of 13:53, 26 January 2010

  1. REDIRECT Packaging