Project

General

Profile

Howtos - Hack on Windows » History » Revision 38

Revision 37 (Adrien Crivelli, 11/27/2010 01:30 AM) → Revision 38/102 (Greg Burri, 12/08/2010 04:00 AM)

h1. Howtos 

 h2. Hack on Windows Seven 

 You need to : 

 # Install _Tortoise Git_ : http://code.google.com/p/tortoisegit/. 
 ## Kind of SSH Client : TortoisePLink 
 # Install _msysgit_ (needed by _Tortoise Git_) : http://code.google.com/p/msysgit/.  
 ## Use Unix style end line. 
 ## Do not install in "Program files" or in a path which contains spaces. We recommend to install in @C:\git@. 
 # If you want an access to the master repository : generate a RSA 2048 bit with _Puttygen_ (come with tortoisegit) and send it to a project manager. 
 # Install _Qt SDK_ (Qt creator is included) : http://get.qt.nokia.com/qtsdk/qt-sdk-win-opensource-2010.02.1.exe . 
 ## Copy and rename @C:\Qt\2010.02.1\mingw\bin\mingw32-make@ to @make@ (needed by protocol buffer). 
 # Add @C:\Qt\2010.02.1\mingw\bin;C:\Qt\2010.02.1\qt\bin@ to your _path_ environment variable. 
 # Install proto buff library source 
 ## Download the source zip here : http://code.google.com/p/protobuf/downloads/list and unzip in @C:\protobuf@ 
 ## Correct the file @subprocess.h@ as described here : http://code.google.com/p/protobuf/issues/detail?id=155 
 ## Launch "Git bash" and go to @/c/protobuf@ then type :  
 ### @./configure@ 
 ### @make@ 
 ## Add to your path this directory : @C:\protobuf\src@ to reach executable _protoc_. 
 ## For each component which uses protobuf, you have to define a Build Environment Variable @PROTOBUF@ set to @C:\protobuf@ 
 # Git clone the repository :  
 ## _git://dev.aybabtu.org/aybabtu.git_ if you just want clone the repository. 
 ## _ssh://git@dev.aybabtu.org/aybabtu.git_ if you have a full access (read+write). 
 # Generate the sources for the .proto files 
 ## Launch "Git bash" and go to @aybabtu/application@ 
 ## Type @./1.generate_proto_cpp.sh@ (each time you modify the .proto files you have to run this script) 
 # Set up _Qt Creator_ 
 ## TODO 

 h2. Hack on Linux 

 h3. ArchLinux 

 You need to : 

 # Install required programs 
 ## Git : pacman -S git 
 ## protobuf : pacman -S protobuf  
 ## Qt creator : pacman -S qtcreator 
 # Git clone the repository 
 ## _git://dev.aybabtu.org/aybabtu.git_ if you just want clone the repository. 
 ## _ssh://git@dev.aybabtu.org/aybabtu.git_ if you have a full access (read+write). 

 h3. Ubuntu 

 # Add @ppa:kubuntu-ppa/backports@ to Software Sources 
 # Get required tools<pre>sudo apt-get install g++ git qt4-qmake qt4-dev-tools 
 sudo apt-get install update 
 sudo apt-get install upgrade 
 sudo apt-get install dist-upgrade # to force the use of latests Qt libs 
 cd /tmp 
 wget http://protobuf.googlecode.com/files/protobuf-2.3.0.tar.bz2 
 tar -jxvf ./protobuf-2.3.0.tar.bz2 
 cd protobuf-2.3.0 
 ./configure --prefix=/usr 
 make 
 make check 
 sudo make install 
 </pre> 
 # Get source code<pre> 
 git clone git://dev.euphorik.ch/aybabtu.git aybabtu 
 cd aybabtu/application 
 ./0.regen_all.sh 
 </pre> 

 h2. Generate the documentation 

 The code documentation is generated with "Doxygen":http://www.doxygen.org. You must also install "Graphviz":http://graphviz.org/ to enable the diagram generation. 

 A daily generated documentation can be found here : http://doc.aybabtu.org ("errors":http://doc.aybabtu.ch/errors.txt). 

 To locally build the documentation you just have to install Doxygen and Graphviz. The configuration file is located here : source:/doc/doxygen/Doxyfile it can be opened by the graphic utility _Doxywizard_ or by the command line @doygen Doxyfile@. The documentation will be generated in @/doc/doxygen/html@. 


 h2. Profiling 

 h3. Windows 

 * Open a "Git Bash" command line (should be in the start menu). 
 * Go in @aybabtu/application@ 
 * Type @./2.compile_all_components.sh --prof --clean@, 'clean' is only necessary if the previous release compilation wasn't with the option '--prof'. 
 * Go in @aybabtu/application/Core/output/release@ for the Core or @aybabtu/application/GUI/output/release@ for the GUI. 
 * Launch the Core @AybabtuCore.exe -e@ 
 * Do the operations you want to measure. 
 * Type 'quit' to stop the Core. A file called 'gmon.out' should be created in the current folder. 
 * Type @gprof AybabtuCore.exe > prof.txt@. To generate a readable file. The file name can be anything you want, choose it wisely. 
 * Open 'prof.txt' with a text editor.