Atualizar projetos C++ de versões anteriores do Visual Studio

Para atualizar um projeto criado em uma versão anterior do Visual Studio, abra o projeto na versão mais recente do Visual Studio. Se você ainda estiver usando uma versão mais antiga do Visual Studio lado a lado, poderá optar por não atualizar seus projetos até estar pronto para manter a compatibilidade com ambas as versões.

No Visual Studio 2026, essa experiência é aprimorada com um assistente de configuração. O assistente de instalação oferece para instalar ferramentas ausentes usando o instalador do Visual Studio e para permanecer em uma versão mais antiga ou redirecionar seus projetos para a versão mais recente. Você pode abrir o assistente de configuração no Gerenciador de Soluções clicando com o botão direito do mouse em sua solução e selecionando Redirecionar solução.

Com o assistente de configuração aberto, escolha uma ação para cada destino ou selecione Redirecionar todos para definir todos os projetos de uma só vez. Em seguida, selecione Aplicar para concluir a atualização no local. Depois que seus projetos forem redirecionados, eles não poderão ser convertidos de volta para a versão anterior. É uma boa prática fazer uma cópia de backup dos arquivos de projeto e solução existentes antes de atualizá-los.

Atualizar relatórios

Ao atualizar um projeto, você recebe um relatório de atualização. O relatório também é salvo na pasta do projeto como UpgradeLog.htm. O relatório de atualização mostra um resumo dos problemas encontrados durante a conversão. Ele lista algumas informações sobre as alterações que foram feitas, incluindo:

• Propriedades do projeto.

• Inclua arquivos.

• Código que não é mais compilado corretamente devido a melhorias de conformidade do compilador ou alterações no padrão.

• Código que depende de recursos do Visual Studio ou do Windows que não estão mais disponíveis. Ou, arquivos de cabeçalho que não estão incluídos em uma instalação padrão do Visual Studio ou foram removidos do produto.

• Código que não é mais compilado devido a alterações em APIs, como APIs renomeadas, assinaturas de função alteradas ou funções preteridas.

• Código que não é mais compilado devido a alterações no diagnóstico, como um aviso se tornando um erro

• Erros de vinculador devido a bibliotecas que foram alteradas, especialmente quando /NODEFAULTLIB é usado.

• Erros de tempo de execução ou resultados inesperados devido a alterações de comportamento.

• Erros que foram introduzidos nas ferramentas. Se você encontrar um problema, relate-o à equipe do Microsoft C++ por meio de seus canais de suporte normais ou usando a página Comunidade de desenvolvedores do Visual Studio C++ .

Alguns projetos e soluções atualizados podem ser construídos com sucesso sem modificações. No entanto, a maioria dos projetos provavelmente exigirá alterações nas configurações do projeto e no código-fonte. Não há uma única maneira correta de corrigir esses problemas, mas recomendamos o uso de uma abordagem em fases. Antes de começar, revise Visão geral de possíveis problemas de atualização para obter mais informações sobre muitos tipos de erros comuns.

1. Defina a versão Platform Toolset, C++ Language Standard e Windows SDK (se aplicável) para as versões preferidas. (Projeto>Propriedades>Propriedades> de configuraçãoGeral)

2. Se tiver muitos erros, pode desativar temporariamente algumas opções enquanto os corrige. Para desativar a /permissive- opção, use Project>Properties>Configuration Properties>C/C++>Language. Para desativar a opção análise de código, use Projeto>Propriedades>Propriedades de Configuração>Análise de Código.

3. Certifique-se de que todas as dependências estão presentes e que os caminhos de inclusão ou os locais das bibliotecas estão corretos. (Projeto>Propriedades>Propriedades> de configuraçãoDiretórios VC++)

4. Identifique e corrija erros causados por referências a APIs que não existem mais.

5. Corrija quaisquer erros restantes que impeçam a compilação. Consulte Visão geral de possíveis problemas de atualização para correções de erros comuns.

6. Ative /permissive- novamente e corrija quaisquer novos erros causados por código não conforme compilado anteriormente no MSVC.

7. Ative a análise de código para identificar possíveis problemas ou padrões de codificação desatualizados que não são mais considerados aceitáveis. Se a análise de código sinalizar muitos erros, você pode desativar alguns dos avisos para se concentrar nos mais importantes primeiro. O IDE pode ajudar com correções rápidas para alguns tipos de problemas.

8. Considere outras oportunidades para modernizar o código. Por exemplo, substitua estruturas de dados e algoritmos personalizados por outros da biblioteca padrão C++ ou da biblioteca de código aberto Boost. Ao usar recursos padrão, você torna mais fácil para outras pessoas manterem o código. Você pode ter certeza de que esse código foi bem testado e revisado por muitos especialistas no comitê de padrões e na comunidade C++ mais ampla.

Para erros difíceis de corrigir, você pode procurar soluções ou postar uma pergunta nas Perguntas e Respostas do Microsoft Learn. Para problemas no compilador e nas ferramentas C++, tente o site da Comunidade de desenvolvedores C++ .

Nesta secção

Visão geral de possíveis problemas de atualização
Atualize seu código para o CRT Universal
Atualizar WINVER e _WIN32_WINNT
Corrija as suas dependências nos componentes internos da biblioteca
Problemas de migração de ponto flutuante
Recursos do C++ descontinuados no Visual Studio
VCBuild vs. MSBuild
Portar bibliotecas de terceiros

Ver também

O que há de novo no Microsoft C++ no Visual Studio
Histórico de alterações do Visual C++ 2003 - 2015
Comportamento fora do padrão
Aplicações de dados de portos