Maemo packaging features you're missing out on

0
0
2008-11-17 19:24 UTC by Ryan Abel

Since a lot of you will be changing your packaging once the new categories are added to the Application Manager (which we are still missing a few translations!), now seems like a good time to discuss some of the packaging features many of you are missing out on.

Pretty names in Application Manager

Much like you can specify separate "Unix" and a "pretty" names for your project on Garage, you can specify a "Maemo-Display-Name" to show a "pretty" name for your package in Application Manager. Simply add a line with "XB-Maemo-Display-Name" to your debian/control file with the desired display name of your package, and it will show up as the package name in Application Manager. For instance, "OS2008 Feature upgrade" instead of "osso-software-version-rx34". This makes the package list look much cleaner, and package names much more readable. It's a dead-simple way to improve the user experience for everybody.

Upgrade descriptions

Typically users will either have to refer to a website (assuming you have one) or dig into the changelog in the .deb if they want to know what new things they're getting with an upgrade. Fortunately there's an easy way to provide a user-friendly change log right in the Application Manager. Simply specify an "XB-Maemo-Upgrade-Description" field in your debian/control file with a description of the update (formatted the same as the Description field), and users will see the description in a separate tab in the info dialog during updates.

Package icons

Packages can have icons displayed next to their names in the Application Manager, to have an icon, you simply need to encode a 26x26 pixel image (PNG is a reasonable choice) of your icon into base64 (uuencode -m) and add it to your debian/control file under "XB-Maemo-Icon-26". If you don't provide an icon your package will end up with the drab, ugly default package icon.

Selecting a menu location

Most of you know you can show a dialog to let the user select a menu location for your application by calling "maemo-select-menu-location" from your postinst script, but what many of you may not realize, is that doing just this will show the dialog again during updates even when the user has already selected a location, which can be quite irritating.

Thankfully there's a simple fix. Simply wrap the maemo-select-menu-location with an if statement to get something like this:

oldversion="$2"
if [ -z "$oldversion" ]; then
maemo-select-menu-location your.desktop
fi

Which will check to see if the package has been previously installed and suppress the folder selection dialog if it has.

For more information about these and packaging in general, see the hildon-application-manager packaging guide, the Maemo Packaging Policy, and the Debian Packaging Policy.

Comments:

1 2 3 4 5 6 next »
Andre Klapper
Karma: 1248

Note that "maemo-select-menu-location" is NOT available in Fremantle anymore. This refers to Diablo only.

2009-07-27 14:17 UTC
Ryan Abel
Karma: 1503

@Thomas

Mandatory by the package policy, then enforce it by going about and breaking the kneecaps of violators? :P

I suppose it might be possible to change the maemo-select-menu-location script to check if a menu location has been previously selected instead of checking in the postinst, but I'm not familiar enough with the process to say if that's workable. A question for Marius, I think.

2008-11-20 11:47 UTC
Eugene Antimirov
Karma: 356

XB-Maemo-Upgrade-Description is really great. I'll definitely add it to projects I maintain.

2008-11-20 09:42 UTC
Eugene Antimirov
Karma: 356

XB-Maemo-Upgrade-Description is really great. I'll definitely add it to projects I maintain.

2008-11-20 09:42 UTC
Thomas Perl
Karma: 2618

Can someone please make the "Selecting a menu location, but only when first installed" mandatory? Currently, some apps do this for every upgrade, which is annoying (especially the otherwise very helpful Easy Debian Chroot package).

2008-11-19 09:33 UTC
Benoît HERVIER
Karma: 1390

Hey great news than now changes can be registered in XB-Maemo-Upgrade-Description !

2008-11-17 19:37 UTC
1 2 3 4 5 6 next »

Comments:

You must be logged in to make comments.

Back