Compartir a través de


Cómo: Empaquetar componentes para usar el instalador de contenido de Visual Studio

El instalador de contenido de Visual Studio proporciona una manera de implementar agregar- INS y fragmentos de código para extender Visual Studio.Para obtener más información sobre otras estrategias de implementación, vea Implementación de extensiones de Visual Studio.

Para hacer una extensión instalable mediante el Instalador de contenido de Visual Studio, empaquete la extensión en un archivo .vsi, que suele denominarse componente de la comunidad.El instalador de contenido de Visual Studio copia automáticamente los elementos en componentes de la comunidad en los directorios correctos del equipo de un programador, para que aparezcan en los cuadros de diálogo correctos en Visual Studio.

Si desea utilizar el instalador de contenido de Visual Studio para instalar los componentes de comunidad, deberá crear un archivo .vscontent para el componente.Tras crear el archivo .vscontent, comprima los archivos del componente y el archivo .vscontent en un archivo .zip y cambie el nombre de la extensión de .zip a .vsi.A continuación, podrá distribuir el archivo .vsi a otros programadores mediante el método de su elección: colocarlo en la web para que se pueda descargar, enviarlo como datos adjuntos de un correo electrónico o enviarlo a un recurso compartido de red.

Archivos .vscontent

Los archivos .vscontent utilizan XML basado en Referencia del esquema del instalador de contenido de Visual Studio para describir los componentes que haya creado y diseñado para compartir.En el mínimo, el archivo .vscontent identifica la clase de componentes y la versión de Visual Studio con que los menos se deben utilizar. Después de crear un archivo .vscontent, puede crear el archivo .vsi que Visual Studio de contenido el instalador usará para instalar los componentes en el equipo de un desarrollador.

Para crear un archivo .vscontent básico

  1. En el menú Archivo, señale Nuevo y, a continuación, haga clic en Archivo.

  2. En la categoría General, seleccione Archivo XML y, a continuación, haga clic en Abrir.

  3. Cree un archivo .vscontent válido mediante Referencia del esquema del instalador de contenido de Visual Studio.

    [!NOTA]

    Se puede encontrar XML de ejemplo para archivos .vscontent en las secciones Ejemplo de este tema.

  4. Guarde el archivo .vscontent en el mismo directorio que los otros archivos relacionados con el componente de la comunidad.

Archivos .VSI

Los archivos del instalador de contenido de Visual Studio (.vsi) se utilizan para intercambiar contenido de Visual Studio en la comunidad de programadores.Un archivo .vsi es un archivo .zip cuyo nombre ha cambiado y que contiene:

  • Un archivo .vscontent XML que describe el componente de la comunidad.

  • Los archivos para el componente.

El instalador de contenido de Visual Studio utiliza archivos .vsi para instalar contenido compartido en la ubicación correcta.Para obtener más información sobre cómo instalar archivos .vsi, consulte Cómo: Buscar e instalar componentes de la comunidad.

Algunas características del instalador de contenido de Visual Studio requieren la implementación de herramientas o servicios adicionales.

  • Para mostrar la información del editor del componente de comunidad en el instalador de contenido de Visual Studio, deberá firmar el archivo .vsi.Para obtener más información, vea Servicios criptográficos.

  • Para mostrar un Contrato de licencia para el usuario final (CLUF) en el instalador de contenido de Visual Studio, debe incrustar esta información en el archivo .zip.WinZip permite incluir la información incrustada a través de la característica Comment.Para obtener más información acerca de WinZip, vea http://www.winzip.com.Para obtener más información sobre la característica Comment, vea el archivo de Ayuda de WinZip.

Para crear un archivo .vsi

  1. Si aún no lo ha hecho, cree un archivo .vscontent válido para el componente.Para obtener más información, consulte la sección Archivos .VSCONTENT más arriba en este tema.

  2. En Explorador de archivos, seleccione los archivos necesarios para el componente, incluido el archivo .vscontent.

  3. Haga clic con el botón secundario en los archivos seleccionados, señale a Enviar a y haga clic en Carpeta comprimida (en zip).

    Los archivos seleccionados se comprimen en un único archivo .zip.

  4. Cambie la extensión del archivo .zip a .vsi.

Ejemplo

En el ejemplo siguiente se muestra un archivo .vscontent para un archivo .vsi que contiene un complemento.El elemento <ContentVersion> está establecido en 2.0, lo que significa que el complemento únicamente es compatible con las versiones 9.0 y 10.0 de Visual Studio.

Para este contenido, el archivo .vsi incluirá los siguientes archivos:

  • Un archivo .vscontent que contiene el XML que se muestra en este ejemplo.

  • El archivo de registro del complemento MyAddin.Addin.

  • El archivo .dll del complemento compilado MyAddin.dll.

Los archivos del complemento se instalan en el directorio siguiente:

n:\...\Mis documentos\Visual Studio <versión>\Addins\

Para obtener otros ejemplos, vea How to: Publish Project Templates y Cómo: Distribuir fragmentos de código.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005"> 
    <Content>
        <FileName>MyAddin.Addin</FileName>
        <FileName>MyAddin.dll</FileName>
        <DisplayName>Example Add-in</DisplayName>
        <Description>An add-in created for this example.</Description>
        <FileContentType>Addin</FileContentType>
        <ContentVersion>2.0</ContentVersion>
    </Content>
</VSContent>

Vea también

Tareas

Cómo: Distribuir fragmentos de código

Otros recursos

Interacting with Other Developers

How to: Publish Project Templates