ASP.NET 5 mit Visual Studio Code

Nachdem ich aktuell gerade an Visual Studio Code dran bin, dachte ich mir, dass ich im Zuge dessen auch gleich einen Blick auf ASP.NET 5 werfe – und natürlich in Verbindung mit VS Code.

Installation

Es wird vorausgesetzt, dass sowohl Node.js, als auch Visual Studio Code installiert sind. Im nächsten Schritt wird Yeoman und ein entsprechender Generator für ASP.NET 5 installiert.

npm install -g yo generator-aspnet

Danach kann im gewünschten Verzeichnis das Grundgerüst eines ASP.NET 5-Projektes angelegt werden. Dies geschieht mit dem nachfolgenden Aufruf:

yo aspnet

Nun sollen alle NuGet Pakete installiert werden. Dies kann in der Commandline mit dem Befehl dnu restore ausgeführt werden. Alternativ ist unter Visual Studio Code aus der Command Palette der Befehl dnx: Restore Packages auszuführen.

Kleiner Tipp am Rande: Aus der Commandline kann der gesamte Ordner via code . im Visual Studio Code geöffnet werden.

Mittels dnx build kann gleich mal gebuildet und somit überprüft werde, ob auch tatsächlich alles korrekt abgelaufen ist. Zu guter Letzt ist mit dnx web der Webserver zu starten.

ASP.NET 5 und Visual Studio Code

Wer hat nicht schon einmal beim committen neuer Dateien vergessen, das veränderte Projekt-File in das Changeset mit aufzunehmen und dann hat es gleich einmal den Checkin-Build zerlegt? Das gehört der Vergangenheit an. In dieser Umgebung haben wir die bekannten SLN und CSPROJ-Dateien nicht mehr. Das Projekt selbst besitzt eine Datei project.json. Darin werden zahlreiche Informationen á la Version, Abhängigkeiten, unterstützte Frameworks etc. verwaltet.

Nun haben wir aber auch keine voll ausgebildete IDE (wie wir das von Visual Studio kennen). Wie funktioniert das nun mit C#?

Das Herzstück wird durch OmniSharp gebildet. Dieses Projekt gibt es schon länger und hat sich zum Ziel gemacht, .NET-Entwicklung in den gängigen Editoren zu unterstützen. Ich bin damit vor einigen Jahren mit VIM in Berührung gekommen und war damals schon recht positiv von diesem Projekt angetan.

Angefangen von Hinweisen zu unnötigen Usings, bis hin zur Code-Vervollständigung ist alles Notwendige enthalten und lässt die Arbeit recht einfach von der Hand gehen.

Der einzige Nachteil zum aktuellen Zeitpunkt: Debugging ist noch nicht möglich, wird aber wohl in nächster Zeit zu erwarten sein.

Commands

Bereits oben gab es den Hinweis auf das Kommando dnx web. Dieser Befehl spiegelt sich eigentlich durch die definierten Kommandos in der Datei project.json wider.

In meinem Fall habe ich eine Web API Application angelegt. In der project.json findet sich unter commands folgender Eintrag:

"commands": {
    "web": "Microsoft.AspNet.Server.Kestrel"
}

Dies ist genau das Kommando, welches mit dnx aufgerufen wurde und auch angezeigt wird, wenn mittels F1 die Command Palette geöffnet und dnx: Run command eingegeben wird. In diesem Fall wird Kestrel gestartet. Dieser sucht nach einer Klasse vom Typ Startup, instanziert sie und führt sich anschließend aus.

Analog zu diesem Kommando können weitere angegeben werden und stehen anschließend über die Commandline bzw. über die Command Palette zur Verfügung.

Fazit

Der Start ging schon sehr flott und einfach von der Hand, aber es gibt noch Vieles zu lernen und in Erfahrung zu bringen. Auf jeden Fall bin ich positiv überrascht, wie wenig Steine einem zumindest am Anfang in den Weg gelegt werden. Weitere Berichte über Fortschritte und Erfahrungen werden folgen.