1 Compiling SILC Toolkit for Symbian OS
2 =====================================
4 The SILC Toolkit works on Symbian OS. This document is intended for those
5 that want to compile the SILC Toolkit by themselves for Symbian OS, or for
6 Symbian OS emulator. The building environment expects Carbide.c++ and
7 WINSCW compiler for emulator target and GCCE (variant of GCC) for device
8 target. The SILC Toolkit has not been tested with other compilers or
9 build systems. The build environment expects MS Windows.
12 Installing Build Environment
13 ============================
15 If you do not have a working Carbide.c++ and Symbian OS SDK environment
16 installed in your MS Windows system it needs to be done first.
18 1) Download the freely available Carbide.c++ Express from Nokia at
19 http://forum.nokia.com. The exact hyprelink location changes often, so
20 it is not referenced here. It is usually under "Tools and SDKs" link.
22 2) After installation a web browser is opened automatically by the
23 Carbide.c++ installer. Follow its instructions by installing the Perl,
24 CTags and the SDK. Perl and the SDK are required, but CTags is
25 optional and if necessary can be omitted.
27 3) The SILC Toolkit is generic C and C++ code and should work with any
28 SDK. If you don't have SDK already installed, install the latest
29 version you can find. The links to SDKs are found in the Carbide.c++
30 instructions after installation. If you already have SDK in your
31 system, you should use that.
33 4) After installation the environment should be ready for SILC Toolkit
37 Building with Carbide.c++
38 =========================
40 After starting the Carbide.c++, you should import one of the SILC Toolkit
41 projects under symbian/ directory in the SILC Toolkit package. Four
44 libsilc/ - SILC Core DLL
45 libsilcclient/ - SILC Client DLL
46 libsilc_static/ - SILC Core static library
47 libsilcclient_static/ - SILC Client static library
49 After loading the project, the first thing to do is to add a path variable
50 to define where the SILC Toolkit sources are located. Go to Window ->
51 Preferences. Then, go to General -> Workspace -> Linked Resources. Add
52 a new SILCROOT path variable. It should point to the drive and directory
53 where the extracted SILC Toolkit sources are located. For example, if you
54 extracted the SILC Toolkit package into C:\temp\silc-toolkit-1.1.5 the
55 SILCROOT should point to C:\temp. This needs to be done only once.
57 After that, the building is ready to begin. Choose the target you want
58 (emulator or device, debug or release version) and start building.