Anatomía de una extensión de Visual Studio

Un paquete VSIX es un archivo .vsix que contiene una o varias extensiones de Visual Studio y los metadatos que Visual Studio usa para clasificar e instalar las extensiones. El formato de paquete VSIX sigue el estándar Open Packaging Conventions (OPC) que significa que puede abrirse mediante cualquier herramienta que pueda abrir archivos ZIP.

Un proyecto de extensión es un proyecto de C# con algunos extras que lo hacen único. En el vídeo siguiente se explora un proyecto de extensión para comprender mejor cómo funcionan los proyectos de extensión:

Estructura de archivos

Al crear nuevas extensiones mediante la plantilla Proyecto VSIX con comando (Comunidad), la estructura de archivos tiene el siguiente aspecto:

El archivo .vsixmanifest es el archivo principal. Es un archivo XML que contiene información sobre la extensión usada por Visual Studio. Todos los componentes de la extensión se registran en el archivo .vsixmanifest. Es el único archivo obligatorio en un proyecto VSIX.

El archivo VSCommandTable.vsct es donde se declaran los comandos. Es un archivo XML y contiene las definiciones de comandos de botón, menús, enlaces de método abreviado de teclado y mucho más. El archivo compila su contenido en un blob de la salida .dll que Visual Studio usa para construir toda su estructura de menús de la tabla de comandos. Este archivo solo declara los componentes de la tabla de comandos; no controla las invocaciones de comandos.

El archivo *Package.cs es la clase Package, que es el punto de entrada para la mayoría de las extensiones. En este caso, a menudo encontrará controladores de comandos, ventanas de herramientas, páginas de opciones, servicios y otros componentes registrados.

Compilación

El proyecto se compila en un archivo .vsix ubicado en la carpeta /bin/debug o /bin/release, que depende de la configuración de compilación de la solución actual. La carga de trabajo Desarrollo de extensiones de Visual Studio proporciona destinos y tareas dedicados de MSBuild para controlar el tipo de proyecto VSIX.

Cuando se compila el proyecto VSIX, se implementa automáticamente en la instancia experimental. Esto se puede controlar en la configuración del proyecto VSIX:

Instancia experimental

Para proteger el entorno de desarrollo de Visual Studio de aplicaciones no probadas que podrían cambiarlo, el VSSDK proporciona un espacio experimental que puede usar para experimentar. Puede desarrollar nuevas aplicaciones con Visual Studio como de costumbre, pero mediante esta instancia experimental.

Cada aplicación que tiene un paquete VSIX inicia la instancia experimental de Visual Studio en modo de depuración.

Si desea iniciar la instancia experimental de Visual Studio fuera de una solución específica, ejecute el siguiente comando en la ventana de comandos:

devenv.exe /RootSuffix Exp

Para obtener más conceptos de extensibilidad, consulte los recursos útiles, que le ayudarán a seguir este kit de herramientas.