Next: 03 - Generator Module, Previous: 01 - Introduction

eVaf Tutorial

02 - Preparations

Getting eVaf sources

eVaf uses git as the version control system. If you don't have it installed yet, install it now.

Then open your favorite terminal program and go to the root directory for all your development projects. Clone the eVaf repository using the following command:

 $ git clone

This command downloads evaf sources into the sub-directory evaf.

Qt, CMake, gcc

Make sure that you have Qt version 4.6 and CMake version 2.6 or newer versions installed. If not, install them now.

The tutorial code is tested with gcc versions 4.4, 4.5 and 4.6.

Existing PswGen application

The code that we write in this tutorial already exists in the src/apps/PswGen directory. Delete or rename the existing PswGen application if you want to follow the tutorial and write a new application. Then create a new sub-directory called PswGen in the src/apps directory.

If you are running Windows

If you happen to be running Windows instead of Linux, then you still need git, CMake and Qt installed. The tutorial code is tested with Visual C++ 2010 Express and Visual Studio 2005 Professional editions. Use the Git Bash command prompt to clone the repository.

The code is fully portable and needs no changes to build on Windows. However, build commands itself have to be modified:

  1. Use the Visual Studio NNNN Command Prompt to run build commands. Make sure that Qt and CMake binaries are in the path inside the command prompt;
  2. When running cmake, add the -G "NMake Makefiles" option to the cmake command;
  3. Use nmake command instead of make.

eVafGUI.exe command line options with directory names like --dataroot=<path> expect '/' as the directory separator even when running on Windows.

In the next section 03 - Generator Module we start writing the Generator module.