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 higher -
choco install sqlserver2014express
for Chocolatey users. - Your SQL Server installation should be the default instance (not YOURMACHINE\SQLEXPRESS) for the tests to pass. They rely on the connection string being
Server=(local);Integrated Security=true;Connect Timeout=5;database=Roadkill
- An NUnit runner (NUnit, Resharper, Dotcover etc.) if you want to run the tests. This is required if you want to contribute.
To get a 'fresh' Roadkill installation on your development machine, you will need to do the following:
- For IIS: create a new site with a .NET 4 application pool. Roadkill also works with IIS Express.
- If you're using SQL Server: create a database called "roadkill". Run the
/lib/Test-databases/roadkill-sqlserver.sql
script.- If you want to use SQLite or SQLServer CE, empty databases can be found
/lib/Test-databases/SqlCE
or Sqlite.
- If you want to use SQLite or SQLServer CE, empty databases can be found
- You can also install Roadkill using the unattended url, e.g.: http://localhost/install/Unattended?datastoretype=sqlserver2008&connectionstring=database=roadkill;uid=sa;pwd=Passw0rd;server=.\SQLEXPRESS
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.
Roadkill can be run using a website deploy on Windows Azure. The instructions for this can be found on the Roadkill wiki
Codeplex is synced from Github before releases using git push --all https://git01.codeplex.com/roadkill
If you want to contribute to Roadkill, have a look at the Contributing page on Github or on the Roadkill wiki: