Tutorial: Configurar Team Build para generar un proyecto de instalación de Visual Studio
Actualización: noviembre 2007
Para personalizar Team Foundation Build, puede agregar tareas personalizadas o ejecutar tareas de MSBuild en un momento especificado del proceso de compilación. En este tema se explican los pasos necesarios para personalizar una definición de compilación de forma que use la tarea Exec de MSBuild para generar un proyecto de instalación de Visual Studio.
Requisitos previos
Necesita lo siguiente para poder llevar a cabo este tutorial:
Un equipo cliente con:
Development Edition instalado
Team Explorer instalado
Una conexión disponible a un servidor de Team Foundation Server
Un directorio local para usarlo como área de trabajo
Un proyecto de equipo que tenga:
Una definición de compilación creada
Un área de trabajo para el control de código fuente asignado al directorio local
Para obtener más información, vea Cómo: Crear un área de trabajo asignada. En este tutorial se usa el área de trabajo local: C:\DeploymentProjects.
El control de código fuente habilitado
Para asegurarse de que Visual Studio esté configurado para usar Control de versiones de Team Foundation, en el menú Herramientas, haga clic en Opciones y, a continuación, haga clic en Control de código fuente.
Seleccione Visual Studio Team Foundation Server en el cuadro de lista Complemento de control de código fuente actual.
Un agente de compilación con Team Foundation Build instalado.
Debe estar instalado Visual Studio en el agente de compilación para poder usar la tarea Exec de MSBuild para llamar a devenv.exe a fin de generar un proyecto de instalación. Para obtener más información, vea Exec (Tarea) y Modificadores de línea de comandos para Devenv.
.gif "Nota") Nota: |
|---|
El agente de la compilación es un equipo en el que se ejecutan las compilaciones. Para obtener más información, vea Cómo: Crear y administrar agentes de compilación. |
Permisos necesarios
Para completar este tutorial, debe tener los permisos Administrar una compilación y Administrar áreas de trabajo establecidos en Permitir. También debe tener los permisos Proteger y Desproteger establecidos en Permitir.
Para crear un proyecto de equipo, debe tener el permiso Crear nuevos proyectos establecido en Permitir, debe ser miembro del grupo Administración central de SharePoint en Windows SharePoint Server y debe tener permisos de Administrador de contenido en SQL Server Reporting Services.
Debe tener permiso de instalación en el equipo donde se ejecute el instalador creado por Team Foundation Build.
Crear un proyecto de Visual Studio
Mediante los procedimientos de este tutorial, se crea una sencilla aplicación en C# de formularios Windows Forms que se utiliza como ejemplo para configurar Team Foundation Build a fin de generar un proyecto de instalación de Visual Studio.
Para crear una aplicación de formularios Windows Forms de Visual Studio
En el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, seleccione Visual C# en el panel Tipos de proyecto. En el panel Plantillas, seleccione Aplicación de Windows Forms.
Escriba HelloWorldTest en el cuadro Nombre. En el cuadro Ubicación, escriba C:\DeploymentProjects o abra el área de trabajo local que seleccionó para el proyecto de equipo.
Haga clic en Aceptar.
HelloWorldTest aparece en el Explorador de soluciones y Form1.cs aparece en el Diseñador de Windows Forms.
En el menú Ver, haga clic en Cuadro de herramientas para ver la lista de controles.
Arrastre un control Button hasta el formulario.
Haga doble clic en el nuevo botón para abrir el Editor de código.
Visual C# ha insertado un método denominado button1_Click.
Agregue el código siguiente al método:
private void button1_Click(object sender, EventArgs e) { MessageBox.Show("Hello World!"); }En el menú Archivo, haga clic en Guardar todo para guardar los cambios.
En el menú Generar, haga clic en Generar HelloWorldTest para generar la solución y comprobar si se produce algún error de compilación.
Para crear un proyecto de implementación
Seleccione la solución HelloWorldTest en el Explorador de soluciones y, en el menú Archivo, elija Agregar y, a continuación, haga clic en Nuevo proyecto.
En el cuadro de diálogo Agregar nuevo proyecto, en el panel Tipos de proyecto, expanda el nodo Otros tipos de proyectos, haga clic en Instalación e implementación y, a continuación, en el panel Plantillas, haga clic en Proyecto de instalación. En el cuadro Nombre, escriba HelloWorldTestInstaller.
Haga clic en Aceptar para cerrar el cuadro de diálogo.
El proyecto se agregará al Explorador de soluciones y se abrirá el Editor del sistema de archivos.
Para agregar la aplicación HelloWorldTest al instalador
Seleccione HelloWorldTestInstaller en el Explorador de soluciones. En el Editor del sistema de archivos, haga clic con el botón secundario en el nodo Carpeta de la aplicación, elija Agregar y, a continuación, haga clic en Archivo.
En el cuadro de diálogo Agregar archivos, abra la ubicación del archivo HelloWorldTest.exe, selecciónelo y, a continuación, haga clic en Abrir.
La ubicación en este tutorial es C:\DeploymentProjects\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe. La ruta de acceso a su archivo puede ser diferente, dependiendo de la ubicación de su área de trabajo local.
En el menú Archivo, haga clic en Guardar todo para guardar los cambios.
En el menú Generar, haga clic en Generar HelloWorldTestInstaller para generar una copia local del instalador y comprobar si hay algún error de compilación.
Para comprobar si el proyecto de instalación generó el instalador, abra la ubicación del archivo de resultados. HelloWorldTestInstaller.msi y setup.exe deberían aparecer en la ubicación del archivo de resultados.
Nota:Para buscar el archivo de resultados, en el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto HelloWorldTestInstaller y, a continuación, haga clic en Propiedades. En el cuadro de diálogo Páginas de propiedades de HelloWorldTestInstaller, el cuadro Nombre del archivo de resultados contiene la ubicación de los archivos del instalador.
Para modificar el archivo .vdproj para poder trabajar con Team Foundation Build
En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto HelloWorldTestInstaller y, a continuación, haga clic en Propiedades. En el cuadro de diálogo Páginas de propiedades de HelloWorldTestInstaller, haga clic en Administrador de configuración.
Asegúrese de que la casilla Generar esté activada para HelloWorldTest y HelloWorldTestInstaller.
Haga clic en Cerrar para cerrar el cuadro de diálogo Administrador de configuración y haga clic en Aceptar para cerrar el cuadro de diálogo Páginas de propiedades de HelloWorldTestInstaller.
En el menú Archivo, haga clic en Guardar todo para guardar los cambios.
Busque el archivo HelloWorldTestInstaller.vdproj.
La ubicación en este tutorial es C:\DeploymentProjects\HelloWorldTest\HelloWorldTestInstaller. La ruta de acceso a su archivo puede ser diferente, dependiendo de la ubicación de su área de trabajo local.
Haga clic con el botón secundario del mouse en HelloWorldTestInstaller.vdproj, elija Abrir con y, a continuación, haga clic en Elegir programa. En el cuadro de diálogo Abrir con, seleccione Bloc de notas en el panel Programas y, a continuación, haga clic en Aceptar para abrir HelloWorldTestInstaller en el Bloc de notas.
Compruebe si todas las rutas de acceso son relativas a la ubicación de los archivos de HelloWorldTestInstaller.vdproj.
No debe haber ninguna ruta de acceso absoluta.
Para agregar la solución HelloWorldTest al control de código fuente de Team Foundation y protegerla
En el Explorador de soluciones, haga clic con el botón secundario en la solución HelloWorldTest y, a continuación, haga clic en Agregar solución al control de código fuente.
Aparece un signo más de color amarillo junto a todos los archivos. Este signo indica que están pendientes de incorporarse al control de código fuente.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en la solución HelloWorldTest y, a continuación, haga clic en Proteger. En el cuadro de diálogo Proteger - Archivos de código fuente - Área de trabajo: <nombre del área de trabajo>, vaya a los archivos seleccionados. Desactive la casilla Nombre correspondiente a HelloWorldTest.exe y, a continuación, haga clic en Proteger.
Los archivos quedarán protegidos en Control de versiones de Team Foundation.
.gif "Nota importante")
Nota importante:Asegúrese de que desactiva el ejecutable ya que va a configurar Team Foundation Build para generar un nuevo ejecutable.
Modificar el archivo TFSBuild.proj
Antes de generar el proyecto HelloWorldTestInstaller mediante Team Foundation Build, debe crear una nueva definición de compilación o usar una definición de compilación existente que se pueda modificar. Para obtener más información, vea Cómo: Crear una definición de compilación. Debe modificar el archivo de proyecto TFSBuild.proj asociado a la definición de compilación para indicar que va a generar el proyecto de instalación.
Para modificar el archivo TFSBuild.proj para generar el proyecto de instalación
En el menú Ver, elija Otras ventanas y, a continuación, haga clic en Explorador de control de código fuente.
En el Explorador de control de código fuente, expanda el proyecto de equipo en el panel Carpetas y busque el archivo TFSBuild.proj que ha creado. La ubicación predeterminada es la carpeta TeamBuildTypes, situada bajo la carpeta del proyecto de equipo.
En el panel de vista, seleccione el tipo de generación que desee usar para generar HelloWorldTest y HelloWorldTestInstaller. Si no tiene una copia del archivo en el área de trabajo local, haga clic con el botón secundario del mouse en la carpeta TeamBuildType y, a continuación, haga clic en Obtener la última versión.
De esta forma, los archivos podrán ser desprotegidos para editarlos.
En el panel de vista, haga doble clic en el tipo de generación, haga clic con el botón secundario en TFSBuild.proj y, a continuación, haga clic en Desproteger para editar. En el cuadro de diálogo Desproteger, seleccione Ninguno: permitir la desprotección compartida y, a continuación, haga clic en Desproteger.
Aparece una marca de verificación roja junto al archivo TFSBuild.proj, que indica el estado de su control de código fuente.
Haga doble clic en el archivo TFSBuild.proj para abrirlo en el editor XML de Visual Studio.
Agregue el código siguiente, en negrita, al final del archivo TFSBuild.proj, delante de la etiqueta de cierre </Project>.
<Target Name="AfterCompile"> <Exec Command=""$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv" "$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" /Build "Debug|Any CPU""/> <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target>En este código se utiliza la tarea exec de MSBuild para generar el proyecto de instalación HelloWorldTestInstaller invocando el programa devenv.exe. Para obtener más información, vea Exec (Tarea). La tarea copy de MSBuild se utiliza para copiar los archivos .msi y .exe en el directorio de resultados de Team Foundation Build. Para obtener más información, vea Copy (Tarea).
El destino de AfterCompile se ejecuta después de que Team Foundation Build haya terminado de ejecutar el destino de CoreCompile, donde se compila la aplicación HelloWorldTest. Para obtener más información sobre los nombres de destino, vea Introducción a los archivos de configuración de Team Foundation Build.
En el menú Archivo, haga clic en Guardar para guardar los cambios realizados y, a continuación, cierre TFSBuild.proj.
En el Explorador de control de código fuente, haga clic con el botón secundario en TFSBuild.proj y, a continuación, haga clic en Proteger cambios pendientes. De manera opcional, puede agregar un comentario en el cuadro de diálogo Proteger - Archivos de código fuente - Área de trabajo: <nombre del área de trabajo>. Haga clic en Proteger para proteger TFSBuild.proj en el control de código fuente.
Ejecutar la definición de compilación
Tras modificar el archivo TFSBuild.proj y guardar los cambios en Control de versiones de Team Foundation, ejecute la definición de compilación para generar el proyecto de implementación.
Para ejecutar la definición de compilación de equipo
En el menú Compilación, haga clic en Poner nueva compilación en cola.
En el cuadro de diálogo Poner en cola compilación "nombre del proyecto de equipo", seleccione la definición de compilación que desea utilizar, el agente de compilación, la prioridad en la cola, y, a continuación, haga clic en Cola.
Para obtener más información, vea Cómo: Poner en cola o iniciar una definición de compilación.
Puede supervisar el proceso de compilación en Build Explorer. Para obtener más información, vea Cómo: Supervisar el progreso de compilación.
En Build Explorer, haga clic en el archivo de registro bajo el encabezado Resumen. Compruebe si el archivo de registro contiene errores.
Nota:Puede omitir sin ningún riesgo la advertencia MSB4078: El archivo de proyecto "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" no es compatible con MSBuild y no puede generarse. El archivo lo genera el programa devenv.exe que utiliza la tarea Exec de MSBuild.
Para instalar el archivo de instalación generado
Busque la ubicación de destino de la generación \\<ubicación de destino>\Public_build\HelloWorldTestBuild_<número de versión de compilación>\Release.
La ubicación de destino es el mismo recurso compartido de archivos que la ubicación del archivo de registro y se muestra bajo el encabezado Resumen de Build Explorer.
Copie los archivos HelloWorldTestInstaller.msi y setup.exe a un equipo en el que sea miembro del grupo de seguridad de Administradores de Windows o donde tenga el permiso Instalar establecido en Permitir.
Haga doble clic en el archivo setup.exe y siga las instrucciones del asistente para la instalación.
HelloWorldTestInstaller.exe se instala en la ruta de acceso <raíz>:\Archivos de programa\Microsoft\HelloWorldTestInstaller.
Navegue a la ubicación <raíz>:\Archivos de programa\Microsoft\HelloWorldTestInstaller.
Haga doble clic en el archivo .exe para ejecutar la aplicación.
Pasos siguientes
Puede modificar el proyecto de instalación de Visual Studio para configurar pasos adicionales en el asistente para la instalación. Para obtener más información, vea Conceptos de implementación de Windows Installer.
Vea también
Tareas
Tutorial: Personalizar Team Foundation Build con una tarea personalizada
Otros recursos
Trabajar con definiciones de compilación en Team Foundation Build