2016-02-18 18:01:23 +03:00
## C# for Visual Studio Code (powered by OmniSharp)
2015-12-03 13:25:00 +03:00
2016-08-29 19:55:56 +03:00
|Master|Release|
2016-03-24 05:33:57 +03:00
|:--:|:--:|
2016-08-29 19:55:56 +03:00
|[![Master Build Status](https://travis-ci.org/OmniSharp/omnisharp-vscode.svg?branch=master)](https://travis-ci.org/OmniSharp/omnisharp-vscode)|[![Release Build Status](https://travis-ci.org/OmniSharp/omnisharp-vscode.svg?branch=release)](https://travis-ci.org/OmniSharp/omnisharp-vscode)|
2016-03-24 05:27:19 +03:00
2018-03-06 03:08:00 +03:00
[![Wallaby.js ](https://img.shields.io/badge/wallaby.js-configured-green.svg )](https://wallabyjs.com)
2018-04-27 23:03:36 +03:00
Welcome to the C# extension for Visual Studio Code! This extension provides the following features inside VS Code:
2016-03-04 04:07:09 +03:00
2016-05-18 19:54:03 +03:00
* Lightweight development tools for [.NET Core ](https://dotnet.github.io ).
* Great C# editing support, including Syntax Highlighting, IntelliSense, Go to Definition, Find All References, etc.
2018-02-27 21:50:16 +03:00
* Debugging support for .NET Core (CoreCLR). NOTE: Mono debugging is not supported. Desktop CLR debugging has [limited support ](https://github.com/OmniSharp/omnisharp-vscode/wiki/Desktop-.NET-Framework ).
2016-11-11 23:25:50 +03:00
* Support for project.json and csproj projects on Windows, macOS and Linux.
2016-05-16 20:16:03 +03:00
2016-05-18 19:54:03 +03:00
The C# extension is powered by [OmniSharp ](https://github.com/OmniSharp/omnisharp-roslyn ).
2016-05-16 20:16:03 +03:00
2016-11-15 01:43:27 +03:00
### Get Started Writing C# in VS Code
2016-12-21 22:30:38 +03:00
2016-09-23 02:10:34 +03:00
* [Documentation ](https://code.visualstudio.com/docs/languages/csharp )
2017-12-31 18:34:43 +03:00
* [Video Tutorial compiling with .NET Core ](https://channel9.msdn.com/Blogs/dotnet/Get-started-VSCode-Csharp-NET-Core-Windows )
2016-09-23 02:10:34 +03:00
2018-02-15 00:08:19 +03:00
### What's New in 1.14.0
* Support for C# 7.2
* Debugger support for extracting source files embedded in PDBs
* Preliminary support for Linux ARM debugging
* Improved Symbol/Documentation text display
* Addressed problems with projects not being refreshed by OmniSharp after a package restore
* Added option to disable warning about project.json deprecation
2017-11-07 19:31:31 +03:00
* Many other bug fixes!
2018-02-15 00:08:19 +03:00
See our [change log ](https://github.com/OmniSharp/omnisharp-vscode/blob/v1.14.0/CHANGELOG.md ) for all of the updates.
2016-11-11 23:25:50 +03:00
### Supported Operating Systems for Debugging
2016-07-20 21:10:11 +03:00
2017-07-01 00:25:04 +03:00
* Currently, the C# debugger officially supports the following operating systems:
2016-07-20 21:10:11 +03:00
* Windows (64-bit only)
2017-08-08 22:39:52 +03:00
* macOS 10.12 (Sierra) and newer
2017-07-01 00:25:04 +03:00
* Ubuntu 14.04+ (and distros based on it)
* Debian 8.7+
* Red Hat Enterprise Linux (RHEL) / CentOS / Oracle Linux 7.3+
* Fedora 23 / 24 / 25
* OpenSUSE 42.2+
This list is currently the same as the x64 .NET Core 2.0 operating systems (see [.NET Core list ](https://github.com/dotnet/core/blob/master/roadmap.md#net-core-20---supported-os-versions )). Note that other Linux distributions will likely work as well as long as they include glibc, OpenSSL 1.0, and libunwind.
2016-05-18 19:54:03 +03:00
### Found a Bug?
Please file any issues at https://github.com/OmniSharp/omnisharp-vscode/issues.
2016-05-16 20:16:03 +03:00
2016-03-04 04:07:09 +03:00
### Debugging
2016-05-18 19:54:03 +03:00
The C# extension now supports basic debugging capabilities! See http://aka.ms/vscclrdebugger for details.
2015-12-07 11:37:18 +03:00
2016-03-04 04:07:09 +03:00
### Development
2016-05-18 00:56:20 +03:00
First install:
* Node.js (newer than 4.3.1)
* Npm (newer 2.14.12)
2016-09-23 23:34:57 +03:00
2015-12-03 13:25:00 +03:00
To **run and develop** do the following:
2016-02-18 18:01:23 +03:00
* Run `npm i`
2016-11-11 23:25:50 +03:00
* Run `npm run compile`
2016-02-18 18:01:23 +03:00
* Open in Visual Studio Code (`code .`)
2017-03-17 17:21:26 +03:00
* *Optional:* run `npm run watch` , make code changes
2016-08-29 19:55:56 +03:00
* Press < kbd > F5</ kbd > to debug
2016-03-03 02:57:31 +03:00
2017-02-08 04:50:00 +03:00
To **test** do the following: `npm run test` or < kbd > F5</ kbd > in VS Code with the "Launch Tests" debug configuration.
2016-09-23 23:34:57 +03:00
2016-05-18 19:54:03 +03:00
### License
2016-09-23 23:34:57 +03:00
The Microsoft C# extension is subject to [these license terms ](RuntimeLicenses/license.txt ).
The source code to this extension is available on [https://github.com/OmniSharp/omnisharp-vscode ](https://github.com/OmniSharp/omnisharp-vscode ) and licensed under the [MIT license ](LICENSE.txt ).