Compartir vía

/Build (devenv.exe)

  • Artículo

Compila una solución o un proyecto mediante un archivo de configuración de solución especificado.

Sintaxis

devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]

Argumentos

  • solutionName

    Obligatorio. Ruta de acceso y nombre del archivo de solución, en relación con el directorio de la solución.

  • SolnConfigName

    Opcional. Nombre de la configuración de la solución (como Debug o Release) que se usará para compilar la solución denominada en SolutionName. Si hay varias plataformas de soluciones disponibles, también debe especificar la plataforma (por ejemplo, Debug|Win32). Si este argumento no está especificado o una cadena vacía (""), la herramienta usa la configuración activa de la solución.

  • /Project ProjName

    Opcional. Ruta de acceso y nombre de un archivo de proyecto dentro de la solución. Puede escribir una ruta de acceso relativa desde la carpeta SolutionName al archivo del proyecto, o el nombre para mostrar del proyecto, o la ruta de acceso completa y el nombre del archivo del proyecto.

  • /ProjectConfig ProjConfigName

    Opcional. Nombre de una configuración de compilación de proyecto (como Debug o Release) que se usará al compilar el proyecto con nombre. Si hay más de una plataforma de solución disponible, también debe especificar la plataforma (por ejemplo, Debug|Win32). Si se especifica este modificador, invalida el argumento SolnConfigName.

  • /Out OutputFilename

    Opcional. Nombre de un archivo al que desea enviar la salida de la herramienta. Si el archivo ya existe, la herramienta anexa la salida al final del archivo.

Observaciones

  • El modificador /Build realiza la misma función que el comando de menú solución de compilación de dentro del entorno de desarrollo integrado (IDE).

  • Incluya cadenas que incluyan espacios entre comillas dobles.

  • La información de resumen de las compilaciones, incluidos los errores, se puede mostrar en la ventana de comandos o en cualquier archivo de registro especificado con el modificador /Out.

  • El /Build modificador solo compila proyectos que han cambiado desde la última compilación. Para compilar todos los proyectos de una solución, use /rebuild en su lugar.

  • Si recibe un mensaje de error que indica configuración de proyecto no válida, asegúrese de que ha especificado una plataforma de solución o una plataforma de proyecto (por ejemplo, Debug|Win32).

Ejemplos

El comando siguiente compila el proyecto CSharpWinApp, mediante la configuración de compilación del proyecto Debug dentro de MySolution.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug

Y para limpiar todos los archivos de compilación:

devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean

Compilación de un proyecto de instalación

Para compilar un instalador (.msi archivo), necesita un proyecto de instalación de , que tiene un archivo de proyecto de .vdproj, pero para compilarlo primero debe aplicar una solución alternativa que establezca una clave del Registro determinada. En el símbolo del sistema para desarrolladores de Visual Studio, ejecute el archivo ejecutable DisableOutOfProcBuild.exe desde la carpeta Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Sin esta solución alternativa, puede obtener el error: ERROR: An error occurred while validating. HRESULT = '8000000A'. El comando afecta al usuario actual, por lo que para escenarios del agente de compilación, asegúrese de ejecutarlo desde la misma cuenta que ejecuta la compilación. Para obtener más información, consulte el archivo README.txt en la misma carpeta.

Además, en Visual Studio, puede crear una nueva configuración de , por ejemplo, Setup, en función de la configuración de Release y seleccionar el proyecto de instalación como proyecto que se va a compilar. De forma predeterminada, los proyectos de instalación no se incluyen en las configuraciones predeterminadas, Debug y Release. Con la configuración de Setup definida, los siguientes comandos compilan un proyecto WindowsFormsApp1 y su proyecto de instalación asociado para generar el archivo .msi:

devenv WindowsFormsApp1.sln /build Setup

Si la solución ya se ha compilado con la configuración de versión de, este comando solo compila el proyecto de instalación.

Consulte también