How VSIX extensions are discovered and loaded in VS 2010

How VSIX extensions are discovered and loaded in VS 2010

  • Comments 5

VSIX is the new technology used for deploying extensions in Visual Studio 2010. The primary goal of this new technology is to encourage extension creation and consumption by easing the management (“management” meaning Browsing/Installing/Uninstalling/Enabling/Disabling) of Visual Studio extensions. To take full advantage of the VSIX installer for deploying your extensions, it helps to know a little bit more about how Visual Studio decides which extensions to load.

Dmitry Goncharenko provided a good high-level overview of how these VSIX extensions are discovered and loaded in his post Bootstrapping of VS packages and VSIX extensions in VS2010. Let’s now take a more in-depth look at how this process works.

An extension consists of:

  1. an extension.vsixmanifest file, which contains metadata about the extension
  2. any additional files that represent the extension content. This could include MEF assemblies, VS Package assemblies, VS Template ZIP files, PkgDef files, etc..

The simplest vsix extension would contain only the extension.vsixmanifest file, though that would admittedly be a very uninteresting extension.

Extension Discovery

In accordance with the goal of simplicity, a VSIX extension install consists of only copying the extension files into one of a few well-known locations. These locations are defined in the “Master PkgDef” file, located at <VsInstallRootFolder>\Common7\IDE\devenv.pkgdef and pictured below.

 MasterPkgDef

The relevant values are described below.

Variable

Description

ApplicationExtensionsFolder

The root folder under which machine wide VSIXs are deployed.

(This is set as <VsInstallRootFolder>\Common7\IDE\Extensions)

UserExtensionsRootFolder

The root folder under which user specific VSIXs are deployed.

(This is set as %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions)

PkgDefSearchPath

A list of additional folders where extensions will be searched for. The name for this property was originally defined by the PkgDef subsystem. This list is shared with vsix extensions so that any extensions that contain .pkgdef files will be properly loaded. Note that this includes ApplicationExtensionsFolder.

 

Upon initialization, the Extension Manager service, SVsExtensionManager, will search the above locations for extension.vsixmanifest files. The PkgDefSearchPath folders are searched first, followed by the UserExtensionsRootFolder.

Extension Loading Rules

At this point, each extension must pass a few trials before being considered installed by the Extension Manager. Before diving into the details, here’s a quick summary of these:

  • The extension.vsixmanifest XML conforms to the XSD.
  • The extension has not been marked for deletion.
  • The extension’s identifier cannot conflict with any other previously discovered extensions.

First, if the extension.vsixmanifest XML does not conform to the VSIX manifest XSD schema, it is ignored. If the manifest XML passes schema validation, then it will be deserialized into an object model in memory. Second, the Extension Manager needs to verify that the extension is not marked for deletion. Before going any further, it would be helpful to discuss what exactly this means.

If you’ve uninstalled an extension through the Extension Manager dialog in Visual Studio, you may have noticed that the uninstall occurs extremely fast. This is because the extension is only marked for deletion at that time. On a subsequent initialization of the Extension Manager (the next time Visual Studio or the VSIX Installer are launched), all of the pending deletions are cleaned up on a background thread *after* all installed extensions have been discovered. Therefore, any extension that is marked for deletion should be discarded and no longer considered installed.

Third, if the extension contains the same ID as another extension that has already been discovered, it will be discarded. This is where the search order becomes important. The UserExtensionsRootFolder is searched last in order to give precedence to machine wide extensions when an ID conflict is encountered.

Once an extension has passed these checks, it is considered “installed” by the Extension Manager service. Figuring out whether an extension is not installed because of one of the above reasons is easy since the Extension Manager logs this information to the Visual Studio activity log. The activity log can be enabled by running the Visual Studio process (<VsInstallRootFolder>\Common7\IDE\devenv.exe) with the ‘/log’ switch, as follows:

devenv.exe /log <path_to_log_file>

The Mechanics of Enabled/Disabled Extensions

So your extension is successfully “installed”, but how does the Extension Manager determine whether it’s “Enabled”? The answer depends upon where your extension is installed. Extensions installed to any directory in the PkgDefSearchPath list of folders are always enabled. Extensions installed to the UserExtensionsRootFolder path must be individually enabled through a list maintained in the HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\ExtensionManager\EnabledExtensions registry key. The Extension Manager Install API, used by the extension install dialog as well as the VSIX installer, will write the entry in the EnabledExtensions key for any newly installed extension so that extensions installed in this manner are automatically enabled. You’ll notice that if you manually install an extension by copying the extension files to a subfolder in the UserExtensionsRootFolder path, it will be disabled at first because the corresponding entry in EnabledExtensions has not been added. Enabling the extension can also be accomplished through the Extension Manager dialog.

Enable

Lastly, extensions in the UserExtensionsRootFolder path will all be disabled when running Visual Studio as an administrator, if the following option is not checked under Tools->Options->Environment->Extension Manager

Options

This option was likely the most common culprit for why users (particularly administrators running WindowsXP) found that their extensions were not enabled in Beta2 and prior builds of Visual Studio, since the default value for the option was ‘False’. Due to the frequency with which customers ran into this problem, we’ve changed the default value for this option to ‘True’. Note that the Extension Manager dialog provides a warning if you’re running Visual Studio elevated, but do not have this option checked.

AdminMessage

 

When in doubt about why an extension does not seem to be loaded or enabled, you should consult the Visual Studio activity log, which will output various diagnostics during the loading process. You may also want to check out the following posts related to extension loading:

MarianoB

Mariano Blanco: Developer, Visual Studio Platform

Mariano started in the Visual Studio Ecosystem team at Microsoft in 2007. He now works on the Visual Studio Platform Extensibility team and is responsible for the Extension Manager API and the VSIX installer tool shipping in Visual Studio 2010.

Leave a Comment
  • Please add 2 and 4 and type the answer here:
  • Post
  • What developer of already existing VS Addin or VS package would like to know are:

    -A cross matrix of features between VS Addin - VS package - (new) VS Extension

    -Until when VS Addin - VS package will be supported?

    -Is API proposed through VS Extension API is brand new (and full .NET with a clean object model) or is still the COM based one? I ask because for the last 4 months we've been dealing with this kind of trouble (see the URL below), and despite the excellent level of support we've got, I attest that it has been pretty difficult.

    http://msmvps.com/blogs/carlosq/archive/2009/10/23/vs-2010-and-the-commandbarpopup-interface.aspx

  • @Patrick: A similar question was recently answered in the VS Extensibility MSDN Forum:

    http://social.msdn.microsoft.com/Forums/en-US/vsxprerelease/thread/543c5c5d-a1c4-40f6-aadb-b5cd72e49cb3

    Think of VSIX as a way of distributing and managing extensions. VSIX is not about a new programming model for extensions.

  • Is there a way to setup a custom folder (preferably network folder) as a folder to host custom templates? This would be a folder that is available for all members in the organization. We would templates that are available from a common location for people within the organization only. I would really appreciate any help.

  • Hello,

    I was wondering if anyone could help with this.

    I am running Visual Studio 2010 on Windows 7 Professional 64-bit.

    I recently uninstalled old version of PostSharp (2.1.5.1) using Control Panel add/remove programs.

    I  also selected the PostSharp entry listed in VS2010 Extension Manager and picked uninstall.

    I then installed the new version of PostSharp (2.1.7.12) using the setup program.

    Now when I bring up VS2010, I no longer have the PostSharp entry in the Extension Manager list (although PostSharp seems to be working). Where did the entry go and how do I get it back?

    Both my machine and Visual Studio have been restared but the PostSharp entry in VS2010 Extension Manager does not show up.

    After reading your above post I ran vs2010 with the /log switch and I did find an entry for PostSharp that said "Extension will not be loaded because it is marked for deletion."

    The extension folder and files seem to be there at "C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\SharpCrafters\PostSharp\2.1\"

    How do I fix this?

    Thanks in advance for any assistance ....

  • Just a quick remark concerning this mechanism and VS 2012. VS 2010 used to query extensions paths such as %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions for *.lnk files (windows link/shortcut files), so it was possible to put only a extension.vsixmanifest.lnk file there and point to the real extension.vsixmanifest somewhere else. Apparently VS 2012 does not query any more for .lnk files. Too bad for us using this...

Page 1 of 1 (5 items)