Common Visual Studio Extension Woes

As a developer of a rather popular Visual Studio extension, I have often had my fair share of issues when dealing with some of the quirks involved when building an extension. Ninety percent of the time, these issues generally center on the debugging process. This post focuses on a few of these and how to go about resolving them.

My Extension Can't Be Found.

On numerous occasions, when working with Glyphfriend and adding some new features or refactoring things, I received the following error message when attempting to build the application.

Extension '[Insert-Guid-Here]' could not be found. Please make sure the extension has been installed.

Although it's right there, yet it doesn't seem to be found. There are a few ways to try and troubleshoot this, which vary in rates of success.

Option 1 Reset Command Line Arguments


Visual Studio handles debugging extensions by spinning up an "experimental" instance of the IDE, and basically installing your extension to said instance so that you can play with it. If you have the previously mentioned "Extension cannot be found." error, then you may need to try resetting the arguments.

Just follow these steps,

  • Right-click on your "Project"in the Solution Explorer.
  • Choose "Properties".
  • Select the "Debug" tab on the left.
  • Clear out the Command Line Arguments.
  • Build your Solution manually or via "CTRL+Shift+B".
  • Set the Command Line Arguments to "/rootsuffix" Exp.
  • Rebuild the Project.

Option 2 Tinkering with the Experimental Instance


If the previous approach didn't work, then you might have to do a bit of tinkering with the experimental instance of Visual Studio as its settings may have gotten a bit out of whack.

You can try some of the following approaches to tackle that issue.

  • Manually open and close an experimental instance of Visual Studio to reset its state. You can find this by searching your local machine for "Experimental".
  • Update the package version of your extension in the manifest. Updating the version number can assist with breaking the experimental instance out of said funk.
  • Run the "Reset the Visual Studio 2015 Experimental Instance" tool.

Option 3 Burninate the Folder

If those don't work, one final approach that I found success with is to explicitly clear out the Visual Studio Experimental Settings folder for your current user account. This folder should contain all of the settings for your experimental instance, which will be recreated when the instance is launched.

The folder can be found at the following location,

C:\Users\{user}\AppData\Local\Microsoft\VisualStudio\14.0Exp 

This fix was the most consistent in my experience, but your mileage may vary.

Debugger Issues and Symbols Not Loading...


Another point of frustration that I experienced fairly frequently was the Visual Studio debugger not properly attaching to the experimental instance or loading the symbols for the project. Either of these won't allow the debugger to attach, thus making actual debugging rather difficult.

The first thing to ensure is that you are running in a Debug configuration or that you at least have a DEBUG constant defined checked and Optimize Code unchecked within your Build Properties.

If you find that you still can't debug your application after this, consider reverting to Option 3 of the previous section and delete the "Experimental Instance" folder once again at the following location.

C:\Users\{user}\AppData\Local\Microsoft\VisualStudio\14.0Exp 

You'll need to do this each time you launch your extension, in order to ensure that any previous settings are changed and symbols are updated properly (or if you are handy, you could write a script to try to do this for you).

Next Recommended Readings