# Getting started with qibuild on Linux ¶

## Installing the compiler tools ¶

On ubuntu, this looks like



$sudo apt-get install cmake build-essential  Refer to the documentation of your distribution for the details. ## First run ¶ You should run $ qibuild config --wizard



A file will be generated in  ~/.config/qi/qibuild.xml  . It is shared by all the worktrees you will create.

You will be asked to choose a CMake generator.

It is advised to select  Unix Makefiles  unless you know what you are doing :)

## Building with Eclipse CDT ¶

Eclipse supports having distinct directories for the source and the build, but does not like if the later is a subdirectory of the former.

So you have to use a global build directory, by editing  QI_WORK_TREE/.qi/qibuild.xml  to have



<qibuild version="1">
<build build_dir="/path/to/build/directory" />
</qibuild>



Your project build directory will then be  /path/to/build/directory/build-<config>/<project-name>  .

Or, if you chose a relative path, it will be relative to the worktree.

You can also run  qibuild config --wizard  like this:



$qibuild config --wizard :: Do you want to configure settings for this worktree (Y/n) y :: Do you want to use a unique build dir (mandatory when using Eclipse) (y/N) y :: Path to a build directory ~/workspace/build Will use /home/john/workspace/build as a root for all build directories  $ cd QI_WORK_TREE
\$ qibuild configure



Then from within eclipse, go to “File -> Import” then choose “General -> General Projects into Workspace” and select your build directory as “root directory”. Let the “Copy projects into workspace” box unchecked and click “Finish”.