|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-C99BA704-4E9F-482C-942F-1B4D7F385BD8" xml:lang="en"><title>HelloWorldBasic_reg.rss</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
13 <p>You need to register your applications in order to make them visible |
|
14 to the application launcher and to provide other information to the underlying |
|
15 system. To register, you need to provide a registration resource file, typically |
|
16 named <parmname><application_name>_reg.rss</parmname>, that contains the |
|
17 non-localized information for your application. This section contains an example |
|
18 of such a file.</p> |
|
19 <p>For more information on registration files in general, see <xref href="GUID-FE9017F4-4197-472F-A3E7-267169A51ABD.dita">Registration</xref>. </p> |
|
20 <p>For information on creating your own registration resource files, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating |
|
21 registration resource files</xref>.</p> |
|
22 <codeblock id="GUID-631DE04B-6396-4CAD-B428-3342D06BA732" xml:space="preserve">#include "Helloworldbasic.rls" |
|
23 </codeblock> |
|
24 <p>This pre-processor statement adds the <parmname>rls</parmname> project |
|
25 file that controls the strings loaded for different languages based on the |
|
26 Symbian platform language setting to the preprocessing path. For more information |
|
27 on localization, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization |
|
28 and localization</xref>.</p> |
|
29 <codeblock id="GUID-1081D8D5-FE34-4A9F-B335-32E9A809314F" xml:space="preserve">#include <appinfo.rh> |
|
30 </codeblock> |
|
31 <p>This preprocessor statement adds the resource header file that provides |
|
32 the data structure used for the <parmname>RESOURCE</parmname> statement in |
|
33 this registration resource file.</p> |
|
34 <codeblock id="GUID-C78D64EE-3ED7-4A8A-96C6-C048879F35C2" xml:space="preserve">#include <HelloWorldBasic.rsg> |
|
35 |
|
36 </codeblock> |
|
37 <p>This preprocessor statement adds the generated resource header file |
|
38 for the <i>HelloWorldBasic</i> application to the preprocessor path to allow |
|
39 access to the <parmname>R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO</parmname> resource.</p> |
|
40 <codeblock id="GUID-6921E324-DF9E-4646-9ED9-8139F1A7816A" xml:space="preserve">UID2 KUidAppRegistrationResourceFile |
|
41 </codeblock> |
|
42 <p>This required statement defines the UID2 value for a registration resource |
|
43 file. </p> |
|
44 <codeblock id="GUID-C3F02E64-0C14-4A31-BBC2-772021D3E833" xml:space="preserve">UID3 0xA000017F |
|
45 |
|
46 </codeblock> |
|
47 <p>This required statement defines the <xref href="GUID-EA05F9B6-52C7-4BD9-8B9A-4BA3456E70B5.dita">UID3</xref> of |
|
48 the application.</p> |
|
49 <codeblock id="GUID-CCFD588A-30DC-43ED-9AB1-AB2AC3A83079" xml:space="preserve">RESOURCE APP_REGISTRATION_INFO |
|
50 { |
|
51 app_file="HelloWorldBasic"; |
|
52 localisable_resource_file = STRING_r_helloworldbasic_loc_resource_file_1; |
|
53 localisable_resource_id = R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO; |
|
54 |
|
55 embeddability=KAppNotEmbeddable; |
|
56 newfile=KAppDoesNotSupportNewFile; |
|
57 } |
|
58 |
|
59 </codeblock> |
|
60 <p>This <parmname>RESOURCE</parmname> definition contains the non-localizable |
|
61 properties of the <i>HelloWorldBasic</i> application, where</p> |
|
62 <ul> |
|
63 <li><p><parmname>HelloWorldBasic</parmname> is the name of the application |
|
64 executable</p></li> |
|
65 <li><p><parmname>STRING_r_helloworldbasic_loc_resource_file_1</parmname> contains |
|
66 the value <parmname>\\resource\\apps\\HelloWorldBasic</parmname> in all <parmname>rls</parmname> files. |
|
67 This is the location of the <i>HelloWorldBasic</i> resource files.</p> |
|
68 </li> |
|
69 <li><p><parmname>R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO</parmname> is |
|
70 the identifier for the resource declared in <parmname>helloworldbasic.rss</parmname> that |
|
71 contains the short caption, caption, and icon information</p></li> |
|
72 <li><p><parmname>KAppNotEmbeddable</parmname> indicates that <i>HelloWorldBasic</i> is |
|
73 not embeddable</p></li> |
|
74 <li><p><parmname>KAppDoesNotSupportNewFile</parmname> indicates |
|
75 that <i>HelloWorldBasic</i> does not support new files</p></li> |
|
76 </ul> |
|
77 </conbody></concept> |