Documentation/BuildEnvironmentJhbuild

Build Environment with Jhbuild

oi-jhbuild offers an automated way to setup an environment for the development of OpenInkpot targeted applications.

Requisites

oi-jhbuild modulesets track OpenInkpot's upstream and you need to have a reasonably recent distribution installed such that all dependecies gel toghether nicely.

There is a number of development packages that you should have installed on your machine before geting started with Jhbuild. Check the list for your distribution:

If you happen to write-up a list of dependencies for other distribution as well please consider adding it here !

Build with Jhbuild

In a terminal cd to the top directory you use for development, ie. /home/username/projects/. From there clone oi-jhbuild:

cd /home/username/projects
git clone git://users.git.openinkpot.org/~riccardo/oi-jhbuild

Now, building the environment is straightforward:

cd oi-jhbuild
./jhbuild

This will take care of downloading the source and installing them by tracking all dependencies. By default oi-jhbuild will checkout to /home/username/projects/oi-jhbuild/sources/ and install your environment to /home/username/projects/oi-jhbuild/install.

There is a minimal set of command arguments that you should be aware of when working with Jhbuild:

  • ./jhbuild build packagename

This will update and install the module packagename and all the modules packagename depends on.

  • ./jhbuild build packagename1 --start-name=packagename2

This will update and install the module packagename1 and all the modules packagename1 depends on. This time however jhbuild will start building from packagename2 in the dependencies graph.

  • ./jhbuild buildone packagename

This will update and install the module packagename only.

  • ./jhbuild shell

This will login you into a shell and setup your environment variables to point to the jhbuild install directory.

A complete command reference for Jhbuild can be found  here.