Versions Compared

Old Version 1

changes.mady.by.user Arnaud Lachaume (Unlicensed)

Saved on

compared with

New Version 2

changes.mady.by.user Arnaud Lachaume (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
.NET Development requires you to have Windows, Visual Studio and Github setup on your computer. This document explains how to do all of that.

1) Windows Installation
Info
titleFor Windows Users

You can skip this part if you are working on Windows

 

If you are working on Linux or on a Mac, the best way is to install Windows is via VirtualBox.

  1. Go to https://www.virtualbox.org/wiki/Downloads then download and install
  2. Download a Windows 8 virtual machine here: https://www.modern.ie/en-gb/virtualization-tools
  3. Install the VM - Check everything works
Info
titleProTip

You should also install Chrome or FF - will be convenient for browsing the .NET docs while developing within your VM

 

2) Github Setup on Windows

...

  1. Start your Windows VM if using one
  2. Download the Github Windows client from your VM from here: https://windows.github.com/
  3. Follow the instructions - The setup of the SSH keys should be really straightforward
  4. Checkout: https://github.com/<github-username>/maestrano-dotnet
  5. Checkout: https://github.com/<github-username>/demoapp-dotnet

...

3) Setup Visual Studio on Windows

...

  1. Open Visual Studio Express for Desktop (type "VS Express" in search bar)
  2. Click on File > Open Project (or File > Recent Projects and Solutions if you have already opened it before)
  3. Open <maestrano-dotnet-github-dir>/src/Maestrano.SLN (VS Solution file)

...

Warning
title.NET 4.5 and .NET 4 assemblies

Warning! The main solution file is configured to build the project using .NET 4.5 (most widely adopted version) but Maestrano also supports .NET4

If you are compiling the library with the view to package it and push it to NuGet (online package manager) then you MUST also open the Maestrano.Net40.SLN Solution file and compile the project again.

The .NET45 version binary will be dropped in: <project-folder>\bin\Release\net45

he .NET40 binary will be dropped in: <project-folder>\bin\Release\net45

Note: there are ways to compile both in one go but it's really annoying to setup...

 

Maestrano Demo Application

  1. Open Visual Studio Express for Web (type "VS Express" in search bar)
  2. Click on File > Open Project (or File > Recent Projects and Solutions if you have already opened it before)
  3. Open <maestrano-dotnet-github-dir>/src/MnoDemoApp.SLN (VS Solution file)
  4. You can click on the Play icon at the top to launch the web application and open it in the default browser
Info
titleProTip

Note that - by default - the development server will break on issues to allow you to debug your code. So if you see that your page take aaaages to load, just check the console in VS and make sure it's not expecting you to do something!!