Developer Setup

As we move to support cross platform development on .NET Core all developers will need to ensure they have the proper SDK version. Existing developers who have worked with the project before will need to follow the steps below. New developers will also need to ensure they have the SDK but shouldn't have to worry about steps 4 to 6.

Steps for .NET Core version

---

0. Download and install Visual Studio 2017 (Community, Professional or Enterprise) here

During Installation ensure the following workloads are selected

• ASP.NET and web development
• Azure development
• .NET core cross platform development

During the installation ensure the following individual components are selected

• .NET Core Runtime
• TypeScript SDK

Note: for a complete list of Visual Studio Components and Workloads see https://docs.microsoft.com/en-us/visualstudio/install/workload-and-component-ids

Note: Have you worked on the allReady app in the past? If so, this note is for you. Does the solution build fail to run? Do you see a runtime error "HTTP Error 502.5 Process Failure"? Check your local user directory C:\Users<userid> for a local already .mdf and/or .ldf; delete these files. They will be rebuilt when the app is run. If your curious about the why, debug the application from Visual Studio and you'll see the root cause in the thrown exception.

3. Open the AllReady Solution

4. Clean the solution

5. Perform a nuget package restore either through VS or if you prefer using dotnet restore

6. Build and run the application

---

Possible issues In some cases; things can get a bit messed up in VS and even with a clean, things are left around. If you have any problems, try a fresh clean and then navigate to the project folder and delete the obj and bin folders manually. Then run a nuget restore and rebuild the solution.

Running on Linux

Please see Running on Linux for advice on getting set up on Linux.

Running on a Mac

Please see Running on Mac OS X for advice on getting set up on Mac.