PublishSymbols@2 - Indexar fontes e publicar símbolos v2 tarefa

Use esta tarefa para indexar seu código-fonte e publicar seus símbolos em um compartilhamento de arquivos ou servidor de símbolos do Azure Artifacts.

A indexação do código-fonte permite que você use seus arquivos de símbolo para depurar seu aplicativo em uma máquina diferente daquela que você usou para criar seu aplicativo. Por exemplo, você pode depurar um aplicativo criado por um agente de compilação de uma máquina de desenvolvimento que não tenha o código-fonte.

Os servidores de símbolos permitem que o depurador recupere automaticamente os arquivos de símbolos corretos sem saber nomes de produtos, números de compilação ou nomes de pacotes.

# Index sources and publish symbols v2
# Index your source code and publish symbols to a file share or Azure Artifacts symbol server.
- task: PublishSymbols@2
  inputs:
    #SymbolsFolder: '$(Build.SourcesDirectory)' # string. Path to symbols folder. Default: $(Build.SourcesDirectory).
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #Manifest: # string. Manifest. 
    #IndexSources: true # boolean. Index sources. Default: true.
    #PublishSymbols: true # boolean. Publish symbols. Default: true.
    SymbolServerType: # 'TeamServices' | 'FileShare'. Required when PublishSymbols = true. Symbol server type. 
    #SymbolsPath: # string. Optional. Use when PublishSymbols = true && SymbolServerType = FileShare. Path to publish symbols. 
    #CompressSymbols: false # boolean. Optional. Use when SymbolServerType = FileShare. Compress symbols. Default: false.
    #SymbolExpirationInDays: '36530' # string. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol Expiration (in days). Default: 36530.
  # Advanced
    #IndexableFileFormats: 'Default' # 'Default' | 'Pdb' | 'SourceMap' | 'All'. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol file formats to publish. Default: Default.
    #DetailedLog: true # boolean. Verbose logging. Default: true.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #UseNetCoreClientTool: false # boolean. Use NetCore client tool. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

# Index sources and publish symbols v2
# Index your source code and publish symbols to a file share or Azure Artifacts symbol server.
- task: PublishSymbols@2
  inputs:
    #SymbolsFolder: '$(Build.SourcesDirectory)' # string. Path to symbols folder. Default: $(Build.SourcesDirectory).
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #IndexSources: true # boolean. Index sources. Default: true.
    #PublishSymbols: true # boolean. Publish symbols. Default: true.
    SymbolServerType: # 'TeamServices' | 'FileShare'. Required when PublishSymbols = true. Symbol server type. 
    #SymbolsPath: # string. Optional. Use when PublishSymbols = true && SymbolServerType = FileShare. Path to publish symbols. 
    #CompressSymbols: false # boolean. Optional. Use when SymbolServerType = FileShare. Compress symbols. Default: false.
    #SymbolExpirationInDays: '36530' # string. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol Expiration (in days). Default: 36530.
  # Advanced
    #IndexableFileFormats: 'Default' # 'Default' | 'Pdb' | 'SourceMap' | 'All'. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol file formats to publish. Default: Default.
    #DetailedLog: true # boolean. Verbose logging. Default: true.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #UseNetCoreClientTool: false # boolean. Use NetCore client tool. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

SymbolsFolder - Caminho para a pasta de símbolos
string. Valor padrão: $(Build.SourcesDirectory).

Especifica o caminho para a pasta que é pesquisada com arquivos de símbolo. A predefinição é $(Build.SourcesDirectory). Caso contrário, especifique um caminho enraizado, como $(Build.BinariesDirectory)/MyProject.

SearchPattern - Padrão de pesquisa
string. Obrigatório. Valor padrão: **/bin/**/*.pdb.

Especifica o padrão usado para descobrir os arquivos PDB a serem publicados. Consulte de referência de padrões de correspondência de arquivos para obter mais informações.

Manifest - Manifesto
string.

O caminho para um arquivo que contém mais chaves de cliente de símbolo para publicar.

IndexSources - Fontes do índice
boolean. Valor padrão: true.

Especifica se as informações do servidor de origem devem ser injetadas nos arquivos PDB. Esta opção só é suportada em agentes Windows.

PublishSymbols - Publicar símbolos
boolean. Valor padrão: true.

Especifica se os arquivos de símbolo devem ser publicados.

SymbolServerType - Tipo de servidor Symbol
string. Necessário quando PublishSymbols = true. Valores permitidos: TeamServices (Servidor de Símbolos nesta organização/coleção (requer Artefatos do Azure)), FileShare (Compartilhamento de arquivos).

Especifica onde publicar símbolos. Os símbolos publicados no servidor de símbolos de Artefatos do Azure são acessíveis por qualquer usuário com acesso à organização/coleção. O Azure DevOps Server suporta apenas a opção File share. Consulte as instruções para símbolos de publicação para depuração para usar o Servidor de Símbolos nos Artefatos do Azure.

SymbolsPath - Caminho para publicar símbolos
string. Opcional. Use quando PublishSymbols = true && SymbolServerType = FileShare.

Especifica o compartilhamento de arquivos que hospeda seus símbolos. Esse valor será usado na chamada para symstore.exe add como o parâmetro /s. Para preparar a sua loja de símbolos SymStore:

1. Configure uma pasta em um servidor de compartilhamento de arquivos para armazenar os símbolos. Por exemplo, configure \fabrikam-share\symbols.
2. Conceda permissão de controle total à conta de serviço do agente de compilação .

Se você deixar esse argumento em branco, seus símbolos serão indexados na fonte, mas não publicados. Você também pode armazenar seus símbolos com suas gotas. Consulte Publicar artefatos de compilação.

CompressSymbols - Comprimir símbolos
boolean. Opcional. Use quando SymbolServerType = FileShare. Valor padrão: false.

Compacta símbolos ao publicar no compartilhamento de arquivos.

SymbolExpirationInDays - Expiração do símbolo (em dias)
string. Opcional. Use quando PublishSymbols = true && SymbolServerType = TeamServices. Valor padrão: 36530.

Especifica o número de dias em que os símbolos devem ser mantidos.

IndexableFileFormats - Formatos de arquivo de símbolo para publicar
string. Opcional. Use quando PublishSymbols = true && SymbolServerType = TeamServices. Valores permitidos: Default (O conjunto padrão de símbolos para carregar), Pdb (Somente símbolos baseados em Pdb do Windows pdb e pdbs portáteis gerenciados.), SourceMap (Somente símbolos SourceMap baseados em JavaScript (*.js.map)), All (Todos os formatos de símbolos suportados). Valor padrão: Default.

Especifica quais formatos de depuração devem ser publicados no servidor de símbolos.

DetailedLog - de registro detalhado
boolean. Valor padrão: true.

Especifica o registro detalhado.

TreatNotIndexedAsWarning - Avisar se não estiver indexado
boolean. Valor padrão: false.

Especifica se as fontes não estão indexadas para um arquivo PDB devem ser avisadas. Caso contrário, as mensagens são registradas como saída normal.

UseNetCoreClientTool - Usar a ferramenta de cliente NetCore
boolean. Valor padrão: false.

Especifica se deve ser usada uma versão da ferramenta de carregamento de símbolos que ofereça suporte a arquivos DWARF e ELF. Esta opção só é importante para agentes Windows. Em agentes que não sejam Windows, a versão da ferramenta de upload de símbolos que suporta arquivos DWARF e ELF sempre será usada.

SymbolsMaximumWaitTime - Tempo de espera máximo (min)
string.

Especifica o número de minutos a aguardar antes de falhar esta tarefa.

SymbolsProduct - Produto
string.

Especifica o parâmetro do produto a ser symstore.exe. A predefinição é $(Build.DefinitionName).

SymbolsVersion - Versão
string.

Especifica o parâmetro version a ser symstore.exe. A predefinição é $(Build.BuildNumber).

SymbolsArtifactName - Nome do artefato
string. Valor padrão: Symbols_$(BuildConfiguration).

Especifica o nome do artefato a ser usado para o artefato de símbolos. Isso só deve ser usado com o tipo de servidor de símbolo FileShare. A predefinição é Symbols_$(BuildConfiguration).

Nenhum.