Devel:Installation

From GeopsyWiki
Jump to navigation Jump to search

Development is preferably achieved under Linux. Other platforms are not documented.

Necessary 3rd party tools

A recent version of g++, gfortran, and Qt are first required. For code edition, we recommend using Qt Creator which is provided in Qt sdk.

Some packages may require additional 3rd party libraries. Refer to the usual installation instructions for details.

Initialization

The list of packages is saved in a git repository called geopsyprojects. Configure it by editing option.sub.

Currently, the active branch is 2.1, to work on another branch (e.g. master, 2.2, ...) change the argument of git fetch and git checkout. Switching to another branch afterward is possible.

mkdir geopsy-dev
cd geopsy-dev
git clone git://download.geopsy.org/geopsyprojects
mv geopsyprojects admin
cd admin
git fetch git://download.geopsy.org/geopsyprojects 2.1:2.1
git checkout 2.1
cp options.sub.example options.sub
vi options.sub
cp projects.default.example projects.default
vi projects.default
cd ..

A package of multi-purpose scripts to ease coding experience. Bootstrap is a little tricky...

git clone git://download.geopsy.org/devpro
cd devpro
git fetch git://download.geopsy.org/devpro 2.1:2.1
git checkout 2.1
mkdir ~/.devpro
echo "REF_QT_VERSION=4.5.3" >> ~/.devpro/info
src/dpconfigure
source ../admin/options.sub
./configure $CONFIGURE_OPTIONS
make
cd ..

Define path to geopsy-dev/bin (or other DEST_DIR if configured differently in admin/options.sub) in your PATH (e.g. ~/.bashrc).

export PATH=/path/to/geopsy-dev/bin:$PATH

Download all packages for branch 2.1

If you want to work on the latest development branch ("master"), skip this step. So simple...

cd geopsy-dev
dpsubdo dpcheckout 2.1

Configure and compile

Configure packages forcing the options from admin/options.sub (option '-f').

cd geopsy-dev
dpsubconfig -f

Build the general Makefile

dpsubpro
qmake

Compile...

make debug

Qt Creator

Qt Creator does not like 3rd party and script projects included in the package list, so remove them from the global Makefile once these projects are successfully compiled.

dpsubpro -l qtpro
qmake

Start Qt creator and open 2.1.pro file located in geopsy-dev.