3. Configure and build

Prev		Next

Locate the file config/config.mak-example in KeyValue's home directory. Make a copy named config.mak and edit it with a text editor. The file contains detailed explanations.

We emphasize one particular instruction presented in the file. If you are not yet familiar with KeyValue, then leave the variables FELIBS_debug and FELIBS_release as they are. This allows for the building of the add-in used in Section 4.

On Bash Shell console, go to KeyValue's home directory. For instance, assuming KeyValue was unpacked in /home/cassio/keyvalue, type

$ cd /home/cassio/keyvalue

Under Cygwin one has to prefix the directory name by the drive letter. Supposing that KeyValue was unpacked in C:\Users\cassio\Documents\keyvalue, type

$ cd C:/Users/cassio/Documents/keyvalue

To build the debug version (the default):

$ make

To build the release version:

$ make release

Additionally, make accepts other targets. To get a list of those targets:

$ make help

It also shows the list of projects to be compiled as chosen in config.mak.

For users, the most important targets are clean, debug and release. Other targets are more relevant for KeyValue developers and may not work for regular users. They are covered in KeyValue Developer's Manual.

3.1. Using Microsoft Visual Studio 2008 IDE

Microsoft Visual Studio 2008 users will find target sln very helpful. The command

$ make sln

creates a Microsoft Visual Studio 2008 solution (keyvalue.sln) and project files which allows for using Microsoft Visual Studio IDE, liberating users from direct calling make on Cygwin. Two configurations, debug and release, are set in keyvalue.sln.

Open keyvalue.sln. On the solution explorer (Ctrl+Alt+L), we see the projects. Initially, the start up project will be the first on alphabetic order. Change it to either excel-addin or openoffice-addin: Right click on the project name and then on Set as StartUp Project.

To configure excel-addin and openoffice-addin projects to call the appropriate applications under the debugger:

Right click on excel-addin project, select Properties and then Debugging. Edit the fields following the example shown in Table 1.

Table 1. Configuring MSVC debugger for *excel-addin.*
Field	Content
Command	Full path of Excel executable (e.g. `C:\Program Files\Microsoft Office\Office12\EXCEL.EXE`)
Command Arguments	`out\windows-msvc-debug\keyvalue.xll`

Right click on openoffice-addin project, select Properties and then Debugging. Edit the fields following the example shown in Table 2.

Table 2. Configuring MSVC debugger for *openoffice-addin.*
Field	Content
Command	Full path of soffice executable (e.g. `C:\Program Files\OpenOffice.org 3\program\soffice.bin`)
Command Arguments	`-nologo -calc`
Environment	`PATH=C:\Program Files\OpenOffice.org 3\program;C:\Program Files\OpenOffice.org 3\URE\bin;C:\Program Files\OpenOffice.org 3\Basis\program`