PublishSymbols@1 - Indexer les sources et publier des symboles v1

Article
07/02/2024

Utilisez cette tâche pour indexer votre code source et publier vos symboles sur un partage de fichiers ou un serveur de symboles Azure Artifacts.

L’indexation de votre code source vous permet d’utiliser vos fichiers de symboles pour déboguer votre application sur une machine autre que celle que vous avez utilisée pour générer votre application. Par exemple, vous pouvez déboguer une application générée par un agent de build à partir d’un ordinateur de développement qui n’a pas le code source.

Les serveurs de symboles permettent à votre débogueur de récupérer automatiquement les fichiers de symboles corrects sans connaître les noms de produits, de build ou de package.

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).

Entrées

SymbolsPath - Chemin d’accès à la publication des symboles
string.

Spécifie le chemin d’accès au partage de magasin de symboles. Si cette valeur n’est pas définie, l’indexation source se produit, mais les symboles ne sont pas publiés.

SearchPattern - Recherche modèle
string. Obligatoire. Valeur par défaut : **/bin/**/*.pdb.

Spécifie le modèle utilisé pour découvrir les fichiers PDB à publier.

SymbolsFolder - Chemin d’accès au dossier des symboles
string.

Spécifie le chemin d’accès au dossier dans lequel les fichiers de symboles sont recherchés. Par défaut, il s’agit de $(Build.SourcesDirectory). Sinon, spécifiez un chemin rooté, par exemple : $(Build.BinariesDirectory)/MyProject.

SkipIndexing - Ignorer l’indexation
boolean. Valeur par défaut : false.

Spécifie s’il faut ignorer l’injection d’informations sur le serveur source dans les fichiers PDB.

TreatNotIndexedAsWarning - Avertir s’il n’est pas indexé
boolean. Valeur par défaut : false.

Spécifie s’il faut avertir si les sources ne sont pas indexées pour un fichier PDB. Sinon, les messages sont enregistrés comme sortie normale.

SymbolsMaximumWaitTime - Temps d’attente maximal (min)
string.

Nombre de minutes à attendre avant d’échouer l’étape.

SymbolsProduct - Produit
string.

Spécifie le paramètre product sur symstore.exe. Par défaut, il s’agit de $(Build.DefinitionName).

SymbolsVersion - Version
string.

Spécifie le paramètre de version sur symstore.exe. Par défaut, il s’agit de $(Build.BuildNumber).

SymbolsArtifactName - Nom de l’artefact
string. Valeur par défaut : Symbols_$(BuildConfiguration).

Spécifie le nom de l’artefact à utiliser pour l’artefact de symboles. Par défaut, il s’agit de Symbols_$(BuildConfiguration).

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	1.95.0 ou version ultérieure
Catégorie de la tâche	Build

Partage via