Skip to content

Latest commit

 

History

History
48 lines (29 loc) · 2.4 KB

readme.md

File metadata and controls

48 lines (29 loc) · 2.4 KB

Roadkill Developer Readme

Pre-requisites

To setup Roadkill on a developer machine, you will need:

  • Visual Studio 2013 (2012 should also work)
  • Typescript installed - http://www.typescriptlang.org
  • SQL Server Express 2012 or better, although you can configure Roadkill to work with SQL Server CE or SQLite if you prefer.
  • An NUnit runner (NUnit, Resharper, Dotcover etc.) if you want to run the tests. This is required if you want to contribute.

Fresh install

To get a 'fresh' Roadkill installation on your development machine, you will need to do the following:

Build scripts

There are 4 build scripts that automate the builds:

  • build.ps1 - runs msbuild with the solution file
  • devbuild.ps1 - builds and copies all files required for a dev build, zips the files and then pushes the zip file to the 'RoadkillBuilds' repository on Bitbucket (https://bitbucket.org/yetanotherchris/roadkillbuilds).
  • releasebuild.ps1 - The same as devbuild.ps1 but uses the release build configuration and only produces a zip file.
  • mono.releasebuild.ps1 - Uses the the mono build configuration.

Running Roadkill on Azure

Roadkill can be run using a website deploy on Windows Azure. The instructions for this can be found on the Roadkill wiki

Syncing with Git

Mercurial (Bitbucket) hosting is synced with Github and Codeplex Git hosting using the Hg-To-Git plugin for Mercurial. These commands are then run:

  • hg pull -u
  • hg bookmark -f master
  • hg push git+ssh://[email protected]/yetanotherchris/roadkill.git

Codeplex is then synced from Github using git push --all https://git01.codeplex.com/roadkill

Contributing

If you want to contribute to Roadkill, have a look at the Contributing page on the Roadkill wiki: