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 macros, complementos y fragmentos de código para extender Visual Studio. Para obtener más información sobre otras estrategias de implementación, vea Visual Studio Extension Deployment.
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. El archivo .vscontent identificará, al menos, la clase de componentes y la versión de Visual Studio que debe usarse con los componentes. Después de crear un archivo .vscontent, puede crear el archivo .vsi que el Instalador de contenido de Visual Studio usará para instalar los componentes en el equipo de un desarrollador.
Para crear un archivo .vscontent básico
En el menú Archivo, señale Nuevo y, a continuación, haga clic en Archivo.
En la categoría General, seleccione Archivo XML y, a continuación, haga clic en Abrir.
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.
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, vea 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
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.
En Explorador de Windows, seleccione los archivos necesarios para el componente, incluyendo el archivo .vscontent.
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.
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 Cómo: Publicar plantillas de proyectos y Cómo: Publicar 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>
El ejemplo siguiente muestra un archivo .vscontent para un archivo .vsi que contiene un proyecto de macros que se puede utilizar con las versiones 8.0, 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 macros MyMacroProject.vsmacros.
El archivo de macros se instala en el directorio siguiente:
n:\... \Mis documentos\Visual Studio <versión>\Projects\VSMacros80\
<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
<Content>
<FileName>MyMacroProject.vsmacros</FileName>
<DisplayName>My Macro Project</DisplayName>
<Description> A macro project created for this example.</Description>
<FileContentType>Macro Project</FileContentType>
<ContentVersion>1.0</ContentVersion>
</Content>
</VSContent>
Vea también
Tareas
Cómo: Publicar plantillas de proyectos
Cómo: Publicar fragmentos de código