This is an old revision of the document!
First of all, we must install all build Mixxx dependencies (read about it Compiling on Linux).
Keep in mind, that SCons is written to work with any Python version >= 2.4 and < 3.0. So, you must have one installed in your system.
Of course, you must have your favorite Qt Creator (can get here: http://qt-project.org/downloads).
Now, easiest way to get Mixxx sources is to download it (http://downloads.mixxx.org/mixxx-1.10.1/mixxx-1.10.1-src.tar.gz), but also, if you like, you can download sources from trunk, using bzr from Launchpad:
bzr branch lp:mixxx
If you downloaded
.tar.gz-file, you can use the
tar command from the shell to unpack it.
tar -xzf rebol.tar.gz
The result will be a new directory containing the files. Also, on many systems, when you download the
.tar.gz from a web browser, an un-packer will open, and you can just use that.
In Qt Creator you must:
After this, Qt Creator will add four files to the top-level directory:
$PROJECT_NAME.files $PROJECT_NAME.includes $PROJECT_NAME.config $PROJECT_NAME.creator
The most important one is
$PROJECT_NAME.files, which is just a list of all the files you want to show in the IDE. Here you can exclude unwanted files. I've done that this way: http://pastebin.com/EbHpi0s4.
See http://qt-project.org/doc/qtcreator-2.7/creator-project-generic.html for details.
Now you have to add the
SConscript files to the IDE. Either edit by hand the
$PROJECT_NAME.files or, in the IDE project browser, right click on the top-level directory and select “Add existing files”, and then select
SConstruct from the list. Do the same for the
On the left pane, click “Projects”. Verify that the tab name is actually your project. Click on “Build Settings”. The “build directory” field is a bit misleading with SCons. Don't modify the default, it will use the source top-level directory. Same for the “Tool chain” pull-down menu, leave the default, it is not used by SCons.
Under “Build Steps”, remove the “Make” item by hovering on “Details” by clicking the x that appears.
Click “Add Build Step”, select “Custom process step”, tick the “Enable custom process step”, under “Command” enter the full path to SCons (or just
scons if it is in your
$PATH). Leave the other fields as they are. Eventually pass a
-jN in the “Commands arguments”, where
N — is number of your real cores.
Under “Clean Steps”, do the same thing as for “Add Build Step”, only difference is that you will add
-c to “Commands arguments”.
On the tab “Run” of “Projects” you can manually specify where will be your mixxx-build, and what executable to start (“Command”). Also, I recommend add next text to “Argument field”:
–resourcePath res/ (as described here Compiling on Linux)