Setup of Development Environment for Windows

Required software

Microsoft .Net

• Microsoft .Net 3.5 Redistributable and the SDK (we only use .Net 2.0 for OpenPetra, but SharpDevelop requires .Net 3.5)

• free download from Microsoft:
  • Redistributable: http://www.microsoft.com/downloads/details.aspx?familyid=333325FD-AE52-4E35-B531-508D977D32A6
  • SDK: http://www.microsoft.com/downloads/details.aspx?FamilyID=c17ba869-9671-4330-a63e-1fd44e0e2505

SharpDevelop 3.x

• we currently use SharpDevelop 3.1, but also the latest SharpDevelop 3.2 RC1 should work
• free download: http://www.icsharpcode.net/OpenSource/SD/Download/

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.

We recommend to use plink.exe from PuTTY, not OpenSSH. You have that choice in the TortoiseGit installer.

You also might want to have a look at Git Extensions which is also a full blown git GUI for Windows.

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

Database systems

• one of the following Database Management systems:
  • no installation effort at all is required for SQLite; see Notes about SQLite
  • PostgreSQL (recommended); see Notes about PostgreSQL
    • get the latest version from http://www.postgresql.org/download/windows. The one click installer works fine for me.
  • MySQL; see Notes about MySQL
    • get the latest Windows version from http://dev.mysql.com/downloads/mysql/. It is called MySQL Community Server. The MSI essential package works fine for me.

Optional

The following pieces of software are only required when you want to build releases of OpenPetra:

• Poedit (for translation, generating the .mo file from the .po file): http://www.poedit.net/download.php
• Inno Setup 5 for building setup files: http://www.jrsoftware.org/isdl.php

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
• for developers: more detailed instructions how to create the ssh key and where to upload it to Sourceforge: https://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys

for anonymous access, you can use this URL to clone the repository with TortoiseGit:

git://openpetraorg.git.sourceforge.net/gitroot/openpetraorg/openpetraorg

for developer access (with write permissions), use this URL to clone the repository with TortoiseGit:

ssh://USERNAME@openpetraorg.git.sourceforge.net/gitroot/openpetraorg/openpetraorg

For development, I recommend you create a local branch, and switch to it. Then you pull updates from the server ("master") into your local branch, and push your updates up to the server in the master branch. Otherwise you get all sorts of problems with pushing and pulling, so don't commit to master at all. see also Notes about Git

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

Please check your OpenPetra.build.config file and make sure the paths are all adjusted to your system and the version numbers in the paths are correct.

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