|
||
This format is used to specify a list of files, of which only one will be installed, depending on the language selected by the user during installation:
{"source-filename1", "source-filename2", ...} - "destination-filename"[, install-options]
For a description of each argument, see Installing language independent files.
This format is commonly used to specify lists of resource files. Resource
files are installed to \resource\apps\appname.rsc
.
If a resource file is to be accessed only by the application itself, 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's registration (resource) file is an exception:
applications built into the ROM must provide their registration file in the
z:\private\10003a3f\apps
directory, whilst applications installed
via Software Install must locate their registration file in
\private\10003a3f\import\apps
. Note that in order for a
registration file in ROM to be eclipsable, it must be located instead in
z:\private\10003a3f\import\apps\
.
Also, ECom registration resource files for ECom plugins should be
installed to the \resource\plugins\
directory.
An example install-files
statement is:
{
"examples\HelloWorld\HelloWorld.ruk"
"examples\HelloWorld\HelloWorld.rfr"
"examples\HelloWorld\HelloWorld.rzu"
}-"!:\resource\apps\HelloWorld.rsc"
For an example in a PKG file, see:
examples\ToolsAndUtilities\Localise\HelloWorld.pkg
In the example above, three compiled resource files are included in the
SIS file, but only one will be installed on the phone. Whichever language is
chosen, the installed resource file will be renamed to
HelloWorld.rsc
.
Language dependent file blocks, and other
conditional blocks are evaluated
at the end of the installation. This means for instance that executables
launched using FILERUN
or FILEMIME
statements must
not depend on conditionally installed or language-dependent files in the same
package file.
The opening brace denotes the start of the block of language-dependent files.
The order of the files should be the same as the order in which the languages were specified in the languages line
The number of files specified must be the same as the number of languages supported.
Install options may be specified after the destination name, as
documented in the language-independent files section, for example, FT
to display a language
specific dialog.