72 KiB
Known Issues in 1.17.1
- Known limitations with the preview Razor (cshtml) language service to be addressed in a future release:
- Only ASP.NET Core projects are supported (no support for ASP.NET projects)
- Support for tag helpers and formatting not yet implemented
- Limited support for colorization
- Loss of HTML completions following C# less than (
<
) operator - Error squiggles misaligned for expressions near the start of a new line
- Incorrect errors in Blazor projects for event bindings
- Emmet based abbreviation expansion is not yet supported
- There currently is no completion support for package references in csproj files. (#1156)
- As an alternative, consider installing the MSBuild Project Tools extension by @tintoy.
1.18.0 (Not yet released)
- Added a
csharp.maxProjectFileCountForDiagnosticAnalysis
setting to configure the file limit when the extension stops reporting errors for whole workspace. When this threshold is reached, the diagnostics are reported for currently opened files only. This mechanism was available in previous versions, but now can be configured. The default is 1000. (PR: #1877) - Added initial support for C# 8. (PR: omnisharp-roslyn#1365)
- Fixed finding references to operator overloads (Contributed by @SirIntruder) (PR: omnisharp-roslyn#1371)
- Improved handling of files moving on disk (PR: omnisharp-roslyn#1368)
- Improved detection of MSBuild when multiple instances are available (Contributed by @johnnyasantoss ) (PR: omnisharp-roslyn#1349)
- Fixed a bug where the "OmniSharp" and "C# log" would steal the editor focus and hinder the user's development flow.(PR: #2828)
Debugger
- Added support for set next statement. Set next statement is a feature that have been available for a long time in full Visual Studio, and this brings the feature to Visual Studio Code. This feature allows developers to change what code is executed in your program. For example, you can move the instruction pointer back to re-execute a function that you just ran so you can debug into it, or you can skip over some code that you don't want to execute. To use this feature, move your cursor to the next statement you would like to execute next, and either open the editor context menu and invoke 'Set Next Statement (.NET)', or use the keyboard shortcut of Ctrl+Shift+F10 (#1753)
- Fixed evaluating string functions with interpretation in .NET Core 2.1+. Evaluation uses interpretation for conditional breakpoints, evaluating methods that take a lambda, etc (#2683)
- Many small improvements to launch.json/tasks.json generation. Highlights include a selection dialog if the workspace contains multiple launchable projects, a few simplifications to reduce the number of fields in the default launch.json, and switching the 'problem matcher' for build tasks. (PR: #2780)
1.17.1 (November 11, 2018)
- Updated Razor language service to fix various Razor editing reliability issues. For details see https://github.com/aspnet/Razor.VSCode/releases/tag/1.0.0-alpha2.
1.17.0 (October 31, 2018)
- Added preview Razor (cshtml) language service with support for C# completions and diagnostics in ASP.NET Core projects. Please report issues with the preview Razor tooling on the aspnet/Razor.VSCode repo. To disable the preview Razor tooling set the "razor.disabled" setting to
true
. (PR: 2554) - Added omnisharp.minFindSymbolsFilterLength setting to configure the number of characters a user must type in for "Go to Symbol in Workspace" command to return any results (default is 0 to preserve existing behavior). Additionally added omnisharp.maxFindSymbolsItems for configuring maximum number of items returned by "Go to Symbol in Workspace" command. The default is 1000. (PR: #2487)
- Added a command - "CSharp: Start authoring a new issue on GitHub" to enable the users to file issues on github from within the extension with helpful config information from their system.(PR: #2503)
Debugger
- Fixed crash at the end of debug sessions on Linux (#2439)
- Fixed searching for PDBs in original built location (#2483)
- Fixed launching the web browser against an ASP.NET project that uses wildcard ('*') bindings (#2528)
1.16.2 (October 3, 2018)
- Update extension to handle upcoming breaking change to launch.json configurations in VS Code 1.28. (PR: #2558)
- Fixed a bug where OmniSharp flame was red in spite of OmniSharp loading the projects without any errors. (PR: #2450)
- Fixed launch.json
envFile
option on Windows. (PR: #2560) - Fixed a problem with tracking virtual documents from other providers. (PR: #2562)
1.16.0 (September 10, 2018)
Project System
-
Separated the existing "Restore Packages" option in the Command Palette into two distinct functions:
- "Restore Project" - Displays a drop-down that shows all the available projects in the solution or in the workspace. Selecting one of them would trigger a dotnet restore for the particular project.
- "Restore All Projects" - Triggers a dotnet restore for all projects in the current solution or workspace.
-
Modified the "Unresolved dependencies" prompt to restore the all the projects in the currently selected solution or workspace. (PR: #2323)
-
Added support to configure the default *.sln file loaded when opening a project with multiple *.sln files in the root. (Contributed by @janaka) (PR: #2053)
-
Added support for tracking opening, closing and changing of virtual documents that don't exist on disk. (PR: #2436) (Contributed by @NTaylorMullen)
-
Enabled IDE features for .cs files that are not part of a project. (PR: #2471, omnisharp-roslyn#1252)
Misc
- Added a prompt to "Restart OmniSharp" when there is a change in omnisharp "path", "useGlobalMono" or "waitForDebugger" settings.(PR: #2316)
Editor
-
Improved diagnostics by refreshing them when the active editor changes or the current window is focused. (PR: #2317) (Contributed by @SirIntruder)
-
Improved completions by adding the preselect property so the best match is preselected. (PR: #2388)
Testing
- Added test execution output to the output of the Run/Debug Test CodeLens. (PR: #2337, #2343, omnisharp-roslyn#1203)
- Fixed a bug where a debug session could not be started and duplicate logs were displayed after a previous one failed due to build failure. (PR: #2405, omnisharp-roslyn#1239)
Options
- Added
monoPath
option to use the mono installation at the specified path when theuseGlobalMono
is set to "always" or "auto". (PR: #2425) (Contributed by @shana)
Debugger
- Added support for launching with environment variables stored in a seperate file from launch.json via a new
envFile
option. (PR: #2462, #1944) (Contributed by @SebastianPfliegel) - Fixed editting breakpoint conditions while debugging with recent versions of VS Code. (#2428)
- Added support for hit count breakpoint conditions. (#895)
- Support the
applicationUrl
property in launchSettings.json. (#2296) - Improve the error message when attaching to privileged processes on Linux and macOS. (#477)
1.15.2 (May 15, 1018)
- Fixed a 1.30.0 regression that prevented the script project system from working on Unix-based systems (omnisharp-roslyn#1184, PR: omnisharp-roslyn#1185) (Contributed by @filipw)
- Fixed a regression that could cause the debugger to crash on Windows (#2297).
1.15.1 (May 11, 1018)
- The minimum Mono version required to run OmniSharp on has been increased to 5.8.1.
1.15.0 (May 10, 2018)
Debugger
-
New features:
- Adds support for Source Link, Symbol Servers and other more advanced symbol options (#373)
- Adds launch.json option to suppress Just-In-Time compiler optimizations.
- Due to the previous two items and work from the .NET Team, it is now possible to easily debug into ASP.NET itself in projects running against .NET Core 2.1. Instructions are in the wiki.
- Adds support for pulling in environment variables from
${cwd}/Properties/launchSettings.json
. This means that if you add environment variable configuration to your launchSettings.json file, they will now be used when you start your app from Visual Studio Code like they previously would be used from the command line (dotnet run
), and from Visual Studio. (#2017)
-
Bug fixes:
- On Linux, this reduces the native dependencies of the debugger to match the .NET Core 2.1 runtime. The Linux .NET Core 2.1 runtime reduced its native dependencies over all the previous versions, but the debugger still had the same dependencies as .NET Core 2.0. With this fix, the debugger will now continue to work on Linux after installing the .NET Core runtime and nothing else. (#2199)
- Fixes async call stacks with the .NET Core 2.1 runtime. (#1892)
- Fixes the debugger's browser launch code when launching projects configured to use Application Insights. (2177)
Editor
- Fixed regression where the "Generate Type in New File" code action would create an empty file. (#2112, PR: omnisharp-roslyn#1143)
- Made several improvements to the display of tooltips in Signature Help. (#1940, PR: #1958)
Options
-
"omnisharp.path": This option has been updated to enable the user to specify different versions of OmniSharp, including prerelease versions. (#1909, PR: #2039)
Possible values for this option are:
<Path to the omnisharp executable>
: Use a local copy of OmniSharp. The value must point directly to the OmniSharp executable. This is typically the build output directory of the omnisharp-roslyn project on the current machine, for example,C:/omnisharp-roslyn/artifacts/publish/OmniSharp.Stdio/win7-x64/OmniSharp.exe
.latest
: Use the latest CI build from omnisharp-roslyn.<version>
: Use a specific version of OmniSharp. Example:1.29.2-beta.60
If "omnisharp.path" is not set, the defalut version of OmniSharp for the current release of C# for VS Code is used.
-
"omnisharp.useGlobalMono": This option replaces the old "omnisharp.useMono" option and controls whether or not OmniSharp will be launched with a globally-installed version of Mono. (PR: #2244)
There are three possible values:
- "auto": Automatically launch OmniSharp with
mono
if version 5.2.0 or greater is available on the PATH. - "always": Always launch OmniSharp with
mono
. If version 5.2.0 or greater is not available on the PATH, an error will be printed. - "never": Never launch OmniSharp on a globally-installed Mono.
- "auto": Automatically launch OmniSharp with
-
It is now possible to suppress the "Some projects have trouble loading" popup using the
omnisharp.disableMSBuildDiagnosticWarning
option. (#2110
Project System
-
Several common globbing patterns are now excluded by default when OmniSharp scans for
*.csproj
,*.cake
, or*.csx
files to load. The deafault patterns are**/node_modules/**/*
,**/bin/**/*
,**/obj/**/*
,**/.git/**/*
. (omnisharp-roslyn#896, PR: omnisharp-roslyn#1161) (Contributed by @filipw) -
The list of globbing patterns that are excluded by OmniSharp can be customized in an
omnisharp.json
file list so.{ "systemExcludeSearchPatterns": [ "**/test/**/*" ], "excludeSearchPatterns": [ "**/local/**/*" ] }
For more details on configuring OmniSharp see Configuration Options at the omnisharp-roslyn repo. (omnisharp-roslyn#896, PR: omnisharp-roslyn#1161) (Contributed by @filipw)
-
Improved handling of projects with XAML files. (#2173, PR: omnisharp-roslyn#1157)
-
MSBuild is now properly located on Windows for Visual Studio 2017 previews. (omnisharp-roslyn#1166) (Contributed by @rainersigwald)
Scripting
-
It is now possible to define the default target framework for C# scripts in an
omnisharp.json
file.{ "script": { "defaultTargetFramework": "netcoreapp2.0" } }
(PR: omnisharp-roslyn#1154) (Contributed by @filipw)
Status Bar
-
Splits the OmniSharp status bar item into two parts, both of which appear on the left side of VS Code's status bar and have specific responsibilities. (#2146, PR: #2133)
- OmniSharp Server info:
- Displays the current state of the OmniSharp server, such as Downloading, Installing, etc. The flame icon is green when the server is initialized and running properly, or red if there is an error.
- Selected Project info:
- Displays the name of the selected project regardless of the currently active document.
- If a project is already selected, it displays the name of the selected project. Clicking on it displays a menu to switch to other projects in the workspace.
- If there are multiple possible launch targets, it displays 'Select Project'. Clicking on it displays a menu to select one.
- OmniSharp Server info:
Testing
- Added "debug all tests" and "run all tests" to the CodeLens that appears above test classes to allow running or debugging all tests in a class. (#420, PRs: #1961, omnisharp-roslyn#1089
Misc
1.14.0 (February 14, 2018)
C# Language Support
- Support for C# 7.2 (PR: omnisharp-roslyn#1055) (Contributed by @filipw)
Debugger
- Fixes symbol loading while debugging apps running under .NET Core 2.1 (ex: netcoreapp 2.1) on Linux and macOS
- Fixes debug console message encoding issue on Windows (#1775).
- Adds support for extracting source files embedded in PDBs. See the C# EmbeddedFiles feature for more information.
- Adds preliminary support for Linux ARM debugging
Editor
- Fix to allow signature help return results for attribute constructors. (#1814, PR: omnisharp-roslyn#1007)
- Fix to return correct SymbolKinds from WorkspaceSymbolprovider (#1907, PR: #1911) (Contributed by @craig006)
- Improved newline formatting in hover info (#1057, PR: #1918)
- Disabled Go To Definition on property acessor keywords (#1949, PR: omnisharp-roslyn#1086)
- Bug fixes to IntelliSense (completion, signature help): ((#1664, 1440, PR: omnisharp-roslyn#1030); (#146 , PR: #1776))
- Improved "Format Code" behavior: (#214, PR: omnisharp-roslyn#1043)
- Improved code action ordering: (omnisharp-roslyn#758, PR: omnisharp-roslyn#1078)
- Fixed duplicate errors in error list (#1830, PR:#1107)
Project System
- Addressed problems with projects not being refreshed by OmniSharp after a package restore. (#1583, #1661, #1785, PR: omnisharp-roslyn#1003)
- Added option to disable warning about project.json deprecation (1920, PR: #1926)
Task Generation
- Updated task generator to match latest schema from VS Code (PR: #1932) (Contributed by @natec425)
- Fixed a typo in tasks.json (PR: 1945) (Contributed by @SebastianPfliegel)
Misc
1.13.1 (November 13, 2017)
- Addressed problem with Sdk-style projects not being loaded properly in certain cases. (#1846, #1849, PR: omnisharp-roslyn#1021)
- Fixed issue with discovering MSBuild under Mono even when it is missing. (omnisharp-roslyn#1011, PR: omnisharp-roslyn#1016)
- Fixed issue to not use Visual Studio 2017 MSBuild if it is from VS 2017 RTM. (omnisharp-roslyn#1014, PR: omnisharp-roslyn#1016)
1.13.0 (November 7, 2017)
Cake
- Added support for *.cake files! (PRs: #1681, omnisharp-roslyn#932) (Contributed by @mholo65)
Debugger
- Improved logic for resolving breakpoints in local functions and lambdas. (#1678)
- When generating a new launch.json file via "start debugging" in a workspace without a launch.json file, the extension now provides the same content as is created with the '.NET: Generate Assets for Build and Debug' command. This takes advantage of a new extensibility point from VS Code. Before the C# extension could only statically provide templates, so, for example, they couldn't have the path to the launchable project. (PR: #1801)
Editor
- Improved completion list behavior when matching substrings. (PRs: #1813, omnisharp-roslyn#990) (Contributed by @filipw)
- Completion list now triggers on SPACE after
new
. (#146, PR: #1776, omnisharp-roslyn#975)
Navigation
- Fixed issue with Go to Definition where it was not possible to navigate to a definition within the same file if the file was generated from metadata. (PR: #1772) (Contributed by @filipw)
- Improved symbol search behavior when matching substrings. (PR: omnisharp-roslyn#990) (Contributed by @filipw)
Project System
- Significantly changed how MSBuild is located by OmniSharp, resulting in more project types loading properly. (PR: omnisharp-roslyn#988)
- Fixed bug where
LangVersion
property was not read correctly from project file, blocking C# 7.1 development. (omnisharp-roslyn#961, PR: omnisharp-roslyn#962]) (Contributed by @filipw) - Fixed issue where signing key was not read correctly from project file, which can result in InternalsVisibleTo not being handled properly. (PR: omnisharp-roslyn#964)
- Fixed long-standing problem with renaming files. (#785, #1792, PR: #1805)
- Fixed problem where the Antlr4.CodeGenerator Nuget package would not generate files during OmniSharp design-time build. (#1822, PR: omnisharp-roslyn#1002)
- Fixed issue where a C# project referencing a non-C# project would cause the referenced project to be loaded (causing OmniSharp to potentially treat it as C#!). (#371, #1829, PR: omnisharp-roslyn#1005)
Testing
- Fix error that occurs when running or debugging tests with latest xUnit 2.3.0 builds. (#1733, omnisharp-rolsyn#944, PR: omnisharp-roslyn#945, #1749)
- Fix issue causing NUnit tests not to work when running or debugging tests. (#1615, PR: #1760). (Contributed by @dgileadi)
- Pass
--no-restore
when invokingdotnet build
to ensure that implicit restore does not run, making the build and the test run a bit faster. (omnisharp-roslyn##942, PR: omnisharp-roslyn#945) - Fix Unit Test debugging with VS Code 1.18. (#1800)
Other Updates and Fixes
- If Mono 5.2.0 or greater is installed, OmniSharp will be launched on that rather than the local Mono runtime that it carries with it. This allows, more Mono and Xamarin projects to load properly and improves OmniSharp performance (since it can run on Mono AOT'd binaries). (#1779, PR: #1789)
- Support added for launching OmniSharp on folders and solutions across multi-root workspaces. (#1762, PR: #1806)
- Added
csharp.referencesCodeLens.enabled
andcsharp.testsCodeLens.enabled
options to allow disabling/enabling for the 'references' and 'run/debug test' code lenses independently. (#1570, #1807, PRs: #1781, #1809)
1.12.1 (August 14, 2017)
- MSBuild support properly sets CscToolExe to 'csc.exe' to address issues when a project's MSBuild targets have set it to 'mcs.exe'. (#1707)
1.12.0 (August 8, 2017)
Debugger
- Update debugger to run itself on .NET Core 2.0-preview2 (target app can still use .NET Core 1.x). This allows the debugger to run on more Linux distributions, and it allows there to be a single debugger package for all supported Linux distributions.
- Fix issue where the call stack may be empty when stepping quickly (#1575)
- Improvements to the information displayed in the editor peak window when stopping on an exception that has inner exceptions (#1007)
- Fix expression evaluation when stopping at an exception in .NET Core 2.0 (#1593)
- Improve error behavior when
"program"
in launch.json is set to a path that doesn't exist (#1634) - Enable stepping by statement (instead of by line) (#1476)
Editor
- Go to Definition now works from "metadata as source" files (#771, PR: #1620) (Contributed by @filipw)
- Selection-based code fixes and refactorings (such as "Extract Method") will no longer be offerred unless there is actually a selection in the editor. (#1605, PR: #1606)
Project System
- Mono targets and tasks are now better located when Mono is installed. This enables support for many Mono-based projects types, such as Xamarin.iOS, Xamarin.Android, MonoGame, etc. (#1597, #1624, #1396 omnisharp-roslyn#892, PR: omnisharp-roslyn#923)
- Use new solution parer to be more resilient against invalid solution files. (1580, 1645, PRs: omnisharp-roslyn#897 and omnisharp-roslyn#918)
- The MSBuild project system now calls the "Compile" target rather than the "ResolveReferences" target when processing MSBuild files. This has the effect of ensuring that other targets have the opportunity to run (such as targets that generate files) while still not building any output binaries. (#1531)
- Binding redirects added for MSBuild assemblies, fixing issues with MSBuild tasks built with different versions of MSBuild. (omnisharp-roslyn#903)
- The OmniSharp server has updated to the latest MSBuild. (omnisharp-roslyn#904, PR: omnisharp-roslyn#907)
Scripting
- Support added for referencing NuGet packages in C# scripts. (PR: omnisharp-roslyn#813) (Contributed by @seesharper)
- System.dll is now added correctly for C# scripts targeting .NET Framework. (omnisharp-vscode#1581, PR: #898) (Contributed by @filipw)
Other Updates and Fixes
- Switched to a new CDN for the extension's dependencies which should deliver an improved download experience (#1542)
- Automatically activate the extension when opening workspaces that contain any .csproj, .sln, or .csx files (#1375, #1150, PR: #1592))
- Added nag message when project.json projects are opened by OmniSharp, to serve as a reminder to migrate projects from project.json to .csproj. (PR: #1657)
- Added
type
property tocsharp.unitTestDebuggingOptions
to allow debugging tests with 'clr' debugger (Windows only). (#1586, PR: #1663) - The
[csharp]
configuration section is now checked for formatting options. (#1574) (Contributed by @filipw) - All project systems (project.json, MSBuild, CSX Scripting) now support an "Enabled" property that can be configured in omnisharp.json. (PR: omnisharp-roslyn#902) (Contributed by @filipw)
- The OmniSharp server has been updated to Roslyn 2.3.0, which adds support for C# 7.1 (PRs: omnisharp-roslyn#900, omnisharp-roslyn#901, omnisharp-roslyn#930 and omnisharp-roslyn#931)
1.11.0 (June 27, 2017)
Completion List
- No longer trigger completion when a '<' character is typed. (#1521, PR: #1530)
- Completion list no longer triggers on space in contexts where a lambda expression could be typed. (#1524, PR: #1548)
Project System
- Fixed support for the latest .NET Core 2.0 preview. (#1566)
Other Updates and Fixes
- Improved download speeds for OmniSharp and Mono dependencies.
- Allow the ".NET: Restore Packages" command to run on projects targeting full framework. (#1507, PR: #1545) (contributed by @adamhartford)
1.10.0 (May 25, 2017)
Completion List
- Several improvements to the completion list! (All contributed by @filipw with PR omnisharp-roslyn#840)
- Attributes are completed properly without the 'Attribute' suffix. (#393)
- Named parameters now appear in the completion list. (#652)
- Object initializer members now appear in the completion list. (#260)
- Completion appears within XML doc comment CREFs.
- Initial support for completion on 'override' and 'partial' keywords. (#1044)
- New VS Code completion item glyphs (e.g. struct, event, etc.) are supported. (PR: #1472) (Contributed by @dopare)
- Updated completion to use same commit characters as Visual Studio. Completion should now complete as non-identifier characters are typed. (#1487, #1491, PR: #1494)
Project System
- Project references to projects located outside of the current workspace directory are now loaded and processed. (#963, PR: omnisharp-roslyn#832)
- OmniSharp now loads .NET Core projects using the SDKs included with the .NET Core SDK appropriate for that project, if they're installed on the machine. (#1438, omnisharp-roslyn#765, PR: omnisharp-roslyn#847)
- Options can now be set in an omnisharp.json to specify the Configuration (e.g. Debug) and Platform (e.g. AnyCPU) that MSBuild should use. (omnisharp-roslyn#202, PR: omnisharp-roslyn#858) (Contributed by @nanoant)
- Fixed issue where a package reference would be reported as an unresolved dependency if the reference differed from the intended dependency by case (PR: #861)
- Cleaned up unresolved dependency detection in OmniSharp and added logging to help diagnose project issues. (#1272, PR: #861)
Scripting
- Support Metadata as Source for Go To Definition in CSX files. (omnisharp-roslyn#755, PR: (omnisharp-roslyn#829) (Contributed by @filipw)
Unit Testing
- MSTest support added (#1482, PRs: #1478, omnisharp-roslyn#856) (Contributed by @AbhitejJohn)
- Add support for NUnit Test Adapter. (#1434, PR: omnisharp-roslyn#834)
- Files are saved before running or debugging tests to ensure that recent unsaved changes are included in test runs. (#1473, PR: #1493)
- Tests that define display names are now run properly. (#1426, PR: omnisharp-roslyn#833)
- Tests with similar names are no longer incorrectly run together when one of them is clicked. (#1432, PR: omnisharp-roslyn#833)
- Improve response from running/debugging tests to include output from build and test summary. (#419, #455, PRs: #1436, #1486)
- Added
csharp.unitTestDebugingOptions
setting to pass launch.json-style debug options (example:justMyCode
) when unit test debugging.
Debugger
- Resolves crash on OSX when the target process loads an embedded PDB (#1456). This commonly affects users trying to debug XUnit tests.
- Enhanced exception peek display to provide additional exception properties.
Other Updates and Fixes
- New
csharp.suppressHiddenDiagnostics
setting that can be set to true to display hidden diagnostics, such as 'unnecessary using directive'. (#1429, PR: #1435) (Contributed by @cruz82) - Fix issue causing several code snippets to not be available. (#1459, PR: #1461) (Contributed by @shaunluttin)
- Ensure the 'Generate Assets for Build and Debug' command can cause the extension to activate. (PR: #1470)
- The OmniSharp process is now correctly terminated on Unix when the 'Restart OmniSharp' command is invoked. (#1445, PR: #1466)
- Added new
RoslynExtensions
option to allow specifying a set of assemblies in an omnisharp.json file that OmniSharp will look in to find Roslyn extensions to load. (PR: omnisharp-roslyn#848) (Contributed by @filipw)
1.9.0 (April 20, 2017)
Unit Testing
- Support added for running and debugging unit tests in .csproj-based .NET Core projects. (#1100)
Debugger
- Arch Linux change: Before, the debugger would automatically use the Ubuntu 16 debugger on Arch. Now we require the debugger to be explicitly set. See https://aka.ms/vscode-csext-arch for more information.
- Several bug fixes that addressed problems with launch (#1335, #1336)
- Fixed several pipeTransport issues including introducing a new
quoteArgs
option (#1318), and fixing attach with Docker (#1369) - Fix issue where VS Code would incorrectly display threads as paused (#1317)
- Added new 'csharp.fallbackDebuggerLinuxRuntimeId' configuration setting to control the version of the debugger used on Linux (#1361).
- Added a new
clr
debuggingtype
in launch.json to enable debugging for Azure scenarios. That type is limited to Windows Desktop CLR, 64-bit processes, and only supports the Portable PDB debug format. - Added support for the launch.json editor's 'Add Configuration' button (#1024)
Project System
- Properly handle package references with version ranges in .csproj (PR: omnisharp-roslyn#814)
- Fix regression with MSBuild project system where a project reference and a binary reference could be added for the same assembly, causing ambiguity errors (omnisharp-roslyn#795, PR: omnisharp-roslyn#815)
- If VS 2017 is on the current machine, use the MSBuild included with VS 2017 for processing projects. (#1368, PR: omnisharp-roslyn#818https://github.com/OmniSharp/omnisharp-roslyn/issues/818)
- Fixed null reference exception in DotNetProjectSystem when project reference is invalid (PR: omnisharp-roslyn#797)
Improved OmniSharp Settings
-
Added support for global omnisharp.json file (omnisharp-roslyn#717, PR: omnisharp-roslyn#809) (Contributed by @filipw)
This file can appear in one of the following locations:
- Windows:
%APPDATA%\OmniSharp\omnisharp.json
- macOS/Linus:
~/.omnisharp/omnisharp.json
- Windows:
-
Watch local and global omnisharp.json files for changes while OmniSharp is running. Currently, this only works for formatting options. (PR: omnisharp-roslyn#804)(Contributed by @filipw)
-
New 'omnisharp.waitForDebugger' setting to make it easier to debug the OmniSharp server itself. (PR: #1370)
Other Updates and Fixes
- Improvements made to project.json package completion experience. (#1338)
- Diagnostics are no longer created for hidden diagnostics, addressing the problem of "Remove Unnecessary Usings" spam in the Problems pane. (#1231)
- Improved the extension's runtime dependency download logic to skip re-downloading packages that were already successfully downloaded and installed.
- Assets for building and debugging are now always generated with POSIX style paths. (#1354)
- Don't offer to generate tasks.json if build task already exists. (PR #1363) (Contributed by @eamodio)
1.8.1 (March 31, 2017)
Fixes debugging on macOS Sierra 10.12.4.
1.8.0 (March 10, 2017)
Go to Implementation
- Added support for "Go to Implementation" and "Peek Implementation" introduced in Visual Studio Code 1.9. (#37) (Contributed by @ivanz)
Scripting
- C# scripts (.csx files) now allow multiple
#load
directives, and#r
and#load
directives update live. (omnisharp-roslyn#760) (Contributed by @filipw) - .csx files can now be discovered as valid launch targets using the project selector at the bottom-right of the status bar. (#1247) (Contributed by @filipw)
- Assembly references will now unify properly for C# scripts. (omnisharp-roslyn#764) (Contributed by @filipw)
- Unsafe code is now allowed in C# scripts. (omnisharp-roslyn#781) (Contributed by @filipw)
- C# scripting now ignores duplicated CorLibrary types, which can manifest in certain edge scenarios. (omnisharp-roslyn#784) (Contributed by @filipw)
Debugger
The 1.8 release makes a major change to how the debugger works under the hood. This new architecture simplifies how the debugger is tied to VS Code. We hope that this will make it easier to bring .NET debugging features to VS Code. We also expect it to improve debugger launch performance.
Changes:
-
The module load messages in the output window are now more detailed and hopefully less confusing. (#837)
-
Programs can now be launched into VS Code's integrated terminal. (documentation)
-
VS Code recently introduced column breakpoint support and they are now enabled for C#.
-
React to the VS Code change to use
${command:
instead of${command.
. (#1275) -
Fix a problem with browser launch support that could lead to debugger session's being aborted when the browser is started. (#1274)
-
Remote debugging breaking changes: as part of our new architecture, there are a few breaking changes to the way remote debugging works.
- vsdbg vs. clrdbg: As part of the new architecture, clrdbg has been replaced with a new executable named vsdbg. As such, the script to download vsdbg has changed to http://aka.ms/getvsdbgsh. Run
curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l ~/vsdbg
to download. See the wiki for more information. - Pseudo-tty's are no longer supported: previously we were a little more tolerant of pseudo-tty's transforming the input/output from the remote debugger. We are currently not as tolerant. If you are using
ssh
orplink
as a pipe program, pass-T
to fix this. If you have another transport and you are no longer able to connect, let us know and we can fix this for a future release. debuggerPath
is now required - previously thedebuggerPath
property ofpipeTransport
was recomended but not required. As part of this change we are now requiring it.
- vsdbg vs. clrdbg: As part of the new architecture, clrdbg has been replaced with a new executable named vsdbg. As such, the script to download vsdbg has changed to http://aka.ms/getvsdbgsh. Run
Other Updates and Fixes
- Find All References now properly highlights locations of found references. (#428)
- Assembly references will now unify properly for project.json projects. (#1221)
- Code Actions (i.e. refactorings and fixes) now respect the formatting options that are set when a project is opened. (omnisharp-roslyn#759) (Contributed by @filipw)
- Completion support for package references in project.json files has been restored. (#1236)
- The C# TextMate grammar used for syntax highlighting has been removed because it is now part of Visual Studio Code itself. (#1206) (Many thanks to @aeschli)
1.7.0 (February 8, 2017)
Syntax Hightlighting
- Introduced a brand new TextMate grammar written from scratch that provides much more robust C# syntax highlighting. (#101, #225, #268, #316, #674, #706, #731, #746, #782, #802, #816, #829, #830, #861, #1078, #1084, #1086, #1091, #1096, #1097, #1106, #1115)
- The C# TextMate grammar has a new home! Issues and contributions are welcome at https://github.com/dotnet/csharp-tmLanguage.
Project Support
- Updated with the latest changes for .NET Core .csproj projects. (omnisharp-roslyn#738)
- Automatic package restore and out-of-date notifications implemented for .NET Core .csproj projects. (#770)
- Correctly update project when dotnet restore is performed on a .NET Core .csproj project. (#1114)
- Properly handle .csproj projects in .sln files that were added via .NET CLI commands. (omnisharp-roslyn#741)
- Fix
dotnet restore
Visual Studio Code command to execute for .csproj .NET Core projects. (#1175) - Respect
nowarn
in project.json projects. (omnisharp#734) (Contributed by @filipw) - Fix problem with project.json projects that wrap assemblies. (#424)
Debugging
- Enable debugger support for Zorin OS 12. (#1160) (Contributed by @mkaziz)
- Added off-road support for Windows Subsystem for Linux (NOTE: requires newer version of Windows than have been publicly released yet)
- Fixed issue with debugger pause and multithreaded call stacks (#1107 and #1105)
C# Scripting
- Support resolving
#r
references from the GAC. (omnisharp-roslyn#721) (Contributed by @filipw) - Include System.ValueTuple in C# scripts implicitly. (omnisharp-roslyn#722) (Contributed by @filipw)
Code Actions
- Fixed code actions that add files, such as "Move Type to File". (#975)
- Properly surface code actions that have "nested code actions". This allows "generate type" to work properly. (#302)
- Don't display the Remove Unnecessary Usings code action unless it is relevant. (omnisharp-roslyn#742)
- Don't show the Extract Interface refactoring as it requires a dialog that does not exist in VS Code. (#925)
Completion List
- A namespace icon should be displayed for namespaces in the completion list. (#1125) (Contributed by @filipw)
- Add icons for several symbol kinds in the completion list, fixing many symbols that incorrectly displayed a property "wrench" icon. (#1145)
Other Updates and Fixes
- Add schema validation for omnisharp.json files. (#1082) (Contributed by @Thaina)
- Add support for auto-closing and surrounding characters. (#749, #842) (Contributed by @filipw)
- Fix running and debugging of tests defined in nested classes. (#743, #1151)
- Fix error when 'tasks.json' does not contain a 'tasks' node, or contains os-specific 'tasks' nodes. (#1140)
- Better detection of Windows architecture (x86 or x64) when determining extension dependencies to download. The detection logic now uses well-known environment variables rather than launching 'wmic'. (#1110, #1125)
- Improvements to the OmniSharp Log (#1155)
- Add new values to the
omnisharp.logginglevel
option to allow more granualar control of OmniSharp logging. (#993) (Contributed by @filipw) - Don't display the "some projects have trouble loading" message if projects only contain warnings. (#707)
- Update Mono detection logic to succeed even if another shell is set as the default (e.g. zsh). (#1031)
1.6.2 (December 24, 2016)
- Fix performance issue when editing type names containing multiple generic type parameters. (#1088, #1086)
1.6.1 (December 22, 2016)
- Fix crash when tasks.json contains comments. (#1074)
1.6.0 (December 21, 2016)
C# Scripting
- Roslyn scripting support in CSX files! (#23, omnisharp-roslyn#659) (Contributed by @filipw)
Project Support
- Support for latest .NET Core .csproj projects updates. (omnisharp-roslyn#705)
- Update 'tasks.json' and 'launch.json' generation to support .NET Core .csproj projects. (#767)
- Properly support
<NoWarn>
in MSBuild projects and specifically ignore theCS1701
warning in .NET Core MSBuild projects. (#967) - Fix global.json-based project search to also the top-level folders specified by the
"projects"
property and not just their children. (#904 and #962)
Debugging
- Update the debugger so that the debugger itself runs on .NET Core 1.1. This change:
- Enables debugger support for additional Linux distributions - Ubuntu 16.10, openSUSE 42, Fedora 24
- Brings support for running all supported distros on top of Linux Kernel >= 4.6
- Enable debugger support for Arch Linux (#564)
- Improve debugger install errors for macOS without openSSL symlinks (#986), and x86 Windows (#998).
- Improve debugger performance using precompiled debugger binaries (#896)(#971).
Syntax Highlighting
- Tons of great syntax highlighting fixes and support! (All contributed by @ivanz)
- Fix for field declarations. (#757)
- Fix for generic types with multiple type parameters. (#960)
- Proper support for interpolated strings (verbatim and non-verbatim). (#852)
- Fix for multi-line properties. (#854)
- Fixes for events, nested type references (e.g.
Root.IInterface<Something.Nested>
), variable declarations, nested classes, and fields spanning multiple lines
Hover Tooltips
- Improve display of hover tool tips for built-in C# types, such as
int
andstring
. (#250) (Contributed by @filipw) - Improve display of hover tool tips for nested classes. (#394) (Contributed by @filipw)
- Fix spacing in hover tool tips around
<paramref/>
in XML doc comments. (#672) (Contributed by @filipw)
Other Updates and Fixes
- Support for running/debugging NUnit tests (#996) (Contributed by @HexWrench)
- Fix exception thrown when sending
/autocomplete
request to OmniSharp server in location where no completion items are available. (#980) - Add
omnisharp.maxProjectResults
setting to control the maximum number of projects to display in the 'Select Project' dropdown. The default is 250. (#875) (Contributed by @filipw) - Fix signature help display for constructors. (#36) (Contributed by @filipw)
- Ensure that the
editor.insertSpaces
andeditor.tabSize
settings are passed to OmniSharp for formatting. Note that this behavior can be controlled with theomnisharp.useEditorFormattingSettings
option, which defaults to true. (#1055) (Contributed by @filipw)
1.5.3 (November 21, 2016)
- Use value of
http.proxyStrictSSL
even whenhttp.proxy
is not set. (#957)
1.5.2 (November 15, 2016)
- Ensure diagnostics are cleared in files when they are no longer needed. (#858)
- Enqueue requests for diagnostics in visible editors when the extension starts up. (#843)
- Provide fallback URLs for debugger downloads. (#930)
- Properly require .NET Framework 4.6 in the OmniSharp.exe.config file to ensure that the user is displayed a dialog on Windows machines that don't have .NET Framework 4.6 installed. (#937)
- Fix issue with installing on non-English installations of Windows. (#938)
- Display platform information when acquiring runtime dependencies. (#948)
1.5.1 (November 14, 2016)
- Fix to properly support
http.proxy
andhttp.proxyStrictSSL
settings. (#930)
1.5.0 (November 14, 2016)
Initial support for C# 7
- New C# 7 features like pattern-matching and tuples are now supported in VS Code editor. Note: To use tuples, you will need a reference to this NuGet package.
Initial support for CSProj .NET Core Projects
- With the .NET Core SDK moving to embrace MSBuild and .csproj files over project.json, we've made sure the C# extension can handle the new format. This support is preliminary and there are still several features coming to smooth out the experience.
Broader OS Support for C# Code Editing
-
This release dramatically changes the runtime that OmniSharp runs on, which allows it to be run an many more operating systems than before:
- Windows: OmniSharp runs on the installed .NET Framework. In addition, OmniSharp now runs on 32-bit Windows!
- macOS/Linux: OmniSharp runs on a custom embedded Mono runtime. Note: Mono does not need to be installed on the system for this to work.
Debugger
- Remote debugging is now supported for attach by using the
pipeTransport
launch.json option. - Resolved issue with setting breakpoints when there are multple files with the same name (e.g. two 'Program.cs' files).
New Dependency Acquisition System
- This improves the acquisition and reliability of platform-specific OmniSharp and debugger dependencies.
New Settings
Several new settings have been added:
csharp.suppressDotnetRestoreNotification
: Suppress the notification window to perform a 'dotnet restore' when dependencies can't be resolved.omnisharp.projectLoadTimeout
: The time Visual Studio Code will wait for the OmniSharp server to start. Time is expressed in seconds. (Contributed by @wjk)
Colorizer
- A new unit testing framework for testing the colorizer grammer (#742) (Contributed by @ivanz)
- Single-line comments after preprocessor directives (#762) (Contributed by @damieng)
Performance
- Major improvements have been made to editor performance. The communication with the OmniSharp server has been rewritten to allow long-running operations (such as gathering all errors and warnings) to queue while high priority operations (such as text buffer changes) run serially. (#902) (Thanks to @david-driscoll for his help with this change!)
Other Improvements
- The prompt to generate assets for building and debugging can now be dismissed for a workspace permanently. In addition, a new
dotnet.generateAssets
command has been added to force regeneration of the assets. (#635) - Fix "running forever" issue for folder with multple .NET Core projects. (#735) (Contributed by @eamodio)
ctor
snippet is now more consistent with other code snippets. (#849) (Contibuted by @Eibx)- Ampersands in file paths are now properly escaped on Windows (#909) (Contributed by @filipw)
1.4.1 (September 1, 2016)
- This addresses an issue found and fixed by @sixpindin in which the legacy csharp.omnisharp and csharp.omnisharpUsesMono settings are no longer respected. These settings have been supplanted by the omnisharp.path and omnisharp.useMono settings but are still expected to work if specified.
1.4.0 (August 29, 2016)
Metadata as Source
- Go to Definition (F12) can now show a C#-like view for APIs that do not appear in your project's source code. (#165)
Debugger
- Applications can now be launched without attaching the debugger with Ctrl+F5.
- Support for new "embedded portable PDB" debug format.
- The launch.json file generator now automatically sets the option to show a console window by default (
"internalConsoleOptions": "openOnSessionStart"
).
New Settings
Several new settings have been added:
csharp.suppressDotnetInstallWarning
: Suppress the warning that the .NET CLI is not on the path.omnisharp.autoStart
: Used to control whether the OmniSharp server will be automatically launched when a folder containing a project or solution is opened. The default value for this setting istrue
.omnisharp.path
: Can be used to specify a file path to a different OmniSharp server than the one that will be used by default. Previously, this option was controlled bycsharp.omnisharp
, which is now deprecated.omnisharp.useMono
: Whenomnisharp.path
is specified, this controls whether OmniSharp will be launched with Mono or not. Previously, this option was controlled bycsharp.omnisharpUsesMono
, wich is now deprecated.omnisharp.loggingLevel
: Used to control the level of logging output from the OmniSharp server. Legal values are"default"
or"verbose"
.
Colorizer
There have been several fixes to the colorizer grammar resulting in much smoother syntax highlighting, with better support for C# 6.0. Special thanks go to @ivanz and @seraku24 for contributing most of the fixes below!
- Expression-bodied members (#638, #403, #679, #249)
- Escaped keyword identifiers (#614)
- Using directives and nested namespaces (#282, #381)
- Field and local variable type names (#717, #719)
- Multi-dimensional arrays in parameters (#657)
Performance
- Improvements have been made in processing diagnostics (i.e. errors and warnings).
- Full solution diagnostics are no longer computed for large solutions (e.g. solutions with >1000 files across all projects). However, diagnostics are still computed for open files.
Other Improvements
- Multibyte characters are now properly encoded, resulting in proper display in tooltips and fixing crashes in the OmniSharp server. (#4, #140, #427)
- Will no longer attempt to install a CoreCLR flavor of OmniSharp on Ubuntu versions other than 14 and 16. (#655)
- Opening a solution or csproj no longer results in '0 projects' displayed in the status bar. (#723)
1.3.0 (July 20, 2016)
- Support for Unity and Mono development on macOS and Linux has been restored! This release brings back support for the Mono version of OmniSharp, which is used to provide much better support for .csproj/.sln projects. Please note that Mono version 4.0.1 or newer is required.
- Generation of tasks.json and launch.json files can now properly handle nested projects. #170
- New UI that makes it easy to select a process ID when attaching the debugger to another process. Note: If you have an existing launch.json file, you can re-generate it by deleting the file, closing your workspace in Visual Studio Code and opening it again. Or, you can open the launch.json file and change the
processId
value to"${command:pickProcess}"
. - Support for debugging in .cshtml files. To enable this, add a
sourceFileMap
entry to your launch.json with the following content:"sourceFileMap": { "/Views": "${workspaceRoot}/Views" }
- Support for conditional breakpoints
- New support for changing variable values in the debugger! To try this, just right-click on the variable name and select 'Set Value'. Note: To properly support this feature, we've changed the display of variable type names in the debugger to a shortened form. The full type name can be viewed by hovering over the name with the mouse.
- New configuration option to enable stepping into properties and operators.
- Duplicate warnings and errors should no longer accumulate in Unity projects #447
1.2.0 (June 29, 2016)
- 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)