Ubuntu Installation

Introduction

HeeksCAD and HeeksCNC are related projects with several dependencies. The build scripts expect the source code directories to be in a specific location relative to one another.

Getting the Code

The easiest way to get all the source code at once is to clone the Heekscad directory recursively. Use this commmand:

git clone --recursive git://github.com/Heeks/heekscad.git

Note for git users:

Each directory is a git repository. Heekscad will automatically check out the master branch. Each of the other repos will not be on a branch and 'git branch' will return '(no branch)'. This is normal. This happens because the recursive clone checks out a specific COMMIT of each submodule. If you want to compile with the latest version of the subprojects, change into each one and checkout either the master or experimental branch.

---

Building and Installing

Now that you have the source, cd into your heekscad directory and execute the script

sh ./INSTALL_UBUNTU.sh

Go ahead and make a cup of coffee or a sandwich because it's going to take a while. The script will install a number of dependencies, then configure, compile, and install all of the projects.

If everything goes well, you can start heekscad from the menu or from the command line. Heekscad often reports errors at the command line, so if things are misbehaving, launching it from a terminal can give valuable clues.

Build and run without installing

sudo apt-get install ............#TODO all needed dependencies
git clone git://github.com/Heeks/heekscad.git
cd heekscad
git clone git://github.com/Heeks/libarea
git clone git://github.com/tpaviot/oce
cd oce
cmake .
make package
cd ..
OCE_DIR=./oce/_CPack_Packages/Linux/TZ/OCE-0.12.1-Linux/usr/local/lib/oce-0.12-dev/ cmake .
make package
LD_LIBRARY_PATH=./bin:./oce/_CPack_Packages/Linux/TZ/OCE-0.12.1-Linux/usr/local/lib/ ./_CPack_Packages/Linux/DEB/heekscad_beta-0.22.0_amd64/usr/bin/heekscad