Setup of Development Environment for Windows

Required software

• Microsoft .Net 3.5 Redistributable and SDK (we only use .Net 2.0 for OpenPetra, but SharpDevelop requires .Net 3.5)
• SharpDevelop 3.0
• one of the following Database Management systems:
  • PostgreSQL (recommended) Notes about PostgreSQL
  • MySQL Notes about MySQL
  • no installation effort at all is required for SQLite Notes about SQLite
• Poedit (for translation) (see also Notes about I18N)
• Mono (for translation)
• Inno Setup 5 for building setup files

TortoiseGit

• http://code.google.com/p/tortoisegit/

This works fine on Windows, although it is still work in progress...

It requires "Git on Windows" http://code.google.com/p/msysgit/; be careful: use the official git installer from that site, eg. Git-1.6.3.2-preview20090608.exe, not the fullinstaller or other packages.

See also some Notes about Git

NAnt

• see also http://nant.sourceforge.net/release/0.86-beta1/help/introduction/installation.html

• download NAnt nant-0.86-nightly-2009-05-05
  • the beta version does not work for me (0.86-beta1); message: Property 'sdkInstallRoot' has not been set.

• unzip the files to eg. c:\program files\nant
• create file c:\windows\nant.bat with content:

@echo off
"C:\Program Files\NAnt\bin\NAnt.exe" %* -t:net-2.0

See also some Notes about NAnt

Get the source code

The source code is managed with Git.

Please understand that we will provide write permissions only to the core members of the development team, just to keep the project on one track. We very much need your contributions though, and we will aim to quickly deal with submitted patches and code via the forum. This still has to be worked out how this works best to submit code that way.

You can get the source code in several ways:

• see the Git instructions at Sourceforge
  • that page describes how you can download anonymously from Git
• you can also browse the Git repository online, and you can download a tar.gz snapshot of each version there

Configuration of Development Environment

The recommended way of installing OpenPetra.org for development is to somewhere map a network drive, using the DOS command subst

For example:

mkdir c:\development
subst u: c:\development
download the git repository into u:\openpetraorg (it contains the .git directory, and the OpenPetra.build: U:\openpetraorg\OpenPetra.build, etc)
URL of the git repository:
   anonymous access: git://openpetraorg.git.sourceforge.net/gitroot/openpetraorg/openpetraorg
   developer access: ssh://USERNAME@openpetraorg.git.sourceforge.net/gitroot/openpetraorg/openpetraorg
     make sure that you set your username and email address in your git client

• you need to make a copy of the file OpenPetra.build-sample-windows.config and call it OpenPetra.build.config

copy OpenPetra.build-sample-windows.config OpenPetra.build.config

NAnt script

There is a central NAnt script that is able to generate a lot of code and is able to do all automated tasks in the OpenPetra project.

Please see OpenPetra NAnt script for details