PublishSymbols@1 - ソースのインデックス作成とシンボルの発行 v1 タスク

このタスクを使用してソースコードのインデックスを作成し、ファイル共有または 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 - Search パターン
string. 必須です。 既定値: **/bin/**/*.pdb。

発行する PDB ファイルの検出に使用するパターンを指定します。

SymbolsFolder - symbols フォルダーへのパス
string.

シンボル ファイルを検索するフォルダーへのパスを指定します。 既定値は、$(Build.SourcesDirectory) です。 それ以外の場合は、ルートパス (例: ) を指定します $(Build.BinariesDirectory)/MyProject。

SkipIndexing - インデックス作成をスキップする
boolean. 既定値: false。

PDB ファイルへのソース サーバー情報の挿入をスキップするかどうかを指定します。

TreatNotIndexedAsWarning - インデックスが作成されていない場合は警告する
boolean. 既定値: false。

PDB ファイルに対してソースのインデックスが作成されていない場合に警告するかどうかを指定します。 それ以外の場合、メッセージは通常の出力としてログに記録されます。

SymbolsMaximumWaitTime - 最大待機時間 (分)
string.

ステップが失敗するまでに待機する時間 (分) です。

SymbolsProduct - 製品
string.

product パラメーターを に symstore.exe指定します。 既定値は、$(Build.DefinitionName) です。

SymbolsVersion - バージョン
string.

バージョン パラメーターを に symstore.exe指定します。 既定値は、$(Build.BuildNumber) です。

SymbolsArtifactName - 成果物名
string. 既定値: Symbols_$(BuildConfiguration)。

シンボル成果物に使用する成果物名を指定します。 既定値は、Symbols_$(BuildConfiguration) です。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	1.95.0 以上
タスクのカテゴリ	Build