O que é análise de código com o Assistente de Atualização do .NET?
Este artigo fornece uma visão geral da função de análise de código do Assistente de Atualização do .NET. A análise de código gera um relatório com base na configuração, nas dependências e no código do projeto. O relatório contém informações sobre possíveis problemas e problemas que você pode encontrar durante a atualização e quais etapas você pode seguir para corrigir esses problemas.
Tipos de análise
Há dois tipos de análise que você pode executar em seu código:
Código-fonte e configurações
Analisa o código-fonte, a configuração e as configurações.
Dependências binárias
Analisa as dependências binárias externas (como pacotes NuGet) para seus projetos.
Relatórios
Um relatório de painel é gerado após a conclusão da análise. Este relatório divide os resultados por projeto, arquivo, incidente e pontos de história. Uma exibição agregada também está disponível para agrupar problemas semelhantes, independentemente do projeto em que foram detectados.
Dica
Os pontos de história são um conceito ágil que ajuda a estimar a complexidade e o esforço necessários para corrigir um problema. Para obter mais informações, consulte a seção Pontos de história do incidente.
Cada problema no relatório é categorizado por gravidade para ajudá-lo a priorizar as correções necessárias. Os problemas são obrigatórios ou opcionais. Problemas obrigatórios bloqueiam a atualização. Problemas opcionais fornecem uma oportunidade de atualizar para um recurso, biblioteca ou aprimoramento de código mais recente.
As seções a seguir descrevem áreas do relatório em detalhes.
Painel
A página Painel fornece uma exibição dos incidentes detectados pela verificação, agrupados em painéis:
Resumo
Projetos
Este é o número de projetos em que um incidente foi detectado.
Problemas
O número de regras exclusivas que foram acionadas durante a verificação. Cada problema tem sua própria gravidade e ponto de história, juntamente com cada instância detectada (incidente).
Incidentes
Um incidente é uma instância de um problema detectado em um local específico, como um pedaço de código ou arquivo binário. Cada incidente contém as informações contextuais que desencadearam o problema.
Pontos de História
O número total de pontos de história necessários para concluir a atualização. Para obter mais informações sobre o que é um ponto de história, consulte a seção Pontos de história do incidente.
Gravidade e Categorias
Esses dois painéis mostram gráficos que agrupam os incidentes por gravidade e categoria. Para obter mais informações sobre a gravidade, consulte a seção Gravidade do incidente.
Projetos
A página Projetos divide os problemas, incidentes e pontos de história por projeto. Cada projeto é um link que abre um relatório de detalhamento filtrado para esse projeto.
Problemas agregados
A página Problemas agregados detalha cada problema que foi disparado. Cada problema pode ser expandido para listar todos os incidentes desse problema. A coluna Estado ajuda a rastrear quais problemas você corrigiu ou considerou não aplicáveis.
Gravidade do incidente
Cada incidente de problema tem uma gravidade associada, o que pode bloquear a atualização. A gravidade ajuda você a entender o que deve ser atualizado para que a atualização seja bem-sucedida.
| Severidade | Descrição |
|---|---|
| Obrigatório | Deve ser abordado. O processo de atualização pode lidar com esses problemas para você, como atualizar o TFM (runtime da estrutura de destino). |
| Opcional | Eles não devem representar um problema com a atualização, mas você pode considerar resolvê-los antes ou depois da atualização. |
| Potencial | Problemas que podem causar problemas após a atualização, se você não os resolver agora. |
| Informações | Informações extras relacionadas à atualização. |
Pontos da história do incidente
Cada incidente de problema tem um ponto de história associado. Um ponto de história é uma unidade de medida para avaliar a complexidade de um incidente, o que ajuda a estimar o tempo envolvido para resolvê-lo. O Assistente de Atualização do .NET define valores de ponto de história pela seguinte tabela:
| Story points | Tamanho |
|---|---|
| 1 | Trivial |
| 3 | Complex |
| 5 | Recriar |
| 7 | Rearquitetura |
| 13 | Desconhecido |
