VCBuild (Tarea)

Actualización: noviembre 2007

Contiene vcbuild.exe, que genera proyectos y soluciones de Visual C++ que contienen proyectos de Visual C++. Para obtener más información, vea Referencia de VCBUILD.

Parameters

En la siguiente tabla se describen los parámetros de la tarea VCBuild.

Parámetro

Descripción

AdditionalLibPaths

Parámetro ITaskItem[] opcional.

Especifica rutas de acceso adicionales para anexar a la variable de entorno LIBPATH antes de ejecutar vcbuild.exe.

AdditionalOptions

Parámetro String opcional.

Especifica modificadores adicionales de la línea de comandos que no tienen parámetros de tareas dedicados.

Clean

Parámetro Boolean opcional.

Si es true, especifica que la tarea generará sólo resultados de compilación limpios. Si el valor del parámetro Rebuild es True, reemplaza este parámetro.

Configuration

Parámetro String opcional.

Especifica el nombre de la configuración y plataforma utilizados para la generación.

Por ejemplo: Debug|Win32.

Este parámetro también se puede utilizar para especificar sólo el nombre de la configuración.

Override

Parámetro ITaskItem opcional.

Especifica la ubicación de un archivo de hojas de propiedades de VCBuild que reemplaza la configuración de los archivos del proyecto.

Platform

Parámetro String opcional.

Especifica el nombre de la plataforma para la que se va a generar.

Projects

Parámetro ITaskItem[] requerido.

Especifica el proyecto que se utilizará para generar.

Rebuild

Parámetro Boolean opcional.

Si es true, especifica que la tarea limpiará los resultados de las compilaciones antes de realizar una compilación. Este parámetro reemplaza el parámetro Clean.

SolutionFile

Parámetro ITaskItem opcional.

Especifica la ruta de acceso completa al archivo de soluciones cuando se generan soluciones. Este parámetro se utiliza para resolver macros de proyecto de Visual C++ relacionadas con la solución.

Timeout

Parámetro Int32 opcional.

Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera.

ToolPath

Parámetro String opcional.

Especifica la ubicación desde la que la tarea cargará el archivo ejecutable subyacente (vcbuild.exe). Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación de SDK correspondiente a la versión de Framework que está ejecutando MSBuild.

UseEnvironment

Parámetro Boolean opcional.

Es true con el fin de utilizar variables de entorno para las rutas de acceso a INCLUDE y LIB; en caso contrario, es false.

AdditionalLinkLibraryPaths

Parámetro String opcional.

Especifica las ubicaciones de referencia adicionales que se anexarán a la variable de entorno LIB. Link.exe utiliza la ruta de acceso de LIB cuando busca un archivo especificado en la línea de comandos de Link, como un objeto o biblioteca. Lib.exe no utiliza una variable de entorno.

Ejemplo

En el ejemplo siguiente se utiliza la tarea VCBuild para generar los proyectos especificados por la colección de elementos vcprojects.

<VCBuild
   Projects="@(vcprojects)"
   Configuration="$(configuration)"
   Rebuild="true"/>

Vea también

Conceptos

Tareas de MSBuild

MSBuild

Otros recursos

Referencia de tareas de MSBuild