Compartir vía


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

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

Syntax

# 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.
# 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' | '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.
# 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' | '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.

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 carpeta única (*) 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 Git y en una bifurcación que esté compilando.

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 usada para crear la solución.

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

Azure Pipelines: si el equipo quiere usar Visual Studio con los agentes hospedados por Microsoft, seleccione Windows-latest como grupo de compilación predeterminado. Consulte Agentes hospedados por Microsoft.


vsVersion - Versión de Visual Studio
string. Valores permitidos: latest, 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 usada para crear la solución.

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

Azure Pipelines: si el equipo quiere usar Visual Studio con los agentes hospedados por Microsoft, seleccione Windows-latest como grupo de compilación predeterminado. Consulte Agentes hospedados por Microsoft.


msbuildArgs - Argumentos de MSBuild
string.

Pasa argumentos adicionales a MSBuild. Para obtener ayuda, consulte Referencia de línea de comandos de MSBuild.


platform - Plataforma
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.

configuration - Configuración
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 - Limpio
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 falseClean en .

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


maximumCpuCount - Compilación 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 /m modificador 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 - Restauración de 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.


msbuildArchitecture - Arquitectura de MSBuild
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.


logProjectEvents - Registrar detalles del proyecto
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 registrador predeterminado
boolean. Valor predeterminado: true.

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


customVersion - 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, consulte Agentes hospedados por Microsoft.


Opciones de control de tareas

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

Variables de salida

Ninguno.

Comentarios

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
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: msbuild, visualstudio
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 1.95.0 o superior
Categoría de la tarea: Build