VSBuild@1: tarea de compilación v1 de Visual Studio

Use esta tarea para compilar con MSBuild y establecer la propiedad versión de Visual Studio. Obtenga más información sobre cómo instalar imágenes de Visual Studio en Azure.

Sintaxis

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
    #enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
    #customVersion: # string. Custom Version.

Entradas

solution - solución
string. Obligatorio. Valor predeterminado: **\*.sln.

Especifica la solución para la tarea que se va a usar en el proceso de compilación.

Si desea compilar una única solución, haga clic en el botón ... y especifique la solución.

Si desea crear varias soluciones, especifique los criterios de búsqueda. Puede usar un carácter comodín de una sola carpeta (*) y caracteres comodín recursivos (**). Por ejemplo, **.sln busca todos los archivos .sln en todos los subdirectorios.

Asegúrese de que esta canalización de compilación descarga las soluciones que especifique. En la pestaña Repositorio:

• Si usa TFVC, asegúrese de que la solución es un elemento secundario de una de las asignaciones de la pestaña Repositorio.
• Si usa Git, asegúrese de que el proyecto o la solución se encuentra en el repositorio de Git y en una rama que va a compilar.

Sugerencia

• También puede compilar archivos de proyecto de MSBuild (.*proj).
• Si va a compilar un archivo de proyecto de MSBuild personalizado, se recomienda usar la tarea MSBuild en lugar de la tarea Compilación de Visual Studio.

vsVersion - versión de Visual Studio
string. Valores permitidos: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), 12.0 (Visual Studio 2013), 11.0 (Visual Studio 2012). Valor predeterminado: latest.

El valor de esta entrada debe coincidir con la versión de Visual Studio que se usa para crear la solución.

Agrega el argumento /p:VisualStudioVersion={numeric_visual_studio_version} al comando de MSBuild ejecutado por la compilación. Por ejemplo, si especifica Visual Studio 2015, se agrega /p:VisualStudioVersion=14.0 al comando de MSBuild.

azure Pipelines: si el equipo quiere usar Visual Studio con los agentes hospedados por Microsoft, seleccione más reciente de Windows como grupo de compilación predeterminado. Consulte agentes hospedados por Microsoft.

msbuildArgs - argumentos de MSBuild
string.

Pasa argumentos adicionales a MSBuild. Para obtener una sintaxis, consulte referencia de MSBuild Command-Line.

platform - Platform
string.

Especifica la plataforma que desea compilar, como Win32, x86, x64o any cpu.

Sugerencia

• Si tiene como destino un archivo de proyecto de MSBuild (.*proj) en lugar de una solución, especifique AnyCPU (sin espacio en blanco).
• Declare una variable de compilación como BuildPlatform en la pestaña Variables (seleccionando Permitir en tiempo de cola) y haga referencia a ella aquí como $(BuildPlatform). De este modo, puede modificar la plataforma al poner en cola la compilación y habilitar la creación de varias configuraciones.

de configuración de configuration -
string.

Especifica la configuración que desea compilar, como debug o release.

Sugerencia

Declare una variable de compilación como BuildConfiguration en la pestaña Variables (seleccionando Permitir en tiempo de cola) y haga referencia a ella aquí como $(BuildConfiguration). De este modo, puede modificar la plataforma al poner en cola la compilación y habilitar la creación de varias configuraciones.

clean - Limpiar
boolean. Valor predeterminado: false.

Si se establece en false, la tarea realiza una compilación incremental. Esta configuración puede reducir el tiempo de compilación, especialmente si el código base es grande. Esta opción no tiene ningún efecto práctico a menos que también establezca el repositorio Clean en false.

Si se establece en true, la tarea vuelve a generar todo el código en los proyectos de código. Esto equivale al argumento /target:clean de MSBuild.

compilación de maximumCpuCount - en en paralelo
boolean. Valor predeterminado: false.

Opcional. Si la configuración de destino de MSBuild es compatible con la compilación en paralelo, puede comprobar esta entrada para pasar el modificador de /m a MSBuild (solo Windows). Si la configuración de destino no es compatible con la compilación en paralelo, la comprobación de esta opción puede hacer que la compilación genere errores de uso de archivos o errores de compilación intermitentes o incoherentes.

restoreNugetPackages - restaurar paquetes NuGet
boolean. Valor predeterminado: false.

Esta entrada está en desuso. Para restaurar paquetes NuGet, agregue una tarea instalador de la herramienta NuGet antes de la compilación.

de arquitectura de MSBuild de msbuildArchitecture -
string. Valores permitidos: x86 (MSBuild x86), x64 (MSBuild x64). Valor predeterminado: x86.

Opcional. Proporciona la arquitectura (x86 o x64) de MSBuild que se va a ejecutar.

Sugerencia

Dado que Visual Studio se ejecuta como una aplicación de 32 bits, puede experimentar problemas cuando un agente de compilación procesa la compilación que ejecuta la versión de 64 bits del servicio de compilación de Team Foundation. Al seleccionar MSBuild x86, puede resolver estos problemas.

registrar detalles del proyecto de logProjectEvents -
boolean. Valor predeterminado: true.

Opcional. Registra los detalles de la escala de tiempo de cada proyecto.

createLogFile - Crear archivo de registro
boolean. Valor predeterminado: false.

Opcional. Crea un archivo de registro (solo Windows).

logFileVerbosity - detalle del archivo de registro
string. Opcional. Use cuando createLogFile = true. Valores permitidos: quiet, minimal, normal, detailed, diagnostic. Valor predeterminado: normal.

Especifica el nivel de detalle en los archivos de registro.

enableDefaultLogger - habilitar el registrador predeterminado
boolean. Valor predeterminado: true.

Si se establece en true, habilita el registrador predeterminado para MSBuild.

customVersion - de versión personalizada
string.

Establece una versión personalizada de Visual Studio. Ejemplos: 15.0, 16.0, 17.0. La versión necesaria de Visual Studio debe estar instalada en el sistema.

azure Pipelines: si el equipo quiere usar Visual Studio 2022 con los agentes hospedados por Microsoft, seleccione windows-2022 como grupo de compilación predeterminado. Para obtener más información, consulta agentes hospedados por Microsoft.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Obtenga más información sobre cómo instalar imágenes de Visual Studio en Azure.

Importante

Esta tarea solo se admite en agentes que ejecutan Windows.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: msbuild, visualstudio
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.95.0 o superior
Categoría de tarea	Construir