Diseñador de manifiestos de VSIX

Modifica un archivo de manifiesto de paquete VSIX, que establece el comportamiento de instalación de una extensión de Visual Studio.

El Diseñador de manifiestos VSIX se asigna al esquema VSIX subyacente. Todos los elementos del esquema se pueden establecer mediante un control correspondiente en el diseñador. Para obtener más información sobre el esquema, vea Referencia del esquema de extensión VSIX 2.0.

Para abrir el Diseñador de manifiestos VSIX, busque un archivo source.extension.vsixmanifest en Explorador de soluciones y abra el archivo. Si el archivo no contiene XML válido, el diseñador de manifiestos no se abrirá.

Nota:

El archivo source.extension.vsixmanifest se genera en extension.vsixmanifest cuando se compila el paquete.

Lista de UIElement

El Diseñador de manifiestos VSIX contiene cuatro secciones que corresponden a estos elementos de nivel superior del esquema:

• Metadatos
• Destinos de instalación
• Activos
• Dependencias

El área de encabezado contiene los siguientes controles:

• Nombre del producto describe el nombre de la extensión.
• Id. de producto especifica la información de identificación única para este paquete.
• Author especifica el nombre del autor de la extensión.
• Versión especifica el número de versión de la extensión.

La pestaña Metadatos contiene los siguientes controles:

• Descripción proporciona una descripción de texto de la extensión que se va a mostrar en el Administrador de extensiones.
• Language especifica el idioma predeterminado para el paquete, que corresponde a los datos textuales del manifiesto. El Language atributo sigue la convención de código de configuración regional de Common Language Runtime (CLR) para los ensamblados de recursos, por ejemplo, en-us, en, fr-fr. De forma predeterminada, el valor es neutro, lo que significa que el paquete se ejecutará en cualquier versión de lenguaje de Visual Studio.
• License especifica el archivo de texto que contiene la licencia de usuario, si hay uno presente.
• Icon especifica el archivo de gráficos (.png, .bmp, .jpeg, .ico) que contiene el icono que se va a mostrar en el Administrador de extensiones, si hay un icono presente. La imagen de icono debe ser de 32 x 32 píxeles o se cambia de tamaño a esas dimensiones. Si no se especifica ningún icono, el Administrador de extensiones usa un icono predeterminado.
• La imagen de vista previa especifica el archivo de gráficos (.png, .bmp, .jpeg, .ico) que contiene la imagen de vista previa que se va a mostrar en el Administrador de extensiones, si existe una imagen de vista previa. La imagen de vista previa debe ser de 200 x 200 píxeles. Si no se especifica ninguna imagen de vista previa, el Administrador de extensiones usa una imagen predeterminada.
• Las etiquetas agregan etiquetas de texto que se usarán para las sugerencias de búsqueda.
• Notas de la versión especifica un archivo (.txt, .rtf) que contiene notas de la versión. También utiliza la dirección URL de un sitio web que muestra las notas de la versión.
• Guía de introducción especifica un archivo (.txt, .rtf) que contiene información sobre cómo usar la extensión o el contenido del paquete VSIX. Esta guía aparece cuando se completa la instalación de la extensión. También toma la dirección URL de un sitio web que muestra la guía.
• Más dirección URL de información especifica la dirección URL de un sitio web que contiene información adicional sobre el producto.

La pestaña Destinos de instalación contiene los siguientes controles:

• El tipo de instalación muestra la extensión de Visual Studio y el SDK de extensión como tipos de instalación de destino. Las opciones difieren, en función del tipo que elija.

  • Extensión de Visual Studio enumera los elementos InstallationTarget que describen cómo se puede instalar el paquete y en qué productos de Visual Studio se puede instalar esta extensión. Cada producto se identifica por separado por nombre y por una versión o intervalo de versiones. Los productos se pueden agregar a la lista, modificar y eliminar. El nombre y la versión de un producto corresponden a los atributos Id y Version del elemento InstallationTarget asociado.

    • El intervalo de versiones es [12.0, 14.0] y usa la notación siguiente:
      • [ - versión mínima inclusiva
      • ] - versión máxima inclusiva
      • ( - versión mínima exclusiva
      • ) - versión máxima exclusiva
      • Versión única: solo la versión especificada

  • El SDK de extensión especifica una instalación global que no tiene como ámbito un producto y una versión específicos. El identificador de plataforma de destino es la plataforma, como "Windows", que tiene como destino. Versión de la plataforma de destino es la versión, como la 8.0, de la plataforma de destino. El nombre del SDK y la versión del SDK son el nombre y el número de versión del SDK, respectivamente.

• Este VSIX está instalado para todos los usuarios (requiere elevación al instalar). Si activa esta casilla, la extensión se instala para todos los usuarios; de lo contrario, solo se instala para el usuario actual.

• Windows Installer instala este VSIX. Si activa esta casilla, la extensión se instala mediante el archivo Windows Installer (archivo.msi ); de lo contrario, se instala como un paquete VSIX típico (archivo .vsix ).

La pestaña Activos contiene los siguientes controles:

• Lista de recursos muestra los elementos Asset que describen la extensión o los elementos de contenido que muestra este paquete. Cada extensión o elemento de contenido se muestra por separado por origen, tipo y ruta de acceso. Las extensiones y los elementos de contenido se pueden agregar a la lista, modificar y eliminar. El tipo y la ruta de acceso de un elemento de extensión o contenido corresponden a los Type atributos y Path del elemento asociado Asset . Se conocen los siguientes tipos:

  • Microsoft.VisualStudio.Package
  • Microsoft.VisualStudio.MefComponent
  • Microsoft.VisualStudio.ToolboxControl
  • Microsoft.VisualStudio.Samples
  • Microsoft.VisualStudio.ProjectTemplate
  • Microsoft.VisualStudio.ItemTemplate
  • Microsoft.VisualStudio.Assembly
  • Microsoft.ExtensionSDK

  Para agregar o editar un recurso, debe especificar el tipo de recurso, si el recurso es un proyecto de la solución actual o un archivo en el sistema de archivos y el nombre del proyecto. También puede especificar el nombre de la carpeta en la que se va a insertar.

  También puede crear sus propios tipos y asignarles nombres únicos.

La pestaña Dependencias contiene los siguientes controles:

• Name, Source y Version Range enumeran los elementos Dependency de este paquete, que son otros paquetes de los que depende este paquete. Si se especifica un paquete de dependencias, debe instalarse antes de instalar este paquete; De lo contrario, este paquete debe instalarlo.

  Los paquetes de dependencia se especifican mediante identificador, nombre, intervalo de versiones, origen y cómo se va a resolver la dependencia. Cada paquete de dependencia se muestra por separado por nombre, versión y origen. Los paquetes de dependencia se pueden agregar a la lista, modificar y eliminar.

  El identificador debe coincidir con el ID atributo de los metadatos del paquete de dependencias. El origen puede ser un proyecto en la solución actual, una extensión instalada actualmente o un archivo. La opción ¿Cómo se resuelve la dependencia? puede ser la ruta de acceso relativa de un paquete anidado o la dirección URL de la ubicación de descarga de la dependencia. El identificador, la versión y la resolución del paquete de dependencia corresponden a los Idatributos , Versiony Location del elemento asociado Dependency .

Consulte también

• Referencia del esquema de extensión VSIX 2.0
• Anatomía de un paquete VSIX