Howtos - Hack on Windows » History » Revision 42
Revision 41 (Greg Burri, 12/10/2010 08:18 PM) → Revision 42/102 (Greg Burri, 12/10/2010 10:22 PM)
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 .
# 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
## Edit @<Qt dir>\mingw\lib\gcc\mingw32\4.4.0\libstdc++.la@ and replace @library_names='libstdc++.dll.a'@ by @library_names='libstdc++.a'@
## Launch "Git Bash" and go to @/c/protobuf@ then type :
### @export MAKE=mingw32-make@
### @./configure@
### @mingw32-make@
## Add to your path this directory : @C:\protobuf\src\.libs@ 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.