|
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-9F90A2F0-9C76-4871-A766-D1AE0FC42C08" xml:lang="en"><title>Defining |
|
13 localizable registration information</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>You need to register your applications in order to make them visible |
|
15 to the application menu and to provide other information to the underlying |
|
16 system. To register, you need to provide a <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">registration |
|
17 resource file</xref> that contains the non-localized information for your |
|
18 application. You also need to provide the localizable registration information. |
|
19 The registration resource file is compiled during the build process and included |
|
20 in the <xref href="GUID-7F1B2577-2FEF-45F9-B32F-745DFE0F0D95.dita"><parmname>pkg</parmname></xref> file |
|
21 used to make the file used to make the <parmname>sis</parmname> <xref href="GUID-61EE2BE0-7B86-42CD-A03F-857DD8FAC246.dita">installation |
|
22 file</xref>.</p> |
|
23 <p>Localizable registration information is defined in a <parmname>LOCALISABLE_APP_INFO</parmname> resource |
|
24 statement, which may be in a separate file or in the resource file for the |
|
25 GUI resources. For a discussion of the available options for where you can |
|
26 place this resource statement, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools/RegFiles/Tool_Guide_LocalisableIconFile.html#Tool_Guide_LocalisableIconFile" format="application/java-archive">Localisable |
|
27 icon/caption definition files</xref>.</p> |
|
28 <p>To define the localizable registration information:</p> |
|
29 <ol> |
|
30 <li id="GUID-A5E13549-C926-45ED-A081-165742AAF157"><p>Determine |
|
31 the requirements of your application, including deciding on whether the resource |
|
32 statement should be in its own file or part of the GUI resource file.</p> |
|
33 </li> |
|
34 <li id="GUID-B8106EC5-BDA0-4F59-B943-9B63895347EE"><p>Create a <parmname>LOCALISABLE_APP_INFO</parmname> resource. |
|
35 The data structure is declared in the <parmname>appinfo.rh</parmname> file |
|
36 in the <parmname>./epoc32/include</parmname> folder, as is the <parmname>CAPTION_AND_ICON_INFO</parmname> structure |
|
37 used in the resource. The syntax is as follows:</p> |
|
38 <itemgroup> |
|
39 <codeblock id="GUID-4A202ECA-380D-4FE2-AE41-3D1035F3FF7A" xml:space="preserve">RESOURCE LOCALISABLE_APP_INFO r_name36 |
|
40 { |
|
41 short_caption = ""; |
|
42 CAPTION_AND_ICON_INFO |
|
43 { |
|
44 caption = ""; |
|
45 number_of_icons =0; |
|
46 icon_file = ""; |
|
47 }; |
|
48 view_list[]; // VIEW_DATA |
|
49 group_name(KAppMaxGroupName) = ""; |
|
50 }</codeblock> |
|
51 <p>where</p> |
|
52 <ul> |
|
53 <li><p><parmname>r_name36</parmname> is the resource name that uniquely |
|
54 identifies this RESOURCE statement in the application, and is used in the <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">registration resource file</xref></p> |
|
55 </li> |
|
56 <li><p><parmname>short_caption</parmname> indicates a shortened |
|
57 version of the caption used by some UIs when screen space is limited</p> |
|
58 </li> |
|
59 <li><p><parmname>caption</parmname> indicates the caption used for |
|
60 the application on the grid and list menu.</p></li> |
|
61 <li><p><parmname>number_of_icons</parmname> indicates the number |
|
62 of icons used for the application in the menu</p></li> |
|
63 <li><p><parmname>icon_file</parmname> indicates the name of the |
|
64 file that contains the icon, including the path but not the drive name</p> |
|
65 </li> |
|
66 </ul> |
|
67 <p>For information on the other possible values, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools/RegFiles/Tool_Guide_LocalisableIconFile.html#Tool_Guide_LocalisableIconFile" format="application/java-archive">Localisable |
|
68 icon/caption definition files</xref>.</p> |
|
69 </itemgroup> |
|
70 </li> |
|
71 <li id="GUID-1F9CBCC9-B366-43E8-9ADB-E4AB6A255181"><p>Add the resource |
|
72 name of this resource to the <parmname>localisable_resource_id</parmname> in |
|
73 the registration resource file.</p></li> |
|
74 </ol> |
|
75 <p>For a commented example, see <xref href="GUID-6AD1DA34-EA3D-4EC9-A667-390507B4D6CB.dita">helloworldbasic.rss</xref>.</p> |
|
76 </conbody></concept> |