Symbian3/SDK/Source/GUID-2B7F7484-3A44-4A96-9B5D-79DF8A09115A.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Wed, 31 Mar 2010 11:11:55 +0100
changeset 7 51a74ef9ed63
child 13 48780e181b38
permissions -rw-r--r--
Week 12 contribution of API Specs and fix SDK submission

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-2B7F7484-3A44-4A96-9B5D-79DF8A09115A" xml:lang="en"><title>How resource
files work</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>In the Symbian platform, <xref href="GUID-5F749184-C804-41FC-BA81-038783BDC967.dita">resource</xref> files
are used to define UI components used in applications. See <xref href="GUID-0FB60233-993A-4BF2-9E8C-E03AD092359B.dita">Managing
resource files</xref> for information on defining the data structure.</p>
<p>The following resource files are typically used as source files in Symbian
applications:</p>
<ul>
<li><p><codeph>.rss</codeph> – resource source files used for UI
components in the application. For more information, see <xref href="GUID-EC49B54F-7724-433B-BD7F-201DE3B7DAA6.dita">Resource
file structure</xref>, <xref href="GUID-23A60DE7-B72D-41BD-9F1E-882D31A7E3C7.dita">Required
resource file statements</xref>, and <xref href="GUID-2C74E932-B1CA-434B-AF96-66D52D689620.dita">Optional
resource file statements</xref>.</p>
</li>
<li><p><codeph>_reg.rss</codeph> – resource source file used for
registration. For more information, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating
registration resource files</xref>.</p>
</li>
<li><p><codeph>.hrh</codeph> – resource header file used to define
enumerated sets of values. For more information, see <xref href="GUID-D52E98C3-F5EE-4CE1-A4F5-2EF41A066B8A.dita">Creating
resource header files</xref>.</p>
</li>
<li><p><codeph>.rls</codeph> – localization files used as a source
for UI texts strings in applications, and for managing these texts. For more
information, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization
and localization</xref>.</p>
</li>
</ul>
<p>The structures and symbolic IDs of the files are used in various ways
in your code.</p>
<p> The resource files above are then compiled to yield the following files:</p>
<ul>
<li><p><codeph>.rsc</codeph> or <parmname>rNN</parmname>, where
NN is a two number Symbian locale ID - compiled, machine-readable resource
files used by the application.</p></li>
<li><p><codeph>.rsg</codeph> - generated resource header file containing
the symbolic IDs of the resources for inclusion into your code.</p></li>
<li><p><codeph> _reg.rsc</codeph> or <parmname>_reg.rNN</parmname>,
where NN is a two number Symbian locale ID - compiled, machine-readable resource
file used for registration .</p></li>
</ul>

<p>The <parmname>rsc</parmname>, <parmname>rNN</parmname>,
and <parmname>_reg.rsc</parmname> files need to be included in your <parmname>.sis</parmname> installation
file so that they are placed in the device when the application is installed.</p>

<p>When the application framework launches an application, it loads the
application resource file. The application framework compares the system locale
language setting with the available resource files, and loads the resource
file whose extension matches the locale language code. If there is no match,
then the system loads the resource file with the <parmname>.rsc</parmname>.</p>
</conbody></concept>