How to start the emulator

There are two versions of the emulator: a release version and a debug version. The appropriate emulator can be started in the normal Windows way, by double left clicking on its executable file.

Where multiple emulators are installed on a single drive, the emulator launcher, epoc.bat starts the emulator that the EPOCROOT environment variable has been set to. This is called the active emulator. The active emulator may be started by double left clicking on the executable file, by double left clicking on the file epoc.bat, or it can be invoked from the command line.

Starting the emulator:

1. Locate the directory containing the release or debug emulator:

   release: .\epoc32\release\wins\urel\

   debug: .\epoc32\release\wins\udeb\

2. Run the emulator executable file epoc.exe. This launches the emulator and starts the standard GUI framework.

• Alternatively type epoc at the command line.

• The release emulator can also be started from the Windows start button: \Programs\Symbian 6.1 SDKs\.

• The debug and release emulators may also be launched from Visual Studio.

• Text console applications are provided for test demonstration purposes — the public APIs are not published. The necessary code to create an emulator console window is built into such applications, so they can be started by simply running their exe file from Windows.

To start the emulator from the emulator launcher:

1. Set the EPOCROOT environment variable to point to the directory which contains the emulator you wish to launch. This then becomes the active emulator.

2. Locate the directory containing the emulator launcher epoc.bat: .\epoc32\tools\epoc.bat

3. Run the emulator launcher file epoc.bat. This launches the active emulator.

• Alternatively type epoc at the command line.

• Different SDKs must be installed on the same drive.

• The root environment variable must not contain the drive letter.

• The executable can still be launched by double left clicking on the file.

How to configure the EPOCROOT environment variable.