VisualStudio.Extensibility is a new framework for developing Visual Studio extensions. The new framework focuses primarily on extensions that run out-of-process from the IDE for improved performance and reliability, and it features a modern, asynchronous API that has been streamlined and carefully engineered to maximize developer productivity. VisualStudio.Extensibility is in active development.
With the current version, you can develop a wide range of extensions to Visual Studio, including creating commands, working with code or text in the editor, displaying prompts or dialogs to the user, creating debugger visualizers, and more!
VisualStudio.Extensibility aims to address many of the problems developers experience when using and writing extensions in Visual Studio. Writing extensions using VisualStudio.Extensibility provides the following benefits:
Important Documentation for the VisualStudio.Extensibility SDK has moved to a new location: VisualStudio.Extensibility documentation.
Documentation is currently available for the following:
| Article | Description |
|---|---|
| Install VisualStudio.Extensibility | Download and install VisualStudio.Extensibility. |
| Get started | Start with beginner quickstarts and introductory tutorials if you've never developed an extension before. |
| Concepts | Build your mental model of how the SDK and extensions work. |
| Overviews | Learn more by reading overviews of each major area of functionality. |
| Samples | Explore sample code demonstrating major features. |
| API reference | Browse the VisualStudio.Extensibility API documentation. |
| Experimental APIs and Breaking Changes | Learn about our approach to stable-vs-experimental APIs and about breaking changes from the previous version. |
| Known Issues | View known issues with the VisualStudio.Extensibility SDK. |
| Advanced topics | Learn implementation details of the VisualStudio.Extensibility SDK. |
VisualStudio.Extensibility works with Visual Studio 2022 version 17.9 or higher with the Visual Studio extension development workload to be installed. VisualStudio.Extensibility extensions can be installed on Visual Studio 2022 version 17.9 and above.
VisualStudio.Extensibility packages having a version higher than 17.9 provide additional functionalities and can be used when targeting the corresponding version of Visual Studio. For example, when building an extension with VisualStudio.Extensibility packages version 17.10, the resulting extension will be compatible with Visual Studio 17.10 and above.
The following articles will help you get oriented and started:
To understand how to work with VisualStudio.Extensibility, we recommend a thorough understanding of asynchronous programming with async and await and dependency injection. In addition, UI in VisualStudio.Extensibility is based on Windows Presentation Foundation (WPF), so you might want to review the WPF documentation.
If you're familiar with the Visual Studio SDK, refer to Introduction to VisualStudio.Extensibility for VSSDK users.
To build your mental model of how Visual Studio extensions work, see Parts of a new Visual Studio extension.
To find out what is included in the SDK, see Functional areas of the SDK.
Visual Studio extensions appear in the IDE when certain conditions are met. To have control over how and when your extension appears in the IDE, see Rule-based activation constraints.
Visual Studio extensions make their features available to Visual Studio through contributions. For more information, see Contributions.
Learn about the Remote UI model used in the VisualStudio.Extensibility.
Read an overview of the areas of the SDK that you might need for your extension development projects:
You can find a Visual Studio solution that contains all samples at Samples.sln.
| Sample | Description |
|---|---|
| Simple command handler | Demonstrates the basics of working with commands. See also the Create your first Visual Studio extension tutorial. |
| Insert guid extension | Shows how to insert text or code in the code editor. See also the Create your simple extension tutorial. |
| Command parenting | Shows how to author a command that can be parented to different aspects of the IDE. |
| Document selector | Shows how to create an editor extension that is only applicable to files matching a file path pattern. |
| Output window | Shows the most basic use of the Output Window API. |
| Tool window | Shows how to create a tool window and populate it with content. |
| User prompt | Shows how to display a prompt to the user. |
| Dialog | Shows how to display a dialog with custom UI to the user. |
| Word count margin | Shows how to create an editor margin extension that displays the word count in a document. |
| Markdown linter | Shows how multiple components can interact together inside an extension and how different areas of Visual Studio can be extended. |
| Project Query | Shows several different kinds of project system queries you can make. |
| Comment remover | Shows how to consume Visual Studio SDK services through .NET dependency injection and use VisualStudio.Extensibility APIs for commands, prompts, and progress report. |
| RegexMatchDebugVisualizer | Shows how to use Remote UI to create a Debugger Visualizer to visualize regular expression matches that will launch in a modal dialog window. |
| MemoryStreamDebugVisualizer | Shows how to create a Debugger Visualizer to visualize MemoryStream objects that launches in a non-modal tool window. |
Starting with our 17.9 release, we're ready to label the vast majority of our APIs as stable. That is, we don't plan to make any breaking changes to these APIs. Any breaking changes that might need to be made, for example in response to user feedback about usability, will be communicated formally and with plenty of notice on our breaking changes page.
There are a few of our APIs that don't yet meet this bar for stability, for one of several reasons:
For these APIs, we've explicitly labeled them using the [Experimental] attribute to help extension authors create their extensions with confidence in the the SDK.
For more information, including how to use experimental APIs, please see our Experimental APIs page.
We appreciate your feedback and bug reports in our Issues Tracker, and we work to address any issues found in the SDK.
Please visit our Known Issues page for information about any current known issues.
| Article | Description |
|---|---|
| Advanced Remote UI | In-depth information on the remote UI model |
| In-proc extensions | A quick walkthrough on different options to use VisualStudio.Extensibility SDK in-proc |
We're actively seeking feedback and engagement. The preview phase is a great time to get community input to help us identify issues and opportunities. You can provide feedback and report bugs in our issues tracker.
For future updates please bookmark our announcements page.
While VisualStudio.Extensibility is in the preview phase, it’s a great time for you, our community members, to share your input to help us identify issues and opportunities. Community participation is welcome and highly encouraged; we value the input and insights provided by extension developers like you!
You can provide feedback and report bugs in our issues tracker. Please note that we don’t have a dedicated support team – we, the engineering team working on VisualStudio.Extensibility will be the ones monitoring and triaging issues and other extension developers will be able to comment on these, too. Because we don’t have a dedicated support team, it may take some time before we get to issues and we won’t always be able to respond to everything.
Regarding our response flow on issues, here’s a general overview:
For future updates please bookmark our announcements page.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-party's policies.