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-FE9017F4-4197-472F-A3E7-267169A51ABD" xml:lang="en"><title>Registration</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
12 <concept id="GUID-FE9017F4-4197-472F-A3E7-267169A51ABD" xml:lang="en"><title>Registration</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <p>You need to register your applications in order to make them visible |
13 <p>You need to register your applications in order to make them |
14 to the application menu and to provide other information to the underlying |
14 visible to the application menu and to provide other information to |
15 operating system. To register, you need to provide a registration resource |
15 the underlying operating system. To register, you need to provide |
16 file, typically named <parmname><application_name>_reg.rss</parmname> that |
16 a registration resource file, typically named <parmname><application_name>_reg.rss</parmname> that contains the non-localized information for your application. |
17 contains the non-localized information for your application. Examples of non-localized |
17 Examples of non-localized information include:</p> |
18 information include:</p> |
|
19 <ul> |
18 <ul> |
20 <li><p>UID of the application</p></li> |
19 <li><p>UID of the application</p></li> |
21 <li><p>name of the application executable, without an extension</p> |
20 <li><p>name of the application executable, without an extension</p> |
22 </li> |
21 </li> |
23 <li><p>application properties, such as embeddability or whether |
22 <li><p>application properties, such as embeddability or |
24 it is hidden</p></li> |
23 whether it is hidden</p></li> |
25 </ul> |
24 </ul> |
26 <p>For more information on how to create a registration file for the non-localized |
25 <p>For more information on how to create a registration file for |
27 information for your application, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating |
26 the non-localized information for your application, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating registration resource files</xref>. </p> |
28 registration resource files</xref>. </p> |
|
29 <p>You also need to provide localized information for your applications, |
27 <p>You also need to provide localized information for your applications, |
30 such as captions and icons. This is done by either including a name and path |
28 such as captions and icons. This is done by either including a name |
31 of a localizable icon and caption resource file or the symbolic ID of a <parmname>LOCALISABLE_APP_INFO</parmname> data |
29 and path of a localizable icon and caption resource file or the symbolic |
32 structure in your application UI resource file. For a discussion of the available |
30 ID of a <parmname>LOCALISABLE_APP_INFO</parmname> data structure in |
33 options for where you can place this resource statement, see <xref href="GUID-3F880EFC-E891-5C71-8360-1BBB54367AFA.dita">Localisable |
31 your application UI resource file. For information about localisable |
34 icon/caption definition files</xref>. </p> |
32 icons, see <b>Symbian^3 Tools Guide > Building</b>. </p> |
35 <p>You may define the following localized information:</p> |
33 <p>You may define the following localized information:</p> |
36 <ul> |
34 <ul> |
37 <li><p>application caption, which is typically displayed next to |
35 <li><p>application caption, which is typically displayed |
38 the icon in the application menu</p></li> |
36 next to the icon in the application menu</p></li> |
39 <li><p>short caption used by some mobile devices when screen space |
37 <li><p>short caption used by some mobile devices when screen |
40 is limited</p></li> |
38 space is limited</p></li> |
41 <li><p>name of the icon file</p></li> |
39 <li><p>name of the icon file</p></li> |
42 </ul> |
40 </ul> |
43 <p>For more information on using the <parmname>LOCALISABLE_APP_INFO</parmname> data |
41 <p>For more information on using the <parmname>LOCALISABLE_APP_INFO</parmname> data structure, see <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">Defining localizable registration information</xref></p> |
44 structure, see <xref href="GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita">Defining |
|
45 localizable registration information</xref></p> |
|
46 <note> |
42 <note> |
47 <p>You must compile both the non-localized information registration resource |
43 <p>You must compile both the non-localized information registration |
48 file and the localized information resource file and include the results in |
44 resource file and the localized information resource file and include |
49 your package file in order for your application to be registered in a mobile |
45 the results in your package file in order for your application to |
50 device.</p> |
46 be registered in a mobile device.</p> |
51 |
47 |
52 </note> |
48 </note> |
53 </conbody></concept> |
49 </conbody></concept> |