Doc/Build/DownloadAndCompile

Downloading from source

You can build OpenRasta from the source.

For these instructions, you will need to install an svn client and ilmerge.

Supported environments

OpenRasta supports deployment on both .net 2.0 and .net 3.5.

During development, you need to use Visual Studio 2008. 2005 is not supported.

Downloading the code

To download OpenRasta, first do a checkout of the source code.

The trunk, which is not guaranteed to be stable, can be found at ` http://svn.caffeine-it.com/openrasta/trunk'

The RC branch, where most patches get applied regularly, can be found at http://svn.caffeine-it.com/openrasta/branches/2.0.3000/

Using the command line client

c:\src> svn co http://svn.caffeine-it.com/openrasta/branches/2.0.3000/ openrasta This will download the content of the trunk version in the folder c:\src\openrasta.

Using Tortoise svn

 Tortoise SVN is a free application which provides Windows Explorer integration for common Subversion source code management tasks. After installing and rebooting, use Windows Explorer to navigate to the folder where you want to place the OpenRasta source code, then:

  • Right-click and choose SVN Checkout
  • Paste one of the repository URLs from the list above
  • Click Ok

Tortoise will download the latest revision to your machine (as of September 2009, this is over 1,500 files totaling about 25 MB).

Using ankhSvn

Need to be filled in.

Building

OpenRasta's build requires the use of the  ILMerge tool. Because of its licensing, it cannot be redistributed as part of OpenRasta.

Once the code has been downloaded in the folder of your choice and you have ilmerge installed, navigate to that folder, and build using the provided make.bat script.

c:\src\openrasta> make.bat

This will have generated the OpenRasta dll you will need. All the binaries should now be in the openrasta\bin\release folder.

Using the assemblies

Once the build is complete, you will find the assemblies in /bin/Release.

  • bin/Release
    • net-20: The OpenRasta assemblies for .net 2.0
    • net-30: The OpenRasta assemblies for .net 3.0
    • net-35: The OpenRasta assemblies for .net 3.5

You will need to select the correct binaries for your target environment. Trying to use the 2.0 binaries for a web application running 3.5 will fail.

To know what is in each version, see the list of functionality per framework version.