Language +Dependent Files

Specific to +the languages supported by the Symbian device

Specify each of +the language-specific resource files within an IF conditional block and set +the SUPPORTED_LANGUAGE parameter to a TLanguage numerical value, as shown in the following code snippet:

+if supported_language=01 + "HelloWorld.r01" -"!: \ resource\apps\HelloWorld.r01" +endif + +if supported_language=02 + "HelloWorld.r02" -"!: \ resource\apps\HelloWorld.r02" +endif

During installation, the languages supported by the Symbian +device are matched with the languages supported in the SIS file. The result +is based on the following two conditions:

If an exact match is +found, the files corresponding to that language are copied to the Symbian +device.

For example, if the SIS file specifies UK English(01), French(02) +and Zulu(98), and the Symbian device supports only UK English(01) and French(02), +during installation, only the files related to UK English(01) and French(02) +are copied to the Symbian device. The files for Zulu(98) are not copied to +the Symbian device.
If an exact match is +not found for any of the device supported languages, the files for all equivalent +languages (supported by the SIS files) corresponding to each of the device +supported languages are copied to the Symbian device.

For example, +if the SIS file supports UK English(01), French(02) and International English(47), +and the Symbian device supports only American English(10) then during installation, +as an exact match for American English is not found, the files for UK English +and International English (both equivalent match) are copied to the Symbian +device. See Equivalent +Languages Reference for a list of all language equivalents supported +by Symbian Foundation.

Important:

Language-specific resource files must +have filenames with language-specific extensions. For example, the resource +files for UK English(01) must have the filename as Filename.r01.

If +you use the .rsc file extension, as shown in the following +code snippet, and if both the languages are supported on the Symbian device, +the resource files of UK English(01) are overwritten by resource files of +French (02) language during installation.

+if supported_language=01 //UK English + "HelloWorld.r01" -"!: \ resource\apps\HelloWorld.rsc" //do not use this extension format +endif + +if supported_language=02 //French + "HelloWorld.r02" -"!: \ resource\apps\HelloWorld.rsc" +endif

Specific to +the language selected by the Symbian device user

You can use one +of the following formats:

Format1
Format2

Format1

Specify each of the language-specific resource +files within an IF conditional block and set the LANGUAGE parameter +to a TLanguage +numerical value, as shown in the following code snippet:

+if language=01 + "HelloWorld.r01" -"!: \ resource\apps\HelloWorld.r01" +endif + +if language=02 + "HelloWorld.r02" -"!: \ resource\apps\HelloWorld.r02" +endif

During installation, Symbian device user is prompted +to select a language. Based on the selection, the resource files for the selected +language are installed.

For example, if the SIS file specifies UK +English(01) and French(02), Symbian device user is prompted to select UK English +or French language for installation. Based on the selection, the resource +files for the selected language are copied to the Symbian device.

If +the Symbian device supports only one language, the resource files for only +that language are installed. In this scenario the Symbian device user is not +prompted to select a language for installation.

Format2

The +syntax is as follows:

{"source-filename1", "source-filename2", ...} - "destination-filename"[, install-options]

For example:

{ +"examples\HelloWorld\HelloWorld.ruk" +"examples\HelloWorld\HelloWorld.rfr" +"examples\HelloWorld\HelloWorld.rzu" +}-"!:\resource\apps\HelloWorld.rsc"

For a description of each +argument, see Language-Neutral +Files.

The opening brace denotes +the start of the block of language-dependent files.
The order of the files +must be the same as the order in which the languages are specified in the +languages line.
The number of files +specified must be the same as the number of languages supported.
Install options can +be specified after the destination name, for example, FT to +display a language specific dialog.
Language dependent file +blocks, and other conditional blocks are evaluated at the end of the installation. +For example, the executables launched using FILERUN or FILEMIME statements +must not depend on conditionally installed or language-dependent files in +the same package file.

This format is commonly used to specify lists of resource files. +Resource files are installed to \resource\apps.

If +a resource file is to be accessed only by the application, it can be installed +to the application's private directory, \private\<process + SID>\. The SID (secure ID) is normally the same as the UID3, +which is specified in the MMP file.

An application +registration (resource) file is an exception. The applications built into +the ROM must provide their registration file in the z:\private\10003a3f\apps and +applications installed through Software Installer must locate their registration +file in \private\10003a3f\import\apps.

The +registration file in ROM must be located in z:\private\10003a3f\import\apps\ and +can be eclipsed.

Also, ECom registration resource files for ECom +plug-ins must be installed in \resource\plugins\.

Specific to +the languages supported by the Symbian device or language selected by Symbian +device user

Specify each of the language-specific resource files +within an IF conditional block and set the SUPPORTED_LANGUAGE and LANGUAGE parameters +to a TLanguage +numerical value separated by an OR condition, as shown +in the following code snippet:

+if supported_language=02 or language=02 + "HelloWorld.r01" -"!: \ resource\apps\HelloWorld.r01" +endif + +if supported_language=98 or language=98 + "HelloWorld.r98" -"!: \ resource\apps\HelloWorld.r98" +endif

Important: Language-specific resource files must +have filenames with language-specific extensions. For example, the resource +files for UK English(01) must have the filename as Filename.r01.

If +the SIS file does not include the Symbian device supported languages or its +equivalent, the Symbian device user is prompted to select a language. Based +on the selection, the files for the selected language are installed.

For +example, if the SIS file supports French(02) and Zulu(98), and the Symbian +device supports UK English(01) and German(03), the Symbian device user is +prompted to select French or Zulu language for installation. Based on the +selection, the files for the selected language are installed.

During +installation, if an exact or an equivalent language match is not found, the +Symbian device user is prompted to select a language. If you have not specified +the LANGUAGE parameter in PKG file, +as there is no resource file found for the selected language, no resource +files are installed. To avoid this, ensure that you always specify the LANGUAGE parameter +in the PKG file.