Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Localized folder names for application icons

From Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The article is believed to be still valid for the original topic scope.

Article Metadata
Created: User:Technical writer 2 (07 Jul 2006)
Last edited: lpvalente (20 Jul 2014)


Localized folder names for application icons.


Applications can select the Menu folder in which their icon will appear after installation. On S60 1st and 2nd Edition, the name of the folder is defined in AIF_DATA resource, in application information file (.aif) source:
   groupname = "Games";
On S60 3rd Edition, the definition is done in app. registration file (_reg.rsc) source:
    group_name = "Games";
Some of the names that can be used with the groupname (group_name) parameter are recognized as "localizable." When these are used, the icon is placed under a corresponding folder with a name localized for the current language in use. The set of localizable folder names varies between devices and S60 platform versions, but at least the following names are recognized by all S60 devices based on S60 2nd Edition, FP1 or newer:
Note however, that the same group name can be mapped to different folders on different devices. For example, some S60 3rd Edition devices map both "Tools" and "Configurations" to the "Tools" folder, while others map "Tools" to the default installation folder ("Extras", "My Own", or "Install", depending on the device). If the name is not a recognized group name and a folder with that (localized) name doesn't already exist, a new one is created.
Not all folders have a corresponding group name that can be used for localization. For example, using the group name "Office" in S60 3rd Edition will result in a new "Office" folder being created for languages other than English.
Because of these issues, it is generally recommended that applications use the default folder for their icons. Game applications can use "Games" as a group name since it works and is localizable for practically all S60 devices.
If an application needs to be installed in a folder that doesn't have a recognized group name — for example, "Office" — it is possible to localize the application registration file itself as a workaround, in a similar way as any other resource file. Below is an example registration file source for an application that is installed to the "Office" folder and supports English and French. In this case, the resource compiler would generate two versions of the registration file, _reg.r01 and _reg.r02.
    #if defined(LANGUAGE_01)       // English
    #else if defined(LANGUAGE_02) // French
    #else                          // Other languages

This page was last modified on 20 July 2014, at 19:11.
31 page views in the last 30 days.