Running an Example Application in the SDK Emulator

To run the example application that you have built on the S60 SDK emulator, perform the following steps:

  1. Run the emulator by entering the following command in the command prompt:

epoc

This opens the emulator:

Figure: The emulator initial screen

Note: It may take a while for the application icons to appear on the emulator screen.

  1. To open the application you have created, navigate first to the Installed folder with the five-way navigation key:

Figure: Installed folder

Open the Installed folder either by

  1. Once the Installed folder has been opened, use the five-way navigation key to locate the icon of the application in question (in this case Hello World Basic):

Figure: Hello World Basic application icon on the emulator application grid

  1. Click the left soft key under Options. The following menu is displayed on the emulator screen:

Figure: Hello World Basic menu options

You can scroll the menu options with the five-way navigation key and select them by clicking OK or Select (right soft key).

  1. With Open highlighted on the menu (see figure above), click the center of the five-way navigation key or the left soft key under Select to open the Hello World Basic application.

The Hello World Basic initial display appears:

Figure: Hello World Basic initial display

  1. Click the left soft key under Options.

The following menu is displayed:

Figure: Hello World Basic application menu

  1. With Hello highlighted in the menu, click the left soft key under Select.

The following screen is displayed:

Figure: Hello!

The "Hello!" message is, in effect, what the Hello World Basic application consists of from the user's point of view. Once the message clears from the screen you can view it again by clicking the left soft key under Options and going through steps 5 and 6 again.

Once you return to the emulator's content display screen, feel free to explore the emulator and its functionality. The emulator works like a real S60 device: click the keys in the emulator as you would press the keys on a real device. Use the five-way navigation key to select applications and open them by clicking the center of the five-way navigation key or Select under the left soft key. Exiting applications happens typically by clicking the right soft key.

Note: With a multi-SDK installation, the epoc command is an SDK-independent stub that launches the emulator application for the SDK device that is currently set as the default. Make sure that you are using the appropriate default device, as described in the Building and Running Example Applications from a Command Line Session section.

It is also possible to start the emulator from the Start menu by selecting, for example, Start > Programs > S60 Developer Tools > 3rd Edition SDK > Emulator. This will start the designated emulator application regardless of the current device settings.