Project

General

Profile

Linux setup » History » Version 1

Alexis Jeandet, 30/03/2014 05:30 PM

1 1 Alexis Jeandet
h1. Linux setup
2 1 Alexis Jeandet
3 1 Alexis Jeandet
{{>toc}}
4 1 Alexis Jeandet
5 1 Alexis Jeandet
*Please note that SocExplorer is still under development, so things are supposed to move, it can fail to build sometimes or be buggy.*
6 1 Alexis Jeandet
7 1 Alexis Jeandet
Note also that we recently change from Qt4 to Qt5 so all the new SocExplorer code will be written for Qt5.
8 1 Alexis Jeandet
9 1 Alexis Jeandet
h2. Prerequisites
10 1 Alexis Jeandet
11 1 Alexis Jeandet
All the next steps can be distribution dependent SocExplorer development is done on Fedora 19 and 20, but is should work with any other one, feedback are welcome!
12 1 Alexis Jeandet
13 1 Alexis Jeandet
* First you need a working linux machine with:
14 1 Alexis Jeandet
** Qt5 sdk installed on it plus all the developments packages for Qt. Remember also to install modules such as QtWebkit.
15 1 Alexis Jeandet
** Python 2.X with headers.
16 1 Alexis Jeandet
* Then you need to install PythonQt, a modified version for SocExplorer can be downloaded "here":https://hephaistos.lpp.polytechnique.fr/rhodecode/HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/PythonQt/archive/tip.zip
17 1 Alexis Jeandet
* To install PythonQt you just have to extract it somewhere, then from a terminal run:
18 1 Alexis Jeandet
<pre><code class="bash">
19 1 Alexis Jeandet
  qmake-qt5
20 1 Alexis Jeandet
  make 
21 1 Alexis Jeandet
  sudo make install
22 1 Alexis Jeandet
</code></pre>
23 1 Alexis Jeandet
24 1 Alexis Jeandet
h2. Building SocExplorer
25 1 Alexis Jeandet
26 1 Alexis Jeandet
* To build SocExplorer, once PythonQt is correctly build and installed you can get SocExplorer source code from code repository with this command:
27 1 Alexis Jeandet
<pre><code class="bash">
28 1 Alexis Jeandet
  hg clone https://hephaistos.lpp.polytechnique.fr/rhodecode/HG_REPOSITORIES/LPP/INSTRUMENTATION/SocExplorer SocExplorer
29 1 Alexis Jeandet
</code></pre>
30 1 Alexis Jeandet
You will get a SocExplorer directory with all the source code inside. To build it you just have to run:
31 1 Alexis Jeandet
<pre><code class="bash">
32 1 Alexis Jeandet
  cd SocExplorer
33 1 Alexis Jeandet
  qmake-qt5
34 1 Alexis Jeandet
  make  #note that to speedup the make step you can use "make -j N" to parallelize on N process(replace N with the number of cores you have).
35 1 Alexis Jeandet
36 1 Alexis Jeandet
</code></pre>
37 1 Alexis Jeandet
* Now you can install SocExplorer, it will install the SocExplorer binary plus some libraries and desktop icon in your system, just run:
38 1 Alexis Jeandet
<pre><code class="bash">
39 1 Alexis Jeandet
  sudo make install
40 1 Alexis Jeandet
  #this doesn't install the registers xml description file.
41 1 Alexis Jeandet
  mkdir -p ~/.SocExplorer/config
42 1 Alexis Jeandet
  cp ressources/Grlib.xml ~/.SocExplorer/config/Grlib.xml
43 1 Alexis Jeandet
</code></pre>
44 1 Alexis Jeandet
45 1 Alexis Jeandet
Affected folders are:
46 1 Alexis Jeandet
* /usr/bin for SocExplorer executables.
47 1 Alexis Jeandet
* QT_HEADERS_PATH/SocExplorer for SDK headers.
48 1 Alexis Jeandet
* QT_LIB_PATH for shared libraries.
49 1 Alexis Jeandet
* /usr/share/qtcreator/templates/wizards/SocExplorerPlugin for Qtcreator wizard.
50 1 Alexis Jeandet
* /usr/share/applications/ for desktop launcher.
51 1 Alexis Jeandet
* /etc/SocExplorer for global config files.
52 1 Alexis Jeandet
* ~/.SocExplorer for plugin and per user config files.
53 1 Alexis Jeandet
54 1 Alexis Jeandet
Now you should have a working SocExplorer, you can start to install plugins  "here":https://hephaistos.lpp.polytechnique.fr/rhodecode/HG_REPOSITORIES/LPP/INSTRUMENTATION/SocExplorerPlugins  or start write your own.