<?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-C99BA704-4E9F-482C-942F-1B4D7F385BD8" xml:lang="en"><title>HelloWorldBasic_reg.rss</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>You need to register your applications in order to make them visible
to the application launcher and to provide other information to the underlying
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. This section contains an example
of such a file.</p>
<p>For more information on registration files in general, see <xref href="GUID-FE9017F4-4197-472F-A3E7-267169A51ABD.dita">Registration</xref>. </p>
<p>For information on creating your own registration resource files, see <xref href="GUID-BF1AAA0D-DF2F-4E1D-A0D2-F419BD32F97A.dita">Creating registration resource files</xref>.</p>
<codeblock id="GUID-631DE04B-6396-4CAD-B428-3342D06BA732" xml:space="preserve">#include "Helloworldbasic.rls"
</codeblock>
<p>This pre-processor statement adds the <parmname>rls</parmname> project
file that controls the strings loaded for different languages based on the
Symbian platform language setting to the preprocessing path. For more information
on localization, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization
and localization</xref>.</p>
<codeblock id="GUID-1081D8D5-FE34-4A9F-B335-32E9A809314F" xml:space="preserve">#include  &lt;appinfo.rh&gt;
</codeblock>
<p>This preprocessor statement adds the resource header file that provides
the data structure used for the <parmname>RESOURCE</parmname> statement in
this registration resource file.</p>
<codeblock id="GUID-C78D64EE-3ED7-4A8A-96C6-C048879F35C2" xml:space="preserve">#include  &lt;HelloWorldBasic.rsg&gt;

</codeblock>
<p>This preprocessor statement adds the generated resource header file
for the <i>HelloWorldBasic</i> application to the preprocessor path to allow
access to the <parmname>R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO</parmname> resource.</p>
<codeblock id="GUID-6921E324-DF9E-4646-9ED9-8139F1A7816A" xml:space="preserve">UID2 KUidAppRegistrationResourceFile
</codeblock>
<p>This required statement defines the UID2 value for a registration resource
file. </p>
<codeblock id="GUID-C3F02E64-0C14-4A31-BBC2-772021D3E833" xml:space="preserve">UID3 0xA000017F

</codeblock>
<p>This required statement defines the <xref href="GUID-EA05F9B6-52C7-4BD9-8B9A-4BA3456E70B5.dita">UID3</xref> of
the application.</p>
<codeblock id="GUID-CCFD588A-30DC-43ED-9AB1-AB2AC3A83079" xml:space="preserve">RESOURCE APP_REGISTRATION_INFO
  {
  app_file="HelloWorldBasic";
  localisable_resource_file =  STRING_r_helloworldbasic_loc_resource_file_1;
  localisable_resource_id = R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO;

  embeddability=KAppNotEmbeddable;
  newfile=KAppDoesNotSupportNewFile;
  }

</codeblock>
<p>This <parmname>RESOURCE</parmname> definition contains the non-localizable
properties of the <i>HelloWorldBasic</i> application, where</p>
<ul>
<li><p><parmname>HelloWorldBasic</parmname> is the name of the application
executable</p></li>
<li><p><parmname>STRING_r_helloworldbasic_loc_resource_file_1</parmname> contains
the value <parmname>\\resource\\apps\\HelloWorldBasic</parmname> in all <parmname>rls</parmname> files.
This is the location of the <i>HelloWorldBasic</i> resource files.</p>
</li>
<li><p><parmname>R_HELLOWORLDBASIC_LOCALISABLE_APP_INFO</parmname> is
the identifier for the resource declared in <parmname>helloworldbasic.rss</parmname> that
contains the short caption, caption, and icon information</p></li>
<li><p><parmname>KAppNotEmbeddable</parmname> indicates that <i>HelloWorldBasic</i> is
not embeddable</p></li>
<li><p><parmname>KAppDoesNotSupportNewFile</parmname> indicates
that <i>HelloWorldBasic</i> does not support new files</p></li>
</ul>
</conbody></concept>