Compartir a través de

/Build (devenv.exe)

  • Artículo

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

Sintaxis

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

Argumentos

  • SolutionName

    Necesario. 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 solución (por ejemplo, Debug o Release) que se usará para compilar la solución indicada en SolutionName. Si hay varias plataformas de solución disponibles, también se tiene que especificar la plataforma (por ejemplo, Debug|Win32). Si no se especifica este argumento o se usa una cadena vacía (""), la herramienta usará 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 bien la ruta de acceso completa y el nombre del archivo del proyecto.

  • /ProjectConfig ProjConfigName

    Opcional. Nombre de una configuración de compilación del proyecto (por ejemplo, Debug o Release) que se usará para crear el proyecto indicado. Si hay más de una plataforma de solución disponible, también tendrá que especificar la plataforma (por ejemplo, Debug|Win32). Si se especifica este modificador, reemplaza al argumento SolnConfigName.

  • /Out OutputFilename

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

Comentarios

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

  • Escriba las cadenas que incluyen espacios entre comillas dobles.

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

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

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

Ejemplos

El comando siguiente compila el proyecto CSharpWinApp con la configuración de compilación del proyecto Debug en 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, que tiene un .vdproj archivo de proyecto, 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, por ejemplo Setup, , en función de la Release configuración y seleccionar el proyecto de instalación como un 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 Setup configuración definida, los siguientes comandos compilan un proyecto WindowsFormsApp1 y su proyecto de instalación asociado para generar el .msi archivo:

devenv WindowsFormsApp1.sln /build Setup

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

Consulte también