Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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:
- Cree un proyecto VSIX con cualquiera de las plantillas anteriores.
- El
source.extension.vsixmanifestarchivo se abre en el Diseñador de manifiestos. - En la pestaña Recursos, seleccione Nuevo para agregar componentes.
- En la lista Tipo , elija el tipo de recurso que se va a agregar (por ejemplo,
Microsoft.VisualStudio.MefComponent,Microsoft.VisualStudio.VsPackage). - 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:
- Abra
source.extension.vsixmanifesten la vista Diseño . - Vaya a la pestaña Dependencias y seleccione Nuevo.
- 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:
- Cree un nuevo proyecto de VSIX.
- Haga clic con el botón derecho en el proyecto en el Explorador de soluciones y seleccione Agregar>nuevo elemento.
- Seleccione la plantilla Pack de extensiones. Esto agrega un archivo
.vsext. - Edite el
.vsextarchivo 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"
}
]
}
- Busque el
vsixIden Visual Studio Marketplace ↗: abra la página de la extensión y seleccione Copiar id.. - 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 |