このタスクを使用して、ソース コードのインデックスを作成し、シンボルをファイル共有または Azure Artifacts シンボル サーバーに発行します。
ソース コードのインデックスを作成すると、シンボル ファイルを使用して、アプリケーションのビルドに使用したコンピューター以外のコンピューターでアプリケーションをデバッグできます。 たとえば、ソース コードを持たない開発マシンからビルド エージェントによってビルドされたアプリケーションをデバッグできます。
シンボル サーバーを使用すると、製品名、ビルド番号、パッケージ名を知らなくても、デバッガーで正しいシンボル ファイルを自動的に取得できます。
構文
# 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).
入力
SymbolsPath
-
シンボルを発行するパス
string
。
シンボル ストア共有へのパスを指定します。 この値が設定されていない場合、ソース インデックス作成は行われますが、シンボルは発行されません。
SearchPattern
-
検索パターンの
string
。 必須。 既定値: **/bin/**/*.pdb
.
発行する PDB ファイルの検出に使用するパターンを指定します。
SymbolsFolder
-
シンボル フォルダーへのパス
string
。
シンボル ファイルを検索するフォルダーへのパスを指定します。 既定値は $(Build.SourcesDirectory)
です。 それ以外の場合は、ルートパス (例: $(Build.BinariesDirectory)/MyProject
) を指定します。
SkipIndexing
-
インデックス作成の をスキップする
boolean
。 既定値: false
.
PDB ファイルへのソース サーバー情報の挿入をスキップするかどうかを指定します。
TreatNotIndexedAsWarning
-
インデックスが作成されていない場合は警告
boolean
。 既定値: false
.
ソースが PDB ファイルのインデックス付けされていない場合に警告するかどうかを指定します。 それ以外の場合、メッセージは通常の出力としてログに記録されます。
SymbolsMaximumWaitTime
-
最大待機時間 (最小)
string
。
ステップが失敗するまでの待機時間 (分)。
SymbolsProduct
-
製品
string
。
symstore.exe
する製品パラメーターを指定します。 既定値は $(Build.DefinitionName)
です。
SymbolsVersion
-
バージョン
string
。
symstore.exe
するバージョン パラメーターを指定します。 既定値は $(Build.BuildNumber)
です。
アーティファクト名を SymbolsArtifactName
- する
string
。 既定値: Symbols_$(BuildConfiguration)
.
シンボル成果物に使用する成果物名を指定します。 既定値は Symbols_$(BuildConfiguration)
です。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。