Run Asp Net 5 On Visual Studio For Mac

Install Mvc 5 On Visual Studio 2015
Run Asp Net 5 On Visual Studio For Mac Asp.net

I have created one console application in asp.net core in window PC and create a.sln file(vs 2017). Now, I will need to run the same.sln file on Linux / Mac visual studio 2017. It’s available as a preview release as part of Visual Studio CTP 6, and offers a number of fairly significant changes, including the ability to run on Windows, Mac or Linux using the.NET Core. Hey, I've just installed Visual Studio for Mac, and can't find.NET Core(ASP.NET Core) I can see just.NET and ASP.NET MVC, ASP.NET Web Forms and Empty ASP.NET Project.

In this tutorial we are going to create a simple ASP.NET 5 web application on Mac, use SignalR to push events from server to connected clients and then deploy to Azure through a git repository.

What is ASP.NET 5?

ASP.NET 5 is a new open-source and cross-platform framework for building modern cloud-based Web applications using .NET. It consists of modular components with minimal overhead, so you retain flexibility while constructing your solutions.

In short, with ASP.NET 5 you gain the following fundamental improvements:

New light-weight and modular HTTP request pipeline
Ability to host on IIS or self-host in your own process
Built on .NET Core, which supports true side-by-side app versioning
Ships entirely as NuGet packages
Integrated support for creating and using NuGet packages
Single aligned web stack for Web UI and Web APIs
Cloud-ready environment-based configuration
Built-in support for dependency injection
New tooling that simplifies modern web development
Build and run cross-platform ASP.NET apps on Windows, Mac and Linux
Open source and community focused

For more details, you can visit this page.

Installing ASP.NET 5

In order to install ASP.NET 5 and start working on Mac you have two options:

Install ASP.NET 5 with Visual Studio Code
1. Install Mono for OS X (required by Visual Studio Code)
2. Install Visual Studio Code
3. Install ASP.NET 5 for Mac OS X
Install ASP.NET from the command-line
- Run the following curl command, to install .NET Version Manager (DNVM)
  curl-sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh
- Run dnvm list to show the DNX versions installed
- Use DNVM to install DNX for .NET Core:
  dnvm upgrade-rcoreclr

Yeoman and generator-asp.net

Yeoman helps you kickstart new projects, prescribing best practices and tools to help you stay productive. To do so, it provides a generator ecosystem. A generator is basically a plugin that can be run with the yo command to scaffold complete projects or useful parts.

To kickstart a new ASP.NET 5 app, you need to install the generator-aspnet, as per the following steps:

npm install -g yo to install Yeoman
npm install -g generator-aspnet to install a new project generator for ASP.NET apps
Run: yo aspnet to start with a new ASP.NET App
- select Web Application
- cd to the new app folder
- dnu restore to restore web app’s NuGet packages

Start you application

In order to start the application that has been generated through Yeoman, you need to run the dnx web command.

The web command has been defined in the project.json file, the role of which is to:

define package metadata,
state project dependencies, and
declare which frameworks the app will be built for.

If you point your browser to http://localhost:5000 you will see a simple “Hello World” page.

SignalR

ASP.NET SignalR is a library for ASP.NET developers that simplifies the process of adding real-time web functionality to applications. Real-time web functionality is the ability to have server code push content to connected clients instantly, as it becomes available, rather than having the server wait for a client to request new data. SignalR uses the WebSocket transport where available, and falls back to older transports where necessary.

You can read more details on SignalR here.

To add SignalR in your web application, you need to add the following dependencies in the project.json file.

</div><table><tbody><tr><td><div>2</div></td><td><div><div><span>'Microsoft.AspNet.WebSockets.Server'</span><span>:</span><span>'1.0.0-rc1-final'</span></div><div><span>'Microsoft.AspNet.SignalR.Server'</span><span>:</span><span>'3.0.0-rc1-final'</span></div></div></td></tr></tbody></table><p>When you run <code>dnu restore</code> to restore the packages above you might come to the following error:</p><p><span><code>Unable to locate Dependency </code></span><code><span>Microsoft.AspNet.SignalR.Server</span><span> >= 3.0.0-rc1-final</span></code></p><p>To overcome this error you need to manually specify the NuGet package sources in a <code>NuGet.config</code> file, which will be stored in your app’s root folder.</p><div><textarea wrap='soft' readonly='><?xml version='1.0' encoding='utf-8'?><configuration> <packageSources> <add key='aspnetmaster' value='https://www.myget.org/F/aspnetmaster/api/v3/index.json' /> <add key='AspNetVNext' value='https://www.myget.org/F/aspnetvnext/api/v2' /> <add key='nuget' value='https://api.nuget.org/v3/index.json' /> </packageSources></configuration>

</configuration>

After specifying NuGet package sources, re-run dnu restore to restore packages defined in your project.json file.

Register SignalR

To make SignalR available in your application, you need to register it in your Startup file.

</div><table><tbody><tr><td><div><div>2</div><div>4</div><div>6</div><div>8</div><div>10</div><div>12</div><div>14</div><div>16</div></div></td><td><div><div><span>using</span><span>Microsoft</span><span>.</span><span>AspNet</span><span>.</span><span>SignalR</span><span>;</span></div><div><span>{</span></div><div><span>public</span><span>class</span><span>SystemHub</span><span>:</span><span>Hub</span></div><div><span>private</span><span>Random </span><span>random</span><span>=</span><span>new</span><span>Random</span><span>(</span><span>)</span><span>;</span></div><div><span>public</span><span>void</span><span>GenerateMessage</span><span>(</span><span>)</span></div><div><span>Clients</span><span>.</span><span>All</span><span>.</span><span>notify</span><span>(</span><span>$</span><span>'{DateTime.Now.ToString('</span><span>HH</span><span>:</span><span>mm</span><span>:</span><span>ss</span><span>')}: Random Message id: {random.Next(1, 100)}'</span><span>)</span><span>;</span></div><div><span>}</span></div></div></td></tr></tbody></table><p>In this hub, we have created a <code>GenerateMessage</code> method that, when called from any connected client, it will send back to all connected clients a message with a random id.</p><h3>Use Bower to install SignalR client libraries</h3><p><b>Bower</b> is a package manager for Javascript libraries that allows you to define, version and retrieve your dependencies.</p><p>To install SignalR client libraries you need to run <code>bower install signalr</code></p><p>To establish a connection between client and server with the use of SignalR, you need to include the following scripts in your shared <code>_Layout.cshtml</code> file:</p><div><textarea wrap='soft' readonly='><script src='https://ajax.aspnetcdn.com/ajax/jquery/jquery-2.1.4.min.js' asp-fallback-src='~/lib/jquery/dist/jquery.min.js' asp-fallback-test='window.jQuery'><script src='~/lib/signalr/jquery.signalR.js'></script><script src='signalr/hubs'></script>

2 4	<script src='https://ajax.aspnetcdn.com/ajax/jquery/jquery-2.1.4.min.js' asp-fallback-src='~/lib/jquery/dist/jquery.min.js' <script src='~/lib/signalr/jquery.signalR.js'></script>

signalr/hubs script is generated dynamically by the runtime on the first request and then cached.

Install Mvc 5 On Visual Studio 2015

These references must be included in this order: jQuery first, SignalR core after that, and SignalR proxies last.

Connect to SignalR server and request messages

Now, you need to connect to SystemHub and request a server generated message:

In Index.cshtml file you add the following script:

</div><table><tbody><tr><td><div><div>2</div><div>4</div><div>6</div><div>8</div><div>10</div><div>12</div><div>14</div><div>16</div><div>18</div><div>20</div><div>22</div></div></td><td><div><div><span>{</span></div><div><span>$</span><span>(</span><span>function</span><span>(</span><span>)</span><span>{</span></div><div><span>var</span><span>systemHub</span><span>=</span><span>$</span><span>.</span><span>connection</span><span>.</span><span>system</span><span>;</span></div><div><span>var</span><span>messages</span><span>=</span><span>$</span><span>(</span><span>'#messages'</span><span>)</span><span>;</span></div><div><span>messages</span><span>.</span><span>append</span><span>(</span><span>[</span><span>'<span>'</span><span>,</span><span>msg</span><span>,</span><span>'</span><br />'</span><span>]</span><span>.</span><span>join</span><span>(</span><span>'</span><span>)</span><span>)</span><span>;</span></div><div><span>}</span></div><div><span>console</span><span>.</span><span>log</span><span>(</span><span>'Request to connect'</span><span>)</span><span>;</span></div><div><span>systemHub</span><span>.</span><span>server</span><span>.</span><span>generateMessage</span><span>(</span><span>)</span><span>;</span></div><div><span>systemHub</span><span>.</span><span>server</span><span>.</span><span>generateMessage</span><span>(</span><span>)</span><span>;</span></div><div><span>}</span><span>)</span><span>;</span></div><div><span></script></span></div></div></td></tr></tbody></table><p>And the result is:</p><h2>Publish On Azure</h2><p>In order to publish your project to Azure websites, you have multiple options; however, in this tutorial we will describe how to use DNX Utility (dnu) to publish this app and then upload it to Azure though KUDU service.</p><p>Run: <code>dnu publish --out ~/Documents/published-webapp --no-source --runtime active</code></p><p>The publish command will package your application into a self-contained directory that can be launched. It will create the following directory structure:</p><ul><li>approot/</li><li>approot/packages</li><li>approot/appName</li><li>approot/web.cmd</li></ul><h2 id='run-asp-net-5-on-visual-studio-for-mac-aspnet'>Run Asp Net 5 On Visual Studio For Mac Asp.net</h2><p>The packages directory contains all packages that your application needs to run.</p><p>The appName (web) directory will contain all of your application’s code, if you have project references they will appear as their own directory with code at this level as well.</p><p>The publish command will also hoist any commands from your project.json file into batch files. Running any of these commands is the same as running <code>dnx <command></code>.</p><h3>Create an Azure WebApp</h3><p>From Azure portal create a new WebApp:</p><p>Now, head over to <code>https://webapp-mac.<strong>scm</strong>.azurewebsites.net/DebugConsole</code>, click on <code>site</code> and then upload a zip file with the contents of <code>published-webapp</code> folder by dragging and dropping on kudu site:</p><p>Then, from the command line run <code>unzip published-webapp.zip</code> and your app is ready.</p><h3>Note</h3><p>When in Azure, in order to connect to SignalR server, using WebSockets, please use <code><strong>https</strong></code>.</p><p>If you need to automatically redirect your app to <strong>https</strong> when in Production, you can use <code>RequireHttps</code> filter when configuring services in your Startup file:</p><div><textarea wrap='soft' readonly='>// This method gets called by the runtime. Use this method to add services to the container.// For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940public void ConfigureServices(IServiceCollection services){ // ... other configuration services.AddMvc(options => { if (!_env.IsDevelopment()) { options.Filters.Add(new RequireHttpsAttribute()); } }); services.AddSignalR(options => { options.Hubs.EnableDetailedErrors = true; });}

// This method gets called by the runtime. Use this method to add services to the container.

// For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940

publicvoidConfigureServices(IServiceCollection services)

// ... other configuration

services.AddMvc(options=>

if(!_env.IsDevelopment()){options.Filters.Add(newRequireHttpsAttribute());}

{

});

The source code for this tutorial, with slight modifications, can be found in my GitHub profile in 01.insights-signalr branch