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 - 搜索模式
string. 必需。 默认值:**/bin/**/*.pdb

指定用于发现要发布的 PDB 文件的模式。


SymbolsFolder - 符号文件夹的路径
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.

将 version 参数指定为 symstore.exe。 默认为 $(Build.BuildNumber)


SymbolsArtifactName - 项目名称
string. 默认值:Symbols_$(BuildConfiguration)

指定要用于符号项目的项目名称。 默认为 Symbols_$(BuildConfiguration)


任务控制选项

除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

要求

要求 说明
管道类型 YAML,经典内部版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 1.95.0 或更高版本
任务类别 构建