PublishSymbols@1: tarea Indexar orígenes y publicar símbolos v1

Artículo
07/02/2024

Use esta tarea para indexar el código fuente y publicar los símbolos en un recurso compartido de archivos o en el servidor de símbolos de Azure Artifacts.

La indexación del código fuente permite usar los archivos de símbolos para depurar la aplicación en una máquina distinta de la empleada para compilar la aplicación. Por ejemplo, puede depurar una aplicación compilada por un agente de compilación desde una máquina de desarrollo que no tenga el código fuente.

Los servidores de símbolos permiten al depurador recuperar automáticamente los archivos de símbolos correctos sin conocer los nombres de producto, los números de compilación o los nombres de paquete.

Syntax

# Index sources and publish symbols v1
# Index your source code and publish symbols to a file share.
- task: PublishSymbols@1
  inputs:
    #SymbolsPath: # string. Path to publish symbols. 
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #SymbolsFolder: # string. Path to symbols folder. 
  # Advanced
    #SkipIndexing: false # boolean. Skip indexing. Default: false.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

Entradas

SymbolsPath - Ruta de acceso para publicar símbolos
string.

Especifica la ruta de acceso al recurso compartido del almacén de símbolos. Si no se establece este valor, se producirá la indexación de origen, pero no se publicarán los símbolos.

SearchPattern - patrón de Búsqueda
string. Obligatorio. Valor predeterminado: **/bin/**/*.pdb.

Especifica el patrón utilizado para detectar los archivos PDB que se van a publicar.

SymbolsFolder - Ruta de acceso a la carpeta de símbolos
string.

Especifica la ruta de acceso a la carpeta en la que se buscan los archivos de símbolos. El valor predeterminado es $(Build.SourcesDirectory). De lo contrario, especifique una ruta de acceso raíz, por ejemplo: $(Build.BinariesDirectory)/MyProject.

SkipIndexing - Omitir la indexación
boolean. Valor predeterminado: false.

Especifica si se va a omitir la inserción de información del servidor de origen en los archivos PDB.

TreatNotIndexedAsWarning - Advertir si no está indizado
boolean. Valor predeterminado: false.

Especifica si se debe advertir si los orígenes no están indexados para un archivo PDB. De lo contrario, los mensajes se registran como salida normal.

SymbolsMaximumWaitTime - Tiempo de espera máximo (min)
string.

Número de minutos que se esperarán antes de que se produzca un error en el paso.

SymbolsProduct - Producto
string.

Especifica el parámetro de producto en symstore.exe. El valor predeterminado es $(Build.DefinitionName).

SymbolsVersion - Versión
string.

Especifica el parámetro de versión en symstore.exe. El valor predeterminado es $(Build.BuildNumber).

SymbolsArtifactName - Nombre del artefacto
string. Valor predeterminado: Symbols_$(BuildConfiguration).

Especifica el nombre del artefacto que se va a usar para el artefacto de símbolos. El valor predeterminado es Symbols_$(BuildConfiguration).

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.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
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

Compartir vía