Opened 10 years ago

Closed 8 years ago

#2925 closed task (fixed)

Getting started build documentation

Reported by: cypherpunks Owned by: chiiph
Priority: Low Milestone:
Component: Archived/Vidalia Version:
Severity: Keywords:
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


A step-by-step introduction to contributing code to projects. It should include recommended software, dependencies, platform-specific tips and pitfalls to avoid.

Child Tickets

Change History (5)

comment:1 Changed 9 years ago by sirop

I'll write something here in order not to forget it.

Ubuntu 11.10

Building Vidalia

$ mkdir build && cd build
$ export PATH=/path/to/Qt/lib:/path/to/Qt/include:$PATH
$ cmake -DQT_QMAKE_EXECUTABLE=/path/to/Qt/qmake ..
$ make

Building qtscriptgenerator-0.2.0

Fololow the README instructions. If you get some make errors when building qtbindings, consider .
./generator --include-paths=/usr/include/qt4
might help.
Reduce the build time excluding some plugin libs as we need only
qt , qt.core , qt.gui , qt.uitools . I did not try it out, but it should be possible with some qmake options.

Be sure to use the same version and the same build of Qt for both Vidalia and qtscriptgenerator.
I used qt-4.8.0 from QtSDK.

comment:2 Changed 9 years ago by chiiph

The export line isn't necessary, that is handled by qmake.

comment:3 Changed 9 years ago by sirop

Preparations for TBB plugins:

  1. Copy tbb [and thandy] folder from vidalia-plugins to /tor-browser/Data/plugins .
  1. Copy your libqtscript*.so to /tor-browser/App/script
  1. Add PluginPath=/tor-browser/Data/plugins line under General section

in Data/Vidalia/vidalia.conf .

  1. Start Tor Browser .
  1. You can change plugin Settings in the Plugin Tab.

comment:4 Changed 9 years ago by sirop

If one follows doc / getting-started.txt and

$ cmake -DUSE_MARBLE=1 \
        -DMARBLE_INCLUDE_DIR=~/marble/src/lib \
        -DMARBLE_DATA_DIR=~/marble/data \
        -DMARBLE_LIBRARY_DIR=~/marble/build/src/lib \
        -DMARBLE_PLUGIN_DIR=~/marble/build/src/plugins ..

cmake yields:

CMake Warning:
  Manually-specified variables were not used by the project:


comment:5 Changed 8 years ago by chiiph

Resolution: fixed
Status: newclosed

I've written a tutorial in my branch chiiph/getting_started_doc.

The branch has been merged to alpha. I will also put it in the wiki eventually.

Note: See TracTickets for help on using tickets.