|
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-2AB7F53A-5EDF-574D-866D-EF2592881559" xml:lang="en"><title>Configuring the SIF Launcher</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
13 <p>The SIF Launcher must be configured in the system ROM to ensure |
|
14 that the software management requests from the device user are understood |
|
15 by the SIF server. </p> |
|
16 <p> <b>Note:</b> When you configure the SIF Launcher, you must also |
|
17 ensure that the respective software types and installer information |
|
18 are present in the Software Component Registry (SCR) database. For |
|
19 more information, see the <xref href="GUID-016876C8-7E13-5A3E-9A15-992B7EEEEA38.dita">Software Component |
|
20 Registry</xref> section. </p> |
|
21 <p>You can configure the SIF launcher to customise the MIME types |
|
22 supported and the icons that UI-based clients may use for files recognised |
|
23 as software packages. Do this by modifying the <filepath>siflauncher_reg.rss</filepath> file located at <filepath>securityconfig/usif/siflauncher/</filepath>. </p> |
|
24 <p> <b>Note:</b> For more information about modifying <filepath>.rss</filepath> files, see <b>Symbian^3 Tools Guide > Building</b>.</p> |
|
25 <p>To customize the MIME types and icons for UI based clients, perform |
|
26 the following steps: </p> |
|
27 <ol id="GUID-5CE9F105-8CEC-5BA8-A9FD-C78FDF80CED8"> |
|
28 <li id="GUID-7849B967-44D8-5EF1-B790-6E2BF23A430A"><p>Open the <filepath>siflauncher_reg.rss</filepath> file located at <filepath>securityconfig/usif/siflauncher/</filepath>. </p> <codeblock id="GUID-A2314A0A-DFFE-5616-8380-D2C65985EF84" xml:space="preserve">// siflauncher_reg.rss |
|
29 // SIF Launcher application's registration resource file |
|
30 |
|
31 #include <appinfo.rh> |
|
32 |
|
33 UID2 KUidAppRegistrationResourceFile |
|
34 UID3 0x10285BD0 |
|
35 |
|
36 RESOURCE APP_REGISTRATION_INFO |
|
37 { |
|
38 app_file="siflauncher"; |
|
39 localisable_resource_file="\\resource\\apps\\siflauncher_loc"; |
|
40 |
|
41 hidden=KAppNotHidden; |
|
42 embeddability=KAppNotEmbeddable; |
|
43 newfile=KAppDoesNotSupportNewFile; |
|
44 datatype_list= |
|
45 { |
|
46 DATATYPE { priority=EDataTypePriorityHigh; type="x-epoc/x-sisx-app"; } |
|
47 }; |
|
48 }</codeblock> </li> |
|
49 <li id="GUID-2BF0D015-7426-5BB1-ADD4-279AF80AF60F"><p>Add the MIME |
|
50 type that you want to support in the <codeph>datatype_list</codeph> section. For example, if you want to support the MIME type, <codeph>x-adobe/x-flash-app</codeph>, you must add the following statement |
|
51 to the <codeph>datatype_list</codeph> section: </p> <codeblock id="GUID-96A6ED4C-3219-5C5A-A77B-4174ED81C6F5" xml:space="preserve">DATATYPE { priority=EDataTypePriorityHigh; type="x-adobe/x-flash-app"; }</codeblock> </li> |
|
52 <li id="GUID-2F1D42E0-04BC-56BC-A071-AC40167E3675"><p>Configure the |
|
53 icons for UI based clients using the <codeph>localisable_resource_file</codeph> statement in <filepath>siflauncher_loc.rss</filepath>. The file |
|
54 defined by this statement contains the icon configuration. </p> <p>For example: </p> <codeblock id="GUID-CD2A8079-81BD-5BB6-B4BA-777C0987C9AC" xml:space="preserve">//siflauncher_loc.rss |
|
55 #include <appinfo.rh> |
|
56 #include "siflauncher_loc.rls" |
|
57 |
|
58 RESOURCE LOCALISABLE_APP_INFO |
|
59 { |
|
60 short_caption = STRING_r_siflauncher_short_caption; |
|
61 caption_and_icon = |
|
62 { |
|
63 CAPTION_AND_ICON_INFO |
|
64 { |
|
65 caption=STRING_r_siflauncher_caption; |
|
66 number_of_icons=1; |
|
67 icon_file=STRING_r_siflauncher_icon_path; |
|
68 } |
|
69 }; |
|
70 }</codeblock> <p>The strings used in <filepath>siflauncher_loc.rss</filepath> are defined in <filepath>siflauncher_loc.rls</filepath>. </p> <codeblock id="GUID-41D2CCAA-93E6-5DC2-A352-FE985AE763DA" xml:space="preserve">//siflauncher_loc.rls |
|
71 |
|
72 rls_string STRING_r_siflauncher_icon_path "z:\\resource\\apps\\siflauncher.mbm" |
|
73 rls_string STRING_r_siflauncher__short_caption "USIF" |
|
74 rls_string STRING_r_siflauncher_caption "Universal Software Install Framework"</codeblock> </li> |
|
75 </ol> |
|
76 </conbody><related-links> |
|
77 <link href="GUID-34EF6527-14D0-5C8B-9E20-A3A3B3320054.dita"><linktext>SIF |
|
78 Overview</linktext></link> |
|
79 <link href="GUID-B2BD19A4-132E-5D5C-8870-04BADB6E7815.dita"><linktext>SIF |
|
80 Tutorial</linktext></link> |
|
81 </related-links></concept> |