Setting up a development environment for my software

This sets up a development environment with git checkouts of more or less (see Manifests) all my software packages. You typically only want this if:

  • you want to hack a number of these packages at the same time or
  • you need the absolute latest version of everything.

If you want to hack just one package, it's easier to just clone its git tree and work on it. If you're a user, install the latest released version.

Grab the Android "repo" tool:

mkdir -p ~/bin
curl > ~/bin/repo

chmod +x ~/bin/repo

/!\ The assumption here is that ~/bin will be on your $PATH. Alternatively, download repo to wherever you like and specify the path explicitly below.

Prevent repo sync below from getting stuck because of host key checking:

echo -e "Host\n\tStrictHostKeyChecking no\n" >> ~/.ssh/config
echo -e "Host\n\tStrictHostKeyChecking no\n" >> ~/.ssh/config

/!\ It's important to understand the (minor) security implications of this step.

Create your source root: (Note that the brackets denote an optional part. See Manifests for what values are allowed for manifest.xml. Don't type the brackets!)

mkdir ~/src # or wherever
cd ~/src
repo init -u [-m manifest.xml]
repo sync
repo start master --all

Then build:


/!\ Note that this refers to ~/src/bin/build-all (or wherever you chose to place your source tree), not the ~/bin directory mentioned above.

If you'd like to exclude some projects from the build (like PyCUDA on a system without CUDA), just create a .exclude file with one excluded project name per line.


The following manifests are available:

Using the installed software

The build-all step actually creates a virtualenv into which it installs all the software. To use it, do:

source ~/src/env/bin/activate

Extra setup for hedge

To get hedge to run, you also need a file $HOME/ with the following content:

# make sure to replace "src" with your actual repo root directory
BOOST_BINDINGS_INC_DIR = ['${HOME}/src/boost-numeric-bindings']

DevEnvironmentHowto (last edited 2015-02-18 18:12:21 by AndreasKloeckner)