Criar ou atualizar políticas de check-in de análise de código padrão

Você pode exigir que a análise de código seja executada em todos os projetos de código em um projeto do Azure DevOps usando a política de check-in de análise de código. A exigência de análise de código pode melhorar a qualidade do código com check-in na base de código.

Observação

Esse recurso só estará disponível se você estiver usando o Team Foundation Server.

As políticas de check-in de análise de código são definidas nas configurações do projeto e se aplicam a cada projeto de código. As execuções de análise de código são configuradas para projetos de código no arquivo de projeto (.xxproj) para o projeto de código. As execuções de análise de código são executadas no computador local. Quando você habilita uma política de check-in de análise de código, os arquivos em um projeto de código que devem ser verificados devem ser compilados após a última edição e uma execução de análise de código que contém, no mínimo, as regras nas configurações do projeto que devem ser executadas no computador em que as alterações foram feitas.

  • Em relação ao código gerenciado, defina a política de check-in especificando um conjunto de regras que contenha um subconjunto das regras de análise de código.

  • No código C/C++, no Visual Studio 2017 versão 15.6 e anterior, a política de check-in exige que todas as regras de análise de código sejam executadas. Você pode adicionar diretivas de pré-processador para desabilitar regras específicas para os projetos de código individuais em seu projeto do Azure DevOps. Na versão 15.7 e posterior, você pode usar /analyze:ruleset para especificar quais regras executar. Para obter mais informações, consulte Usando conjuntos de regras para especificar as regras C++ a serem executadas.

Depois de especificar uma política de check-in para código gerenciado, os membros da equipe poderão sincronizar suas configurações de análise de código para projetos de código com as configurações de política de projeto do Azure DevOps.

Para abrir o editor de política de check-in

  1. No Team Explorer, clique com o botão direito do mouse no nome do projeto, aponte para Configurações do Projeto e depois clique em Controle do Código-Fonte.

  2. Na caixa de diálogo Controle do Código-Fonte, selecione a guia Política de Check-in.

  3. Realize um dos seguintes procedimentos:

    • Clique em Adicionar para criar uma nova política de check-in.

    • Clique duas vezes no item Análise de código existente na lista Tipo de Política para alterar a política.

Para definir opções de política

Selecione ou desmarque as seguintes opções:

Opção Descrição
Impor o check-in para conter apenas arquivos que fazem parte da solução atual. A análise de código só pode ser executada em arquivos especificados em arquivos de configuração de solução e de projeto. Essa política garante que todo o código que faz parte de uma solução seja analisado.
Impor análise de código C/C++ (/analyze) Exige que todos os projetos C ou C++ sejam criados com a opção /analyze do compilador para executar a análise de código antes que eles possam passar pelo check-in.
Impor Code Analysis para Código Gerenciado Exige que todos os projetos gerenciados executem a análise de código e o build antes que eles possam passar pelo check-in.

Para especificar um conjunto de regras gerenciadas

Na lista Executar este conjunto de regras, use um dos seguintes métodos:

  • Selecione um conjunto de regras padrão da Microsoft.

  • Selecione um conjunto de regras personalizado clicando em <Selecionar Conjunto de Regras no Controle do Código-Fonte...>. Em seguida, digite o caminho de controle de versão do conjunto de regras no navegador de controle do código-fonte. A sintaxe de um caminho de controle de versão é:

    $/ TeamProjectName / VersionControlPath

Para obter mais informações sobre como criar e implementar um conjunto de regras de política de check-in personalizado, consulte Implementar políticas de check-in personalizadas para código gerenciado.