Skip to content

Latest commit

 

History

History
120 lines (65 loc) · 4.13 KB

COMPILING.md

File metadata and controls

120 lines (65 loc) · 4.13 KB
Raw

Compiling S60Maps

This guide will describe you how to compile S60Maps project from sources on your computer. This may be usefull, for example, for translators to have a preview of their translations.

In this tutorial I will use Windows 7 and SDK S60 v3.1 (Symbian 9.2). I recommend to use this version of SDK, but you may install another one which you can found here.

Also works with Windows XP. Not sure about modern Windows versions. Anyway you can use virtual machine (like VirtualBox) if you use another OS (e.g., Linux).

Installation

Java Runtime Environment

If you already have Java Runtime Environment (JRE) installed you may skip this step. For download follow this link.

S60 SDK

Download S60 v3.1 SDK and unpack zip to any folder. Run setup.exe.

First Perl 5.6.1 setup will be run. Leave options as is.

After that installation of SDK will be started. Upon completion you will be asked about install compiling toolchine. Press Yes.

Carbide C++ IDE

Download and install Carbide.C++ v2.7 IDE.

After the install is complete start Carbide C++ IDE. At the first run you will be asked about workspace directory in which projects will be stored. You may leave it as default.

Also restart of IDE may be needed.

Git (optional)

It's recommended, but not necessary to have Git version control system installed.

Build project in Carbide C++ IDE

Import project to Carbide C++ IDE

  • If you use Git go to workspace directory C:\Symbian\Carbide\workspace and clone repository with --recurse-submodules option to load all submodules too:

    git clone --recurse-submodules https://github.com/artem78/s60-maps.git

    Swith to main development branch called develop:

    git checkout develop

  • If you are not use Git you may manualy download complete sources of last stable version from release page. In Asserts section find zip file named s60-maps_sources_vX.X.X.zip. Unpack its content to C:\Symbian\Carbide\workspace\s60-maps\ directory.

Go to Carbide IDE. Open File > Import. Select General > Existing Projects into Workspace and press Next.

Click Browse... button and choose S60Maps project directory.

Press Finish.

Build and run

There are two build modes:

  1. For emulator (WINSCW platform)
  2. For real phone (GCCE platform)

You can choose between them in Project > Build Configurations > Set Active.

Run in emulator

Set Emulator Debug (WINSCW) [S60_3rd_FP1] build mode and press Run button:

If compilation finished without errors emulator will be started with running S60Maps application:

Make SIS(X) installation package for phone

Set Phone Release (GCCE) [S60_3rd_FP1] build mode. Select Project > Build Project or Project > Clean... for force update all resources.

After successful compilation you will find S60Maps.sis (unsigned) and S60Maps.sisx (self-signed) files in sis folder.

How to?

Emulator trial reset

Emulator have 14 days trial period, but you can reset it unlimited number of times. Use this BAT-script or directly remove HKCU\Software\Nokia\Product Registration subtree in regedit.