×
Namespaces

Variants
Actions

Localized folder names for application icons

From Nokia Developer 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
CompatibilityArticle
Created: User:Technical writer 2 (07 Jul 2006)
Last edited: lpvalente (20 Jul 2014)

Overview

Localized folder names for application icons.

Description

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:
RESOURCE AIF_DATA
    {
    …
   groupname = "Games";
    }
On S60 3rd Edition, the definition is done in app. registration file (_reg.rsc) source:
RESOURCE APP_REGISTRATION_INFO
    {
    …
    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:
Communications
Configurations
Games
SIM
Tools
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.
RESOURCE APP_REGISTRATION_INFO
    {
    ...
    #if defined(LANGUAGE_01)       // English
        group_name="Office";
    #else if defined(LANGUAGE_02) // French
        group_name="Bureau";
    #else                          // Other languages
        group_name="Office";
    #endif
    }

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

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×