Implementar una extensión de modelado de capas

Los usuarios de Visual Studio 2010 Premium y Visual Studio 2010 Ultimate pueden instalar extensiones de modelado por capas creadas mediante Visual Studio 2010 Ultimate y Visual Studio 2010 Visualization and Modeling Feature Pack o el Feature Pack 2 de Visual Studio 2010. Debe configurar la extensión para que el instalador busque los requisitos correctos. Para obtener más información, vea Paquetes de características de Visual Studio.

Establecer las opciones de implementación

Para permitir instalar la extensión en otros equipos, debe establecer las siguientes opciones de source.vsix.manifest en el proyecto VSIX.

Nota

Si ha creado el proyecto con una plantilla de proyecto de extensión por capas, estas opciones ya deben estar establecidas. Si ha creado un proyecto VSIX independiente, tendrá que realizar las siguientes modificaciones.

• Ediciones de Visual Studio admitidas debe estar establecido en uno o en los dos valores siguientes: Visual Studio 2010 Premium y Visual Studio 2010 Ultimate

• VSIX References (Referencias de VSIX) debe incluir Visual Studio 2010 Visualization and Modeling Feature Pack Runtime, que está incluido en el Feature Pack de visualización y modelado y en el Feature Pack 2.

La lista de referencias VSIX hace que el instalador compruebe que las extensiones especificadas estén instaladas en el equipo de destino. Hay dos maneras alternativas de incluir la referencia:

• Como vínculo de referencia. Cuando un usuario intente instalar la extensión, el instalador comprobará si está instalado el motor en tiempo de ejecución. Si no está instalado, se muestra al usuario un mensaje que incluye un hipervínculo a la página de instalación del motor en tiempo de ejecución.

• Como carga. Cuando un usuario instale la extensión, el instalador empezará por instalar el motor en tiempo de ejecución, a menos que ya esté instalado.

Para establecer un vínculo de referencia en el motor en tiempo de ejecución

1. En source.vsix.manifest, haga clic en Add Reference (Agregar referencia).

2. Haga clic en Select Installed Extension (Seleccionar la extensión instalada).

3. Seleccione el motor en tiempo de ejecución para este Feature Pack.

Para incluir el motor en tiempo de ejecución como carga en el instalador de extensiones

1. En source.vsix.manifest, haga clic en Add Reference (Agregar referencia).

2. Haga clic en Add Payload to VSIX (Agregar carga a VSIX).

3. Haga clic en el botón de puntos suspensivos [...]. En el cuadro de diálogo, vaya a la siguiente ubicación:

   • Si tiene instalado el Feature Pack de visualización y modelado de Visual Studio 2010:

     %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization y Modeling Feature Pack Runtime\1.0\Visualization y Modeling Feature Pack Runtime.vsix

     Nota

     %LocalAppData% está normalmente en DriveName:\Users\nombreDeUsuario\AppData\Local\. En Windows XP o Windows 2003, use %AppData% en lugar de %LocalAppData%.

     O bien

   • Si tiene instalado el Feature Pack 2 de Visual Studio 2010:

     …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization y Modeling Feature Pack Runtime\1.0\Visualization y Modeling Feature Pack Runtime.vsix

Instalar la extensión

La extensión está compilada en un archivo VSIX que se puede instalar en otros equipos. También se puede instalar en el equipo de desarrollo, para que la extensión esté disponible en la instancia principal de Visual Studio.

Para instalar la extensión

1. En el proyecto que contiene source.vsix.manifest, abra bin\* en el Explorador de Windows.

2. Copie el archivo *.vsix en el equipo de destino en el que desea instalar la extensión.

3. En el equipo de destino, haga doble clic en el * archivo .vsix en el Explorador de Windows.

   Se abre el instalador VSIX.

Para desinstalar la extensión

1. En Visual Studio, en el menú Herramientas, haga clic en Administrador de extensiones.

2. Haga clic en el nombre de la extensión y, a continuación, haga clic Desinstalar.

Instalar una extensión en un servidor de Team Foundation Build Server

Los servidores de Team Foundation Build Server no tienen normalmente Visual Studio instalado y, por lo tanto, VSIX no se puede instalar haciendo doble clic en él. La instalación de Team Foundation Build incluye algunos componentes que permiten ejecutar una extensión VSIX, pero esta se debe instalar manualmente.

Para instalar la extensión por capas en un servidor de Team Foundation Build Server

1. Copie los siguientes archivos VSIX del equipo de desarrollo en el equipo de Team Foundation Build:

   • Si tiene instalado el Feature Pack de visualización y modelado de Visual Studio 2010:

     Copie el motor en tiempo de ejecución del Feature Pack de la siguiente ubicación: %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization y Modeling Feature Pack Runtime\1.0\Visualization y Modeling Feature Pack Runtime.vsix

     Nota

     %LocalAppData% está normalmente en DriveName:\Users\nombreDeUsuario\AppData\Local\. En Windows XP o Windows 2003, use %AppData% en lugar de %LocalAppData%.

     O bien,

     Si tiene instalado el Feature Pack 2 de Visual Studio 2010:

     Copie el motor en tiempo de ejecución del Feature Pack de la siguiente ubicación: …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization y Modeling Feature Pack Runtime\1.0\Visualization y Modeling Feature Pack Runtime.vsix

   • El VSIX compilado de la siguiente ubicación:

     NombreProyectoVSIX\bin\*\*.vsix

2. En el equipo de Team Foundation Build, coloque los archivos VSIX en una de las siguientes ubicaciones:

   • Para instalarlo para todos los usuarios y servicios:

     %ProgramFiles%\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft

   • Para instalarlo solo para el servicio de red que ejecuta Team Foundation Build:

     %WinDir%\ServiceProfiles\NetworkService\AppData\Local\Microsoft\VisualStudio\10.0\Extensions\Microsoft

   • Si ha configurado Team Foundation Build para ejecutarlo en modo interactivo como un usuario concreto, puede instalarlo solo para ese usuario:

     %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft

     Nota

     %LocalAppData% está normalmente en DriveName:\Users\nombreDeUsuario\AppData\Local\. En Windows XP o Windows 2003, use %AppData% en lugar de %LocalAppData%.

3. Expanda cada archivo VSIX en una carpeta en la misma ubicación:

   1. Cambie la extensión de nombre de archivo de .vsix a .zip.

   2. Extraiga el contenido del archivo .zip a una carpeta.

   3. Elimine el archivo .zip

4. Reinicie Team Foundation Build.

Historial de cambios

Fecha	Historial	Motivo
Junio de 2010	Aclaración agregada de AppData y LocalAppData	Comentarios de los clientes.
Diciembre de 2010	Actualizado para el Feature Pack 2 de Visual Studio 2010.	Mejora de la información.