Symbian3/SDK/Source/GUID-FE9017F4-4197-472F-A3E7-267169A51ABD.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
parent 7 51a74ef9ed63
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-FE9017F4-4197-472F-A3E7-267169A51ABD" xml:lang="en"><title>Registration</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>You need to register your applications in order to make them
visible to the application menu and to provide other information to
the underlying operating system. To register, you need to provide
a registration resource file, typically named <parmname>&lt;application_name&gt;_reg.rss</parmname> that contains the non-localized information for your application.
Examples of non-localized information include:</p>
<ul>
<li><p>UID of the application</p></li>
<li><p>name of the application executable, without an extension</p>
</li>
<li><p>application properties, such as embeddability or
whether it is hidden</p></li>
</ul>
<p>For more information on how to create a registration file for
the non-localized information for your application, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating registration resource files</xref>. </p>
<p>You also need to provide localized information for your applications,
such as captions and icons. This is done by either including a name
and path of a localizable icon and caption resource file or the symbolic
ID of a <parmname>LOCALISABLE_APP_INFO</parmname> data structure in
your application UI resource file. For information about localisable
icons, see <b>Symbian^3 Tools Guide &gt; Building</b>. </p>
<p>You may define the following localized information:</p>
<ul>
<li><p>application caption, which is typically displayed
next to the icon in the application menu</p></li>
<li><p>short caption used by some mobile devices when screen
space is limited</p></li>
<li><p>name of the icon file</p></li>
</ul>
<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>
<note>
<p>You must compile both the non-localized information registration
resource file and the localized information resource file and include
the results in your package file in order for your application to
be registered in a mobile device.</p>

</note>
</conbody></concept>