Skip to content

Latest commit

 

History

History
54 lines (28 loc) · 1.58 KB

how_to_build.md

File metadata and controls

54 lines (28 loc) · 1.58 KB
Raw

How to build

These instructions are only for building with Rake, which includes compilation, test execution and packaging. This is the simplest way to build.

You can also build the solution using Visual Studio 2012 or later.

Don't be put off by the prerequisites! It only takes a few minutes to set them up and only needs to be done once. If you haven't used Rake before then you're in for a real treat!

At the time of writing the build is only confirmed to work on Windows using the Microsoft .NET framework.

Prerequisites

  1. Ensure you have .NET framework 3.5 and 4.0/4.5 installed.

  2. Install Ruby 1.8.7 or later.

For Windows we recommend using RubyInstaller and selecting 'Add Ruby executables to your PATH' when prompted. For alternatives see the Ruby download page.

  1. Using a command prompt, update RubyGems to the latest version:

    gem update --system

  2. Install/update Rake (already included in Ruby 1.9 or later):

    gem install rake

  3. Install/update Albacore:

    gem install albacore

Building

Using a command prompt, navigate to your clone root folder and execute:

rake

This executes the default build tasks. After the build has completed, the build artifacts will be located in bin.

Extras

  • View the full list of build tasks:

    rake -T

  • Run a specific task:

    rake spec

  • Run multiple tasks:

    rake spec pack

  • View the full list of rake options:

    rake -h