-
Notifications
You must be signed in to change notification settings - Fork 51
Obtaining the Concord API headers, libraries, etc
Gregg Miskelly edited this page Jan 6, 2022
·
4 revisions
To build Concord extensions, the following things are needed -
- Extensions implemented in managed code: reference assemblies
- Extensions implemented in native code: API header files (VSDebugEng.h etc) and API import library (vsdebugeng.lib)
- All extensions: vsdconfigtool.exe along with msbuild targets to run the tool. In Visual Studio 2019 (Dev16) and newer, this is Microsoft.VSSDK.Debugger.VSDConfigTool.targets, and previous releases used Microsoft.VSDebugger.targets and Microsoft.VSDebugger.Native.targets.
These can be obtained from the following packages from nuget.org:
Name | Description |
---|---|
Microsoft.VisualStudio.Debugger.Engine | Managed reference assembly for the Concord API. |
Microsoft.VSSDK.Debugger.VSDebugEng | Native headers and import libraries for the Concord API. |
Microsoft.VSSDK.Debugger.VSDConfigTool | Contains vsdconfigtool.exe -- the build tool for compiling .vsdconfigxml files along with msbuild target files for running it. |
Microsoft.VisualStudio.Debugger.Metadata | Managed reference assembly needed for building 'Result Provider' managed expression evaluator components. |
Note that before Visual Studio 2022, the headers, libs, reference assemblies and build tools could also be installed as part of the 'Visual Studio Extensibility' workload in the Visual Studio installer. For Visual Studio 2022 the reference assemblies were removed as part of a broader effort to shift to nuget packages. In the future, the remaining files may also be removed, so unless you have an existing extension that you don't want to migrate, it is recommended to consume all of these from nuget packages.
Concord Documentation:
- Overview
- Visual Studio 2022 support
- Concord Architecture
- Getting troubleshooting logs
- Tips for debugging extensions
- Component Discovery and Configuration
- Component Levels
- Navigating the Concord API
- Obtaining the Concord API headers, libraries, etc
- Concord Threading Model
- Data Container API
- Creating and Closing Objects
- Expression Evaluators (EEs)
- .NET language EEs
- Native language EEs
- Installing Extensions
- Cross Platform and VS Code scenarios:
- Implementing components in native code:
- Worker Process Remoting
Samples: