O que é análise de código com o .NET Upgrade Assistant?
Este artigo fornece uma visão geral da função de análise de código do .NET Upgrade Assistant. A análise de código gera um relatório com base na configuração do projeto, dependências e código. 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 tomar 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 detetados.
Gorjeta
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 da história do incidente.
Cada problema no relatório é categorizado por gravidade para ajudá-lo a priorizar quaisquer correções que você precise fazer. As questões são obrigatórias ou opcionais. Problemas obrigatórios bloqueiam a atualização. Problemas opcionais oferecem 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.
Dashboard
A página Painel fornece uma visualização dos incidentes detetados pela verificação, agrupados em painéis:
Resumo
Projetos
Este é o número de projetos em que foi detetado um incidente.
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 detetada (incidente).
Incidentes
Um incidente é uma instância de um problema detetado 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 da 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 de incidente.
Gravidade e Categorias
Estes dois painéis mostram gráficos que agrupam os incidentes por gravidade e categoria. Para obter mais informações sobre 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 detalhado filtrado para esse projeto.
Questões agregadas
A página Problemas agregados detalha cada problema que foi acionado. Cada problema pode ser expandido para listar todos os incidentes desse problema. A coluna Estado ajuda você 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 a entender o que deve ser atualizado para que a atualização seja bem-sucedida.
| Gravidade | Description |
|---|---|
| Obrigatório | Deve ser abordado. O processo de atualização pode lidar com esses problemas para você, como atualizar o tempo de execução da estrutura de destino (TFM). |
| Opcional | Eles não devem representar um problema com a atualização, mas você pode querer considerar resolvê-los antes ou depois da atualização. |
| Potencial | Problemas que podem causar problemas após a atualização, se você não resolvê-los agora. |
| Informação | Informações adicionais relacionadas com a 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 resolver esse incidente. O Assistente de Atualização do .NET define valores de ponto de história pela tabela a seguir:
| Pontos da história | Tamanho |
|---|---|
| 1 | Trivial |
| 3 | Complex |
| 5 | Reformulação |
| 7 | Rearquitetura |
| 13 | Desconhecido |
