omnisharp-vscode/README.md

2.8 KiB

C# for Visual Studio Code (powered by OmniSharp)

Master Dev
Master Build Status Dev Build Status

Welcome to the C# extension for Visual Studio Code! This preview provides the following features inside VS Code:

  • Lightweight development tools for .NET Core.
  • Great C# editing support, including Syntax Highlighting, IntelliSense, Go to Definition, Find All References, etc.
  • Debugging support for .NET Core (CoreCLR). NOTE: Mono and Desktop CLR debugging is not supported.
  • Support for project.json projects on Windows, OS X and Linux, and csproj projects on Windows.

The C# extension is powered by OmniSharp.

Important! Breaking Changes as of 1.2

  • The C# extension now only supports .NET Core 1.0. Please upgrade any RC1 or RC2 projects to the 1.0.0 release build.
  • Support for .csproj projects is partially functional on OS X and Linux. This will impact anyone doing .csproj development on OS X or Linux (e.g. Unity, Xamarin, etc.). We are working to address this in the near future. However, for now, you can use the Legacy C# Support extension.

Found a Bug?

Please file any issues at https://github.com/OmniSharp/omnisharp-vscode/issues.

Debugging

The C# extension now supports basic debugging capabilities! See http://aka.ms/vscclrdebugger for details.

What's new in C# extension version 1.2

  • Adds debugger support for new Linux versions: Ubuntu 16.04, Fedora 23, openSUSE 13.2, and Oracle Linux 7.1
  • Enhanced debug console output: module loads are now output, and there are launch.json options for controlling what is output
  • Source file checksum support for breakpoints. This ensures that the debugger only sets breakpoints in code that exactly matches the open document.
  • Support for editing the value of variables in the watch and locals window (requires VS Code 1.3)

Development

First install:

  • Node.js (newer than 4.3.1)
  • Npm (newer 2.14.12)

To run and develop do the following:

  • Run npm i
  • Open in Visual Studio Code (code .)
  • Optional: run tsc -w, make code changes (on Windows, try start node ".\node_modules\typescript\bin\tsc -w")
  • Press F5 to debug

License

The Microsoft C# extension is subject to these license terms.
The source code to this extension is available on https://github.com/OmniSharp/omnisharp-vscode and licensed under the MIT license.