39 KiB
Known Issues in 1.11.0
- When opening a .csproj-based .NET Core project in VS Code, the C# extension will not activate until a C# file is opened in the editor. (#1150)
- There currently is no completion support for package references in csproj files. (#1156)
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)