PublishSymbols@1 – Indexquellen und Veröffentlichen von Symbolen v1 Aufgabe

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um Ihren Quellcode zu indizieren und Ihre Symbole auf einem Dateifreigabe- oder Azure Artifacts-Symbolserver zu veröffentlichen.

Wenn Sie Den Quellcode indizieren, können Sie ihre Symboldateien verwenden, um Ihre Anwendung auf einem anderen Computer als dem zu debuggen, den Sie zum Erstellen ihrer Anwendung verwendet haben. Sie können beispielsweise eine Anwendung debuggen, die von einem Build-Agent von einem Entwicklungscomputer erstellt wurde, der nicht über den Quellcode verfügt.

Symbolserver ermöglichen es Ihrem Debugger, die richtigen Symboldateien automatisch abzurufen, ohne Produktnamen, Buildnummern oder Paketnamen zu kennen.

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

Eingänge

SymbolsPath - Pfad zum Veröffentlichen von Symbolen
string.

Gibt den Pfad zur Symbolspeicherfreigabe an. Wenn dieser Wert nicht festgelegt ist, tritt die Quellindizierung auf, aber Symbole werden nicht veröffentlicht.

SearchPattern - Suchmuster
string. Erforderlich. Standardwert: **/bin/**/*.pdb.

Gibt das Muster an, das zum Ermitteln der zu veröffentlichenden PDB-Dateien verwendet wird.

SymbolsFolder - Pfad zum Symbolordner
string.

Gibt den Pfad zu dem Ordner an, der nach Symboldateien gesucht wird. Der Standardwert ist $(Build.SourcesDirectory). Geben Sie andernfalls einen root-Pfad an, z. B.: $(Build.BinariesDirectory)/MyProject.

SkipIndexing - Überspringen der Indizierung
boolean. Standardwert: false.

Gibt an, ob das Einfügen von Quellserverinformationen in die PDB-Dateien übersprungen werden soll.

TreatNotIndexedAsWarning - Warnen, wenn nicht indiziert
boolean. Standardwert: false.

Gibt an, ob gewarnt werden soll, wenn Quellen für eine PDB-Datei nicht indiziert sind. Andernfalls werden die Nachrichten als normale Ausgabe protokolliert.

SymbolsMaximumWaitTime - Max. Wartezeit (Min.)
string.

Die Anzahl der Minuten, die gewartet werden sollen, bevor der Schritt fehlschlägt.

SymbolsProduct - Produkt-
string.

Gibt den Produktparameter an, der symstore.exewerden soll. Der Standardwert ist $(Build.DefinitionName).

SymbolsVersion - Version
string.

Gibt den Versionsparameter für symstore.exean. Der Standardwert ist $(Build.BuildNumber).

SymbolsArtifactName - Artefaktname
string. Standardwert: Symbols_$(BuildConfiguration).

Gibt den Artefaktnamen an, der für das Symbolartefakt verwendet werden soll. Der Standardwert ist Symbols_$(BuildConfiguration).

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.95.0 oder höher
Vorgangskategorie	Bauen

Freigeben über