7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
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-36751DD3-448E-5B94-B6BC-76EF6DE97C75" xml:lang="en"><title>EmbApp: |
12 <concept id="GUID-36751DD3-448E-5B94-B6BC-76EF6DE97C75" xml:lang="en"><title>EmbApp: An Embedded Application</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 An Embedded Application</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <section id="GUID-401D445D-010D-47D7-8AE8-EAB22C38736B"><title>Download</title> <p>Click on the following link to |
14 <section><title>Download</title> <p>Click on the following link to download |
14 download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-87d4afef-01ce-4913-8d1e-f8c3f896109c.zip" scope="external"> embedded.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-87d4afef-01ce-4913-8d1e-f8c3f896109c.html" scope="peer">browse</xref> to view the example code. </p> </section> |
15 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-87d4afef-01ce-4913-8d1e-f8c3f896109c.zip" scope="external"> embedded.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-87d4afef-01ce-4913-8d1e-f8c3f896109c.html" scope="peer">browse</xref> to view the example code. </p> </section> |
15 <section id="GUID-36CDD4D3-6B69-4776-9136-1B61EA0D1672"><title>Description</title> <p>This example comprises an embedded |
16 <section><title>Description</title> <p>This example comprises an embedded |
16 application (<filepath>embedded.dll</filepath>) and the stub (<filepath>embedded.exe</filepath>). The stub is essentially an empty executable |
17 application (<filepath>embedded.dll</filepath>) and the stub (<filepath>embedded.exe</filepath>). |
17 that launches the embedded application, which is wrapped up as an |
18 The stub is essentially an empty executable that launches the embedded application, |
18 ECOM plug-in. <filepath>Embedded.dll</filepath> builds on the <xref href="GUID-1D7BD70F-40A3-53FF-8150-A9CAFA4D01D8.dita">minimal</xref> UI |
19 which is wrapped up as an ECOM plug-in. <filepath>Embedded.dll</filepath> builds |
19 application. </p> <p>The application is defined in the registration |
20 on the <xref href="GUID-1D7BD70F-40A3-53FF-8150-A9CAFA4D01D8.dita">minimal</xref> UI |
20 file (<filepath>embedded_reg.rss</filepath>) as an embedded and/or |
21 application. </p> <p>The application is defined in the registration file (<filepath>embedded_reg.rss</filepath>) |
21 a stand-alone application: </p> <codeblock id="GUID-234F184B-21E6-5590-BC19-A60629F73580" xml:space="preserve">embeddability=KAppEmbeddable;</codeblock> <p>and <codeph>KAppEmbeddable</codeph> is defined in <filepath>appinfo.rh</filepath>. </p> </section> |
22 as an embedded and/or a stand-alone application: </p> <codeblock id="GUID-234F184B-21E6-5590-BC19-A60629F73580" xml:space="preserve">embeddability=KAppEmbeddable;</codeblock> <p>and <codeph>KAppEmbeddable</codeph> is defined in <filepath>appinfo.rh</filepath>. </p> </section> |
22 <section id="GUID-96B9474B-09F1-48C4-AE49-2AD678AAA702"><title>Class Summary</title><p><xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref></p><p><xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref></p><p><xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref></p><p><xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref></p></section> |
23 <section><title>Class Summary</title><p><xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref></p><p><xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref></p><p><xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref></p><p><xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref></p></section> |
23 <section id="GUID-02500E2F-3BE1-4004-A87B-696DD0C232EE"><title>Launching an application</title> <p> <codeph>EikStart::RunApplication(KAppEmbeddableUid)</codeph> launches the ECOM plugin using <codeph>KAppEmbeddableUid</codeph>. </p> </section> |
24 <section><title>Launching an application</title> <p> <codeph>EikStart::RunApplication(KAppEmbeddableUid)</codeph> launches |
24 <section id="GUID-E37FD0AF-E2DF-426F-8C7A-C0764EA935FA"><title>Build</title> <p>The Symbian build process describes |
25 the ECOM plugin using <codeph>KAppEmbeddableUid</codeph>. </p> </section> |
25 how to build an application. Using ECom plug-ins as a mechanism for |
26 |
26 delivering applications that can be embedded is discussed in <xref href="GUID-3CAD7211-2164-5F93-9EA7-7167E1C14012.dita">How to port guide: |
27 <section><title>Build</title> <p>The <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">Symbian |
27 apps to exes</xref>. </p> <p>The <filepath>EmbApp</filepath> example builds a plugin called <filepath>embedded.dll</filepath> and an executable called <filepath>embedded.exe</filepath> in the |
28 build process</xref> describes how to build an application. Using ECom plug-ins |
28 standard location (<filepath>\epoc32\release\winscw\</filepath> <i><build_variant></i> for CodeWarrior). Either launch the executable |
29 as a mechanism for delivering embeddable applications is discussed in <xref href="GUID-3CAD7211-2164-5F93-9EA7-7167E1C14012.dita">How to port guide: apps to |
29 itself, or launch the emulator and then select the <filepath>embedded</filepath> application from the Emulator's extras bar. </p> </section> |
30 exes</xref>. </p> <p>The <filepath>EmbApp</filepath> example builds a plugin |
|
31 called <filepath>embedded.dll</filepath> and an executable called <filepath>embedded.exe</filepath> in |
|
32 the standard location (<filepath>\epoc32\release\winscw\</filepath> <i><build_variant></i> for |
|
33 CodeWarrior). Either launch the executable itself, or launch the emulator |
|
34 and then select the <filepath>embedded</filepath> application from the Emulator's |
|
35 extras bar. </p> </section> |
|
36 </conbody></concept> |
30 </conbody></concept> |