Atualize uma aplicação .NET com a modernização do GitHub Copilot

A modernização do GitHub Copilot é um agente alimentado por IA que atualiza projetos .NET para versões mais recentes e migra aplicações para Azure. Este artigo orienta-o na atualização das suas aplicações .NET através de um fluxo de trabalho estruturado em três etapas: avaliação, planeamento e execução.

O agente de modernização analisa os seus projetos e dependências, cria documentação detalhada de atualização em cada etapa e ajuda nas correções de código ao longo do processo. Suporta a atualização das versões antigas do .NET para as mais recentes, incluindo migrações do .NET Framework para o .NET moderno.

Pré-requisitos

Configura a modernização do GitHub Copilot no teu ambiente de desenvolvimento antes de começares uma atualização. Para os passos de instalação, consulte Instalar modernização do GitHub Copilot.

Iniciar a atualização

Para iniciar uma atualização, use o agente modernize-dotnet em Copilot:

Abra o seu projeto ou solução .NET no seu ambiente de desenvolvimento.
Inicie o agente usando um destes métodos:
- Visual Studio: Clique com o botão direito na solução ou projeto em Solution Explorer e selecione Modernizar. Ou abrir a janela GitHub Copilot Chat e escrever @Modernize.
- Visual Studio Code: Abra o painel GitHub Copilot Chat e escreva @modernize-dotnet.
- GitHub Copilot CLI: Digite @modernize-dotnet seguido do seu pedido de atualização ou migração.
- GitHub.com: Use o agente de codificação modernize-dotnet no seu repositório.
Diz ao agente o que deve atualizar ou migrar.

Quando inicias a atualização, o Copilot pede para criares um novo branch se estiveres a trabalhar num repositório Git. Copilot então executa um fluxo de trabalho em três etapas, escrevendo um ficheiro Markdown para cada etapa em .github/upgrades no teu repositório. Se .github/upgrades já existir de uma tentativa anterior, Copilot pergunta se deve continuar ou começar do zero.

As três fases são:

Fase de avaliação - Copilot examina o seu projeto para identificar alterações urgentes, problemas de compatibilidade e requisitos de atualização.
Planeamento - Copilot cria uma especificação detalhada explicando como resolver todos os problemas.
Fase de execução - Copilot divide o plano em tarefas sequenciais e realiza a atualização.

Iniciar a avaliação e rever os resultados

A fase de avaliação examina a estrutura do projeto, as dependências e os padrões de código para identificar o que precisa de mudar. Copilot inicia automaticamente esta fase e gera um ficheiro assessment.md em .github/upgrades.

A avaliação lista alterações disruptivas, problemas de compatibilidade com APIs, padrões obsoletos e o âmbito da atualização para que saibas o que precisa de atenção. O exemplo seguinte mostra parte de uma avaliação para um projeto ASP.NET Core a atualizar do .NET 6.0 para o .NET 10.0:

# Projects and dependencies analysis

This document provides a comprehensive overview of the projects and their dependencies in the context of upgrading to .NETCoreApp,Version=v10.0.

## Table of Contents

- [Executive Summary](#executive-Summary)
  - [Highlevel Metrics](#highlevel-metrics)
  - [Projects Compatibility](#projects-compatibility)
  - [Package Compatibility](#package-compatibility)
  - [API Compatibility](#api-compatibility)
- [Aggregate NuGet packages details](#aggregate-nuget-packages-details)
- [Top API Migration Challenges](#top-api-migration-challenges)
  - [Technologies and Features](#technologies-and-features)
  - [Most Frequent API Issues](#most-frequent-api-issues)
- [Projects Relationship Graph](#projects-relationship-graph)
- [Project Details](#project-details)

  - [MvcMovie.Tests\MvcMovie.Tests.csproj](#mvcmovietestsmvcmovietestscsproj)
  - [MvcMovie\MvcMovie.csproj](#mvcmoviemvcmoviecsproj)
  - [RazorMovie.Tests\RazorMovie.Tests.csproj](#razormovietestsrazormovietestscsproj)
  - [RazorMovie\RazorMovie.csproj](#razormovierazormoviecsproj)
  - [WpfMovie.Tests\WpfMovie.Tests.csproj](#wpfmovietestswpfmovietestscsproj)
  - [WpfMovie\WpfMovie.csproj](#wpfmoviewpfmoviecsproj)

...

Para rever e personalizar a avaliação:

Abra o assessment.md ficheiro em .github/upgrades.
Analise as alterações críticas identificadas e os problemas de compatibilidade.
Adicione qualquer contexto ou preocupações específicas do projeto ao documento.
Indica ao Copilot para avançar para a fase de planeamento.

Comece a planear e reveja o plano

A fase de planeamento converte a avaliação numa especificação detalhada que explica como resolver cada problema. Quando dizes ao Copilot para avançar para o planeamento, gera um ficheiro plan.md em .github/upgrades.

O plano documenta estratégias de atualização, abordagens de refatoração, percursos de atualização de dependências e medidas de mitigação de risco. O exemplo seguinte mostra parte de um plano para um projeto ASP.NET Core:

# .NET 10 Upgrade Plan

## Table of Contents

- [Executive Summary](#executive-summary)
- [Migration Strategy](#migration-strategy)
- [Detailed Dependency Analysis](#detailed-dependency-analysis)
- [Project-by-Project Plans](#project-by-project-plans)
- ... <removed to save space> ...
- ...

---

## Executive Summary

### Scenario Description
Upgrade all projects in the MvcMovieNet6 solution from .NET 6 to .NET 10 (Long Term Support). The solution contains:
- **RazorMovie**: ASP.NET Core Razor Pages application (primary focus)
- **MvcMovie**: ASP.NET Core MVC application
- **WpfMovie**: Windows Presentation Foundation desktop application
- **3 Test Projects**: Unit test projects for each application

### Scope & Current State
- **6 projects** requiring framework upgrade (net6.0 → net10.0)
- **1,862 total lines of code** across 54 files
- **16 NuGet packages** (6 require updates, 10 compatible)
- **65 identified issues** (1 security vulnerability, 1 deprecated package, 51 WPF API issues, minor behavioral changes)
- **All projects are SDK-style** (modern project format)

...

Para rever e personalizar o plano:

Abra o plan.md ficheiro em .github/upgrades.
Revise as estratégias de atualização e as atualizações de dependências.
Editar o plano para ajustar os passos de atualização ou adicionar contexto se necessário.

Atenção

O plano baseia-se nas interdependências dos projetos. A atualização não terá êxito se você modificar o plano de tal forma que o caminho de migração não possa ser concluído. Por exemplo, se o Projeto A depender do Projeto B e você remover o Projeto B do plano de atualização, a atualização do Projeto A poderá falhar.
Diz ao Copilot para avançar para a fase de execução.

Inicie a execução e execute a atualização

A fase de execução divide o plano em tarefas sequenciais e concretas com critérios de validação. Quando você diz ao Copilot para avançar para a execução, gera um ficheiro tasks.md em .github/upgrades.

A lista de tarefas descreve cada tarefa e como o Copilot valida o sucesso. O exemplo seguinte mostra a lista de tarefas para uma solução que contém projetos ASP.NET Core e WPF:

# MvcMovieNet6 .NET 10 Upgrade Tasks

## Overview

This document tracks the execution of the MvcMovieNet6 solution upgrade from .NET 6 to .NET 10. All projects will be upgraded simultaneously in a single atomic operation.

**Progress**: 0/3 tasks complete (0%) ![0%](https://progress-bar.xyz/0)

---

## Tasks

### [ ] TASK-001: Verify prerequisites
**References**: Plan §Phase 0

- [ ] (1) Verify .NET 10 SDK installed per Plan §Phase 0
- [ ] (2) .NET 10 SDK meets minimum requirements (**Verify**)

---

### [ ] TASK-002: Atomic framework and package upgrade with compilation fixes
**References**: Plan §Phase 1, Plan §Package Update Reference, Plan §Breaking Changes Catalog, Plan §Project-by-Project Plans

- [ ] (1) Update TargetFramework to net10.0 in MvcMovie.csproj, MvcMovie.Tests.csproj, RazorMovie.csproj, RazorMovie.Tests.csproj per Plan §Phase 1
- [ ] (2) Update TargetFramework to net10.0-windows in WpfMovie.csproj, WpfMovie.Tests.csproj per Plan §Phase 1
- [ ] (3) All project files updated to target framework (**Verify**)
- [ ] (4) Update package references per Plan §Package Update Reference (MvcMovie: EF Core 10.0.1, Code Generation 10.0.0; RazorMovie: HtmlSanitizer 9.0.889 security fix)
- [ ] (5) All package references updated (**Verify**)
- [ ] (6) Restore all dependencies across solution
- [ ] (7) All dependencies restored successfully (**Verify**)
- [ ] (8) Build solution and fix all compilation errors per Plan §Breaking Changes Catalog (focus: BinaryFormatter removal in WpfMovie, WPF control API binary incompatibilities, UseExceptionHandler behavioral changes, HtmlSanitizer API changes)
- [ ] (9) Solution builds with 0 errors (**Verify**)
- [ ] (10) Commit changes with message: "TASK-002: Complete atomic upgrade to .NET 10 (all projects, packages, and compilation fixes)"

---

### [ ] TASK-003: Run full test suite and validate upgrade
**References**: Plan §Phase 2, Plan §Testing & Validation Strategy

- [ ] (1) Run tests in MvcMovie.Tests, RazorMovie.Tests, and WpfMovie.Tests projects
- [ ] (2) Fix any test failures (reference Plan §Breaking Changes Catalog for common issues: HtmlSanitizer behavior, BinaryFormatter replacement, framework behavioral changes)
- [ ] (3) Re-run all tests after fixes
- [ ] (4) All tests pass with 0 failures (**Verify**)
- [ ] (5) Commit test fixes with message: "TASK-003: Complete testing and validation for .NET 10 upgrade"

Para executar a atualização:

Diz ao Copilot para começar a atualização.
Monitorize o progresso ao rever o ficheiro tasks.md à medida que Copilot atualiza os estados das tarefas.
Se o Copilot encontrar um problema que não consiga resolver, forneça a ajuda solicitada.
O Copilot aprende com as tuas alterações e continua a atualização.

A ferramenta cria um commit Git para cada parte do processo, para que possa facilmente reverter alterações ou obter informações detalhadas sobre o que mudou.

Verificar a atualização

Quando a atualização termina, o Copilot mostra os próximos passos recomendados na resposta do chat. Revise o tasks.md ficheiro para ver o estado de cada etapa.

A ferramenta cria um commit Git para cada parte do processo de atualização, para que possas facilmente reverter alterações ou obter informações detalhadas sobre o que mudou.

O exemplo seguinte mostra tarefas concluídas para uma atualização de projeto ASP.NET Core:

# MvcMovieNet6 .NET 10 Upgrade Tasks

## Overview

This document tracks the execution of the MvcMovieNet6 solution upgrade from .NET 6 to .NET 10. All projects will be upgraded simultaneously in a single atomic operation.

**Progress**: 3/3 tasks complete (100%) ![0%](https://progress-bar.xyz/100)

---

## Tasks

### [✓] TASK-001: Verify prerequisites *(Completed: 2025-12-12 21:09)*
**References**: Plan §Phase 0

- [✓] (1) Verify .NET 10 SDK installed per Plan §Phase 0
- [✓] (2) .NET 10 SDK meets minimum requirements (**Verify**)

...

Para verificar a atualização:

Revise o estado final da tarefa em tasks.md.
Corrigir quaisquer testes falhados ou erros de compilação.
Certifique-se de que todos os pacotes NuGet atualizados sejam compatíveis com seu aplicativo.
Teste a sua candidatura cuidadosamente para garantir que a atualização foi bem-sucedida.
Aplique novas funcionalidades e melhorias disponíveis na versão .NET melhorada.

Comentários

Esta página foi útil?

Last updated on 2026-03-12