Starting from scratch, you will:
First make sure that qiBuild is installed correctly. (see Getting Started)
Open a console and type
qibuild --version
Then proceed with installing and configuring qibuild:
Also install CMake and the various tools for compiling
If you are using the latest Ubuntu, you should install python2 by hand first.
sudo apt-get install python
You need to chose a qibuild “worktree”.
This path will be the root from where qiBuild searches to find the sources of your projects.
In the following document, we will use the notation QI_WORK_TREE to refer to this path.
Then go to this directory and run
$ qibuild init
This will create a new qiBuild configuration file in your working directory, in QI_WORK_TREE/.qi/qibuild.xml.
This file contains settings that will only used by this worktree.
If you re-run qibuild config --wizard form a directory inside your worktree, the wizard will ask you if you want to configure settings for this worktree.
$ cd /path/to/worktree
$ qibuild init
$ qisrc create foo
$ qibuild configure foo
$ qibuild make foo
If everything is configured properly, you should be able to start the IDE by running:
$ qibuild open
Proceed with
See:
Follow the qibuild Programming guide
qicd is a small shell function that lets you jump quickly from one project to an other inside your worktree.
If you have access to bash shell, you can patch your config file in order to use qicd
function qicd {
p=$(python -m 'qicd' $1)
if [[ $? -ne 0 ]]; then
return
fi
cd ${p}
}
Here are a few messages you can get, and a possible solution.
Usually the best way to know what is going wrong it to have a look at the top of the error message, not the bottom...
qiBuild did not find cmake.exe. You have to make sure cmake.exe is in your PATH.
You can do so during CMake installation, or re-run qibuild config --wizard to help qiBuild find it.
qiBuild does not cope well with badly formatted XML.
For instance, if .config/qi/qibuild.xml, is invalid, you will get error messages like
Could not parse config from /home/user/.config/qi/qibuild.xml
Error was: Opening and ending tag mismatch: qibuild line 1 and ibuild, line 39, column 10
Here the best way to fix it is to edit the config file by hand, or remove it and re-run the config wizard.