Trabajar con proyectos VSIX

Los proyectos VSIX son la manera estándar de empaquetar extensiones de Visual Studio para la distribución. Tanto si va a crear una extensión de VisualStudio.Extensibility como una extensión basada en VSSDK, la salida es un archivo .vsix que los usuarios instalan a través del Administrador de extensiones o de Visual Studio Marketplace.

Important

En este artículo se tratan las plantillas de proyecto VSIX anteriores y el mantenimiento de proyectos de empaquetado existentes. Para los proyectos nuevos de Visual Studio 18.11 o posterior, use la plantilla de proyecto VSIX moderna, que se encarga del empaquetado de VSIX. Estos son flujos de trabajo de proyecto alternativos, no pasos consecutivos. Elija en función del entorno de desarrollo y el proyecto existente, no solo de la versión de Visual Studio a la que se dirige la extensión.

Creación de un proyecto VSIX

Las plantillas de proyecto VSIX están disponibles en el cuadro de diálogo Crear un nuevo proyecto . Busque "VSIX" para encontrarlos:

  • Extensión de extensibilidad de VisualStudio.Extensibility : para extensiones fuera de proceso mediante el nuevo modelo de extensibilidad.
  • Proyecto VSIX: para las extensiones basadas en VSSDK o para ajustar varias salidas de extensión.
  • Extensión de extensibilidad de VisualStudio.Extensibility con COMPATIBILIDAD de VSSDK : para extensiones híbridas que usan ambos modelos.
  • Proyecto VSIX vacío — un contenedor VSIX en blanco para empaquetar componentes existentes.

Tip

Para las nuevas extensiones, se recomienda Visual Studio 18.11 o posterior y la plantilla Modern VSIX Project. Seleccione VisualStudio.Extensibility (fuera de proceso) para las características admitidas por ese modelo; seleccione una opción VSSDK o híbrida solo cuando necesite las API en proceso. En las versiones anteriores de Visual Studio, use la plantilla Extensión de VisualStudio.Extensibility o la plantilla compatible con VSSDK cuando necesite las API de VSSDK.

Extensiones de paquete en un proyecto VSIX

Note

El source.extension.vsixmanifest archivo y los pasos siguientes solo se aplican a VSSDK y extensiones híbridas. Las extensiones de extensibilidad (fuera de proceso) de VisualStudio.Extensibility generan sus metadatos desde ExtensionConfiguration.Metadata en el código; no se necesita ningún archivo de manifiesto.

Puede empaquetar una extensión o componente existente encapsulandola en un proyecto VSIX:

  1. Cree un proyecto VSIX con cualquiera de las plantillas anteriores.
  2. El source.extension.vsixmanifest archivo se abre en el Diseñador de manifiestos.
  3. En la pestaña Recursos, seleccione Nuevo para agregar componentes.
  4. En la lista Tipo , elija el tipo de recurso que se va a agregar (por ejemplo, Microsoft.VisualStudio.MefComponent, Microsoft.VisualStudio.VsPackage).
  5. Establezca Origen en Un proyecto de la solución actual y seleccione el proyecto.

El formato VSIX admite el empaquetado de VSPackages, componentes MEF, ensamblados, plantillas de proyecto, plantillas de elemento, controles de cuadro de herramientas y tipos de extensión personalizados.

Adición de dependencias a un paquete VSIX

Puede configurar VSIX para requerir otras extensiones como dependencias. Cuando un usuario instala tu extensión, el instalador comprueba que están presentes todas las dependencias necesarias.

Para agregar una dependencia:

  1. Abra source.extension.vsixmanifest en la vista Diseño .
  2. Vaya a la pestaña Dependencias y seleccione Nuevo.
  3. Elija Extensión instalada para seleccionar una dependencia de extensiones ya instaladas o Archivo en el sistema de archivos para hacer referencia directamente a otro VSIX.

Se requiere una versión específica de Visual Studio

Para definir un número de compilación mínimo de Visual Studio, establezca el intervalo de versiones InstallationTarget:

<Installation>
  <InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,)" />
</Installation>

Note

A partir de Visual Studio 2026, solo se evalúa el límite inferior del intervalo de versiones. El límite superior se omite con fines de compatibilidad. Consulte Compatibilidad de extensiones.

Creación de un paquete de extensiones

Un paquete de extensiones es un conjunto de extensiones que se pueden instalar juntas. Los paquetes de extensiones permiten compartir sus extensiones favoritas con compañeros o agrupar un conjunto de extensiones para un escenario.

Para crear un paquete de extensiones:

  1. Cree un nuevo proyecto de VSIX.
  2. Haga clic con el botón derecho en el proyecto en el Explorador de soluciones y seleccione Agregar>nuevo elemento.
  3. Seleccione la plantilla Pack de extensiones. Esto agrega un archivo .vsext.
  4. Edite el .vsext archivo para enumerar las extensiones que se van a incluir:
{
  "id": "MyExtensionPack",
  "name": "My Extension Pack",
  "description": "A curated set of extensions for my team",
  "version": "1.0.0.0",
  "extensions": [
    {
      "vsixId": "41858b2d-ff0b-4a43-80b0-f1b2d6084935",
      "name": "AlignAssignments"
    },
    {
      "vsixId": "42374550-426a-400e-96f9-237682e8dea6",
      "name": "CopyAsHtml"
    }
  ]
}
  1. Busque el vsixId en Visual Studio Marketplace ↗: abra la página de la extensión y seleccione Copiar id..
  2. Compile y publique el proyecto. Consulte Publicación en Marketplace.

Note

Los paquetes de extensiones solo pueden instalar extensiones disponibles en Visual Studio Marketplace ↗ o en una galería privada.

Visión general de la arquitectura de extensiones

Comprender cómo carga Visual Studio su extensión le ayuda a tomar mejores decisiones de empaquetado e implementación.

VisualStudio.Extensibility (fuera de proceso)

Las extensiones fuera de proceso se ejecutan en un proceso independiente de Visual Studio, comunicándose a través de un canal de JSON-RPC:

┌─────────────────────┐       JSON-RPC        ┌──────────────────────┐
│   Visual Studio     │◄─────────────────────►│  Extension Process   │
│   (DevEnv.exe)      │                        │  (.NET 8+)           │
│                     │                        │                      │
│  ┌───────────────┐  │                        │  ┌────────────────┐  │
│  │ Extension Host│  │                        │  │ Your Extension │  │
│  │ (manages      │  │                        │  │ Code           │  │
│  │  lifecycle)   │  │                        │  └────────────────┘  │
│  └───────────────┘  │                        └──────────────────────┘
└─────────────────────┘

Características principales:

  • La extensión se ejecuta en .NET moderno (8+)
  • Es menos probable que los bloqueos del proceso de la extensión paren Visual Studio
  • Instale o desinstale sin reiniciar VS
  • Instalación por usuario (sin requisito de administrador)

VSSDK/híbrida (en proceso)

Las extensiones en proceso se cargan directamente en el proceso de Visual Studio:

┌──────────────────────────────────────────┐
│   Visual Studio (DevEnv.exe)             │
│                                          │
│  ┌────────────────┐  ┌────────────────┐  │
│  │ VS Core        │  │ Your Extension │  │
│  │ Services       │◄─┤ (.NET Framework│  │
│  │                │  │  or hybrid)    │  │
│  └────────────────┘  └────────────────┘  │
└──────────────────────────────────────────┘

Características principales:

  • Acceso total a todas las API y servicios de VS
  • Limitado a .NET Framework (a menos que sea híbrido)
  • Los errores de extensión pueden afectar a la estabilidad de VS
  • Requiere el reinicio de VS al instalar o actualizar

Qué hay en un paquete .vsix

Un archivo .vsix es un archivo ZIP con una estructura estándar. El contenido difiere según el modelo de extensión:

Componente VisualStudio.Extensibility VSSDK
Metadatos de extensión ExtensionConfiguration en el código source.extension.vsixmanifest
Archivos binarios de la extensión Los archivos DLL de .NET 8+ Sus DLL de .NET Framework
Archivos de localización .vsextension/string-resources.json .vsixlangpack archivos
Tipos de contenido [Content_Types].xml [Content_Types].xml
Manifiesto del paquete Generado automáticamente extension.vsixmanifest source.extension.vsixmanifest escrito a mano