EmbApp: An Embedded Application

Download

Click on the following link to download the example: embedded.zip

Click: browse to view the example code.

Description

This example comprises an embedded application (embedded.dll) and the stub (embedded.exe). The stub is essentially an empty executable that launches the embedded application, which is wrapped up as an ECOM plug-in. Embedded.dll builds on the minimal UI application.

The application is defined in the registration file (embedded_reg.rss) as an embedded and/or a stand-alone application:

embeddability=KAppEmbeddable;

and KAppEmbeddable is defined in appinfo.rh.

Launching an application

EikStart::RunApplication(KAppEmbeddableUid) launches the ECOM plugin using KAppEmbeddableUid.

Build

The Symbian build process describes how to build an application. Using ECom plug-ins as a mechanism for delivering applications that can be embedded is discussed in How to port guide: apps to exes.

The EmbApp example builds a plugin called embedded.dll and an executable called embedded.exe in the standard location (\epoc32\release\winscw\ <build_variant> for CodeWarrior). Either launch the executable itself, or launch the emulator and then select the embedded application from the Emulator's extras bar.