7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-2B7F7484-3A44-4A96-9B5D-79DF8A09115A" xml:lang="en"><title>How resource |
12 <concept id="GUID-2B7F7484-3A44-4A96-9B5D-79DF8A09115A" xml:lang="en"><title>How resource files work</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 files work</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>In the Symbian platform, <xref href="GUID-5F749184-C804-41FC-BA81-038783BDC967.dita">resource</xref> files |
13 <p>In the Symbian platform, <xref href="GUID-5F749184-C804-41FC-BA81-038783BDC967.dita">resource</xref> files |
15 are used to define UI components used in applications. See <xref href="GUID-0FB60233-993A-4BF2-9E8C-E03AD092359B.dita">Managing |
14 are used to define UI components used in applications. See <xref href="GUID-0FB60233-993A-4BF2-9E8C-E03AD092359B.dita">Managing resource |
16 resource files</xref> for information on defining the data structure.</p> |
15 files</xref> for information on defining the data structure.</p> |
17 <p>The following resource files are typically used as source files in Symbian |
16 <p>The following resource files are typically used as source files |
18 applications:</p> |
17 in Symbian applications:</p> |
19 <ul> |
18 <ul> |
20 <li><p><codeph>.rss</codeph> – resource source files used for UI |
19 <li><p><codeph>.rss</codeph> – resource source files used |
21 components in the application. For more information, see <xref href="GUID-EC49B54F-7724-433B-BD7F-201DE3B7DAA6.dita">Resource |
20 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> |
22 file structure</xref>, <xref href="GUID-23A60DE7-B72D-41BD-9F1E-882D31A7E3C7.dita">Required |
|
23 resource file statements</xref>, and <xref href="GUID-2C74E932-B1CA-434B-AF96-66D52D689620.dita">Optional |
|
24 resource file statements</xref>.</p> |
|
25 </li> |
21 </li> |
26 <li><p><codeph>_reg.rss</codeph> – resource source file used for |
22 <li><p><codeph>_reg.rss</codeph> – resource source file |
27 registration. For more information, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating |
23 used for registration. For more information, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating registration resource files</xref>.</p> |
28 registration resource files</xref>.</p> |
|
29 </li> |
24 </li> |
30 <li><p><codeph>.hrh</codeph> – resource header file used to define |
25 <li><p><codeph>.hrh</codeph> – resource header file used |
31 enumerated sets of values. For more information, see <xref href="GUID-D52E98C3-F5EE-4CE1-A4F5-2EF41A066B8A.dita">Creating |
26 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> |
32 resource header files</xref>.</p> |
|
33 </li> |
27 </li> |
34 <li><p><codeph>.rls</codeph> – localization files used as a source |
28 <li><p><codeph>.rls</codeph> – localization files used as |
35 for UI texts strings in applications, and for managing these texts. For more |
29 a source for UI texts strings in applications, and for managing these |
36 information, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization |
30 texts. For more information, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization |
37 and localization</xref>.</p> |
31 and localization</xref>.</p> |
38 </li> |
32 </li> |
39 </ul> |
33 </ul> |
40 <p>The structures and symbolic IDs of the files are used in various ways |
34 <p>The structures and symbolic IDs of the files are used in various |
41 in your code.</p> |
35 ways in your code.</p> |
42 <p> The resource files above are then compiled to yield the following files:</p> |
36 <p> The resource files above are then compiled to yield the following |
|
37 files:</p> |
43 <ul> |
38 <ul> |
44 <li><p><codeph>.rsc</codeph> or <parmname>rNN</parmname>, where |
39 <li><p><codeph>.rsc</codeph> or <parmname>rNN</parmname>, where NN is a two number Symbian locale ID - compiled, machine-readable |
45 NN is a two number Symbian locale ID - compiled, machine-readable resource |
40 resource files used by the application.</p></li> |
46 files used by the application.</p></li> |
41 <li><p><codeph>.rsg</codeph> - generated resource header |
47 <li><p><codeph>.rsg</codeph> - generated resource header file containing |
42 file containing the symbolic IDs of the resources for inclusion into |
48 the symbolic IDs of the resources for inclusion into your code.</p></li> |
43 your code.</p></li> |
49 <li><p><codeph> _reg.rsc</codeph> or <parmname>_reg.rNN</parmname>, |
44 <li><p><codeph> _reg.rsc</codeph> or <parmname>_reg.rNN</parmname>, where NN is a two number Symbian locale ID - compiled, machine-readable |
50 where NN is a two number Symbian locale ID - compiled, machine-readable resource |
45 resource file used for registration .</p></li> |
51 file used for registration .</p></li> |
|
52 </ul> |
46 </ul> |
53 |
47 |
54 <p>The <parmname>rsc</parmname>, <parmname>rNN</parmname>, |
48 <p>The <parmname>rsc</parmname>, <parmname>rNN</parmname>, and <parmname>_reg.rsc</parmname> files |
55 and <parmname>_reg.rsc</parmname> files need to be included in your <parmname>.sis</parmname> installation |
49 need to be included in your <parmname>.sis</parmname> installation |
56 file so that they are placed in the device when the application is installed.</p> |
50 file so that they are placed in the device when the application is |
|
51 installed.</p> |
57 |
52 |
58 <p>When the application framework launches an application, it loads the |
53 <p>When the application framework launches an application, it loads |
59 application resource file. The application framework compares the system locale |
54 the application resource file. The application framework compares |
60 language setting with the available resource files, and loads the resource |
55 the system locale language setting with the available resource files, |
61 file whose extension matches the locale language code. If there is no match, |
56 and loads the resource file whose extension matches the locale language |
62 then the system loads the resource file with the <parmname>.rsc</parmname>.</p> |
57 code. If there is no match, then the system loads the resource file |
|
58 with the <parmname>.rsc</parmname>.</p> |
63 </conbody></concept> |
59 </conbody></concept> |