vaikene.ee Git - evaf/blob - www/pswgen02.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html lang="et" xmlns="http://www.w3.org/1999/xhtml" xml:lang="et">
   3
   4     <head>
   5         <meta http-equiv="CONTENT-TYPE" content="text/html; charset=utf-8" />
   6         <title>eVaf Tutorial - 02 - Preparations</title>
   7         <meta name="Author" content="Enar Väikene" />
   8         <meta name="description" content="eVaf Tutorial" />
   9         <meta name="keywords" content="evaf c++ application development framework tutorial password generator" />
  10         <link rel="StyleSheet" href="evaf.css" type="text/css" media="all" />
  11     </head>
  12
  13     <body>
  14
  15         <p>Next: <a href="pswgen03.html">03 - Generator Module</a>, Previous: <a href="pswgen01.html">01 - Introduction</a></p>
  16
  17         <h1>eVaf Tutorial</h1>
  18
  19         <h2>02 - Preparations</h2>
  20
  21         <h3>Getting eVaf sources</h3>
  22
  23         <p>eVaf uses <a href="http://git-scm.com">git</a> as the version control system. If you don't have it installed
  24         yet, install it now.</p>
  25
  26         <p>Then open your favorite terminal program and go to the root directory for all your development projects.
  27         Clone the eVaf repository using the following command:</p>
  28
  29         <pre> $ <code>git clone http://www.vaikene.net/git/evaf</code></pre>
  30
  31         <p>This command downloads evaf sources into the sub-directory <tt>evaf</tt>.</p>
  32
  33         <h3>Qt, CMake, gcc</h3>
  34
  35         <p>Make sure that you have Qt version 4.6 and CMake version 2.6 or newer versions installed. If not, install
  36         them now.</p>
  37
  38         <p>The tutorial code is tested with gcc versions 4.4, 4.5 and 4.6.</p>
  39
  40         <h3>Existing PswGen application</h3>
  41
  42         <p>The code that we write in this tutorial already exists in the <tt>src/apps/PswGen</tt> directory. Delete
  43         or rename the existing PswGen application if you want to follow the tutorial and write a new application.
  44         Then create a new sub-directory called <tt>PswGen</tt> in the <tt>src/apps</tt> directory.</p>
  45
  46         <h3>If you are running Windows</h3>
  47
  48         <p>If you happen to be running Windows instead of Linux, then you still need git, CMake and Qt installed.
  49         The tutorial code is tested with Visual C++ 2010 Express and Visual Studio 2005 Professional editions.
  50         Use the <tt>Git Bash</tt> command prompt to clone the repository.</p>
  51
  52         <p>The code is fully portable and needs no changes to build on Windows. However, build commands itself
  53         have to be modified:</p>
  54
  55         <ol>
  56             <li>Use the <tt>Visual Studio NNNN Command Prompt</tt> to run build commands. Make sure that Qt and CMake
  57             binaries are in the path inside the command prompt;</li>
  58             <li>When running <tt>cmake</tt>, add the <tt>-G &quot;NMake Makefiles&quot;</tt> option to the
  59             <tt>cmake</tt> command;</li>
  60             <li>Use <tt>nmake</tt> command instead of <tt>make</tt>.</li>
  61         </ol>
  62
  63         <p>eVafGUI.exe command line options with directory names like <tt>--dataroot=&lt;path&gt;</tt> expect
  64         '/' as the directory separator even when running on Windows.</p>
  65
  66         <p>In the next section <a href="pswgen03.html">03 - Generator Module</a> we start writing the Generator module.</p>
  67
  68     </body>
  69
  70 </html>