Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Visual Studio 2022 Portar, migrar e atualizar projetosCada nova versão do Visual Studio oferece suporte à maioria dos tipos de projetos, arquivos e outros ativos. Você pode trabalhar com eles como sempre fez, desde que não dependa de recursos mais recentes.
Tentamos preservar a compatibilidade com versões anteriores, como Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 e Visual Studio 2012. No entanto, o suporte para alguns tipos de projeto muda ao longo do tempo. Uma versão mais recente do Visual Studio pode não oferecer suporte a determinados projetos ou pode exigir que você atualize um projeto para que ele não seja mais compatível com versões anteriores.
Observação
Para obter o status atual sobre problemas de migração, consulte a Comunidade de desenvolvedores do Visual Studio. E para saber mais sobre quais recursos são específicos para qual versão do Visual Studio, consulte as Notas de versão.
Importante
Alguns tipos de projeto exigem cargas de trabalho específicas. Se você não tiver a carga de trabalho instalada, o Visual Studio relatará um tipo de projeto desconhecido ou incompatível. Nesse caso, verifique as opções de instalação no instalador do Visual Studio e tente novamente. Para obter mais informações sobre o suporte a projetos no Visual Studio 2022, consulte a página Platform Targeting and Compatibility (Segmentação e compatibilidade de plataforma ).
Tipos de projeto
A lista a seguir descreve o suporte no Visual Studio 2022 para projetos que foram criados em versões anteriores.
Se você não vir um projeto ou tipo de arquivo listado aqui que deveria ser, consulte a versão Visual Studio 2019 deste artigo. Você também pode usar o botão Enviar e exibir comentários para>Esta página na parte inferior desta página para fornecer detalhes do seu projeto. (Se você usar o controle anônimo "Esta página foi útil?", não poderemos responder aos seus comentários.)
| Tipo de Projeto | Support |
|---|---|
| Projetos .NET Core (xproj) | Os projetos criados com o Visual Studio 2015 usavam ferramentas de visualização que incluíam um arquivo de projeto xproj. Visual Studio 2017: O formato xproj não é suportado a não ser para a migração para o formato csproj. Ao abrir um arquivo xproj, você será solicitado a migrar o arquivo para o formato csproj no estilo SDK. (Um backup do arquivo xproj é feito.) Projetos csproj no estilo SDK não são suportados no Visual Studio 2015 e anteriores. Visual Studio 2019: Na versão 16.3 e posterior, não é possível carregar ou migrar projetos xproj. Para obter mais informações, consulte Migrando projetos .NET Core para o formato csproj. |
| ASP.NET Core Web App e ASP.NET Core Web App com o Application Insights ativado | Para cada usuário do Visual Studio, as informações de recurso são armazenadas no registro por instância de usuário. Essas informações são usadas quando um usuário não tem um projeto aberto e deseja pesquisar dados do Azure Application Insights. O Visual Studio 2015 usa um local do Registro diferente do Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022 e não entra em conflito. Depois que um usuário cria um Aplicativo Web ASP.NET, ASP.NET Aplicativo Web Principal ou ASP.NET Aplicativo Web Principal, o recurso é armazenado no arquivo .suo. O usuário pode abrir o projeto no Visual Studio 2015, Visual Studio 2017, Visual Studio 2019 ou Visual Studio 2022, e as informações do recurso são usadas para cada um, desde que o Visual Studio ofereça suporte a projetos e soluções que estão sendo usados em ambas as versões. Os usuários precisam se autenticar uma vez em cada produto. Por exemplo, se um projeto for criado com o Visual Studio 2017 e aberto no Visual Studio 2022, o usuário precisará se autenticar no Visual Studio 2022. |
| Webform C#/Visual Basic ou Windows Form | Você pode abrir o projeto no Visual Studio 2022, Visual Studio 2019, Visual Studio 2017 e Visual Studio 2015. |
| Teste de interface do usuário codificado | O teste codificado da interface do usuário para testes funcionais automatizados orientados pela interface do usuário foi preterido no Visual Studio 2019. O Visual Studio 2019 será a última versão para o teste de interface do usuário codificada. Recomendamos usar o Selenium para testar aplicativos Web e o Appium com WinAppDriver para testar aplicativos de área de trabalho e UWP. |
| Projetos de teste de unidade de banco de dados (csproj, .vbproj) | Projetos de teste de unidade de dados mais antigos são carregados no Visual Studio 2019, mas usam a versão GAC das dependências. Para atualizar o projeto de teste de unidade para usar as dependências mais recentes, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Converter em Projeto de Teste de Unidade do SQL Server.... |
| F# | O Visual Studio 2019 pode abrir projetos criados no Visual Studio 2013, Visual Studio 2015 e Visual Studio 2017. Uma diferença importante dos modelos mais antigos do Visual Studio para novos projetos é que a versão FSharp.Core agora é sempre um pacote NuGet. F# é instalado por padrão com qualquer carga de trabalho .NET. |
| InstallShield Configuração MSI |
Projetos de instalador criados no Visual Studio 2010 podem ser abertos em versões posteriores com a ajuda da extensão Visual Studio Installer Projects. Consulte também a extensão WiX Toolset Visual Studio 2017. O InstallShield Limited Edition não está mais incluído no Visual Studio. Verifique com a Revenera sobre a disponibilidade para o Visual Studio 2022. |
| Interruptor de luz | O LightSwitch não é mais suportado no Visual Studio 2022, Visual Studio 2019 ou Visual Studio 2017. Projetos criados com o Visual Studio 2012 e anteriormente abertos no Visual Studio 2013 ou Visual Studio 2015 são atualizados e podem ser abertos somente no Visual Studio 2013 ou Visual Studio 2015 posteriormente. |
| Teste de carga | Os recursos de teste de carga e desempenho da Web foram preteridos no Visual Studio 2019. O Visual Studio 2019 será a última versão para teste de carga. Use ferramentas alternativas de teste de carga, como Apache JMeter, Akamai CloudTest, Blazemeter. |
| Ferramentas do Microsoft Azure para Visual Studio | Para abrir esses tipos de projetos, primeiro instale o SDK do Azure para .NET e, em seguida, abra o projeto. Se necessário, o seu projeto é atualizado. |
| Gestor de Testes Microsoft | O Microsoft Test Manager e o Feedback Client não são mais enviados no Visual Studio, começando com o Visual Studio 2019. Aproveite os Planos de Teste do Azure (parte do Azure DevOps) para suas necessidades de testes manuais e exploratórios. |
| Model-View-Controller framework (ASP.NET MVC) | Suporte para versões MVC e Visual Studio:
Atualizando versões do MVC:
|
| Modeling | Se você permitir que o Visual Studio atualize o projeto automaticamente, poderá abri-lo no Visual Studio 2015, Visual Studio 2013 ou Visual Studio 2012. O formato do projeto de modelagem não mudou desde o Visual Studio 2015 e o projeto pode ser aberto e modificado nessas versões. No entanto, há diferenças no comportamento no Visual Studio 2017 e no Visual Studio 2019:
|
| Configuração MSI (vdproj) | Consulte a seção InstallShield desta página. |
| Office 2007 VSTO | Requer uma atualização unidirecional para o Visual Studio 2022. |
| Office 2010 VSTO | Se o projeto tem como alvo o .NET Framework 4, você pode abri-lo no Visual Studio 2010 SP1 e posterior. Todos os outros projetos requerem uma atualização unidirecional. |
| Biblioteca de Classes Portátil (PCL) | As bibliotecas de classes portáteis (ou PCLs) agora não são suportadas. O Visual Studio 2019 ainda irá abri-los e criá-los, mas não é possível criar novos projetos PCL. Recomendamos migrar o código em um projeto PCL para um projeto .NET Standard. O suporte a PCL não será mais incluído por padrão, mas estará disponível na guia "Componentes individuais" do Visual Studio. |
| Carga de trabalho Python | O suporte para aplicativos Python Windows IoT Core foi removido no Visual Studio 2019. Como não há equivalente no Visual Studio 2022, não há um caminho de migração automática para esses projetos. Você pode continuar usando o Visual Studio 2017. |
| Ferramentas R para Visual Studio | O R Tools for Visual Studio foi removido da carga de trabalho de ciência de dados no Visual Studio 2019. Você pode continuar usando o Visual Studio 2017 ou alternativas como RStudio. |
| Service Fabric (sfproj) | Os projetos de aplicativo do Service Fabric criados no Visual Studio 2017 ou no Visual Studio 2019 podem ser abertos no Visual Studio 2022 sem alterações. Os projetos de aplicativo do Service Fabric criados no Visual Studio 2022 sem usar a opção Otimizar layout de projeto para implantação ARM podem ser abertos no Visual Studio 2019 16.5 ou posterior. Os projetos de aplicativo do Service Fabric criados no Visual Studio 2022 usando a opção Otimizar layout de projeto para implantação ARM podem ser abertos no Visual Studio 2019 16.10 ou posterior. |
| SharePoint 2010 | Quando um projeto de solução do SharePoint é aberto com o Visual Studio 2022, ele é atualizado para o SharePoint 2016 ou o SharePoint 2019. A carga de trabalho ".NET Desktop Development" deve ser instalada no Visual Studio para a atualização. Para obter mais informações sobre como atualizar projetos do SharePoint, consulte Atualizar e atualizar o SharePoint. |
| SharePoint 2016 | Os projetos do SharePoint Add-In criados no Office Developer Tools Preview 2 não podem ser abertos no Visual Studio 2022. Para contornar essa limitação, atualize o MinimumVisualStudioVersion para 12.0 e MinimumOfficeToolsVersion para 12.2 no arquivo csproj vbproj. |
| Silverlight | Projetos do Silverlight sem suporte no Visual Studio 2022. Para manter os aplicativos do Silverlight, continue a usar o Visual Studio 2015. |
| SQL - Redgate | O SQL Change Automation Core da Redgate (anteriormente chamado de ReadyRoll Core), o SQL Prompt Core e o SQL Search não são mais enviados no instalador do Visual Studio. Você pode continuar usando o Visual Studio 2017 para esses recursos. No Visual Studio 2019, você pode atualizar para os produtos pagos SQL Change Automation e SQL Prompt que estão disponíveis no SQL Toolbelt da Redgate. |
| SQL Server Reporting Services e SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) | O suporte para esses tipos de projeto é fornecido por meio de duas extensões na Galeria do Visual Studio: Projetos do Microsoft Analysis Services e Projetos do Microsoft Reporting Services. O suporte a SSDT também está incluído na carga de trabalho de Armazenamento e Processamento de Dados no Visual Studio 2019. Para obter mais informações, consulte a página Baixar e instalar o SSDT (SQL Server Data Tools) para Visual Studio . |
| SQL Server Integration Services (SSIS) | A extensão Projetos do SQL Server Integration Services está disponível em geral para o Visual Studio 2022. Baixe do SQL Server Integration Services Projects 2022 - Visual Studio Marketplace e consulte o guia de solução de problemas para obter diretrizes de solução de problemas. |
| Extensão da janela de teste | No Visual Studio 2019, algumas APIs de janela de teste que foram anteriormente marcadas como públicas, mas nunca foram oficialmente documentadas, foram removidas. APIs amplamente visíveis foram marcadas como preteridas no Visual Studio 2017 para dar aos mantenedores de extensão um aviso antecipado. Até onde sabemos, poucas extensões dependeram dessas APIs. Para obter mais informações e atualizações, consulte a lista completa de APIs relacionadas a testes preteridas. Se isso afetar seu cenário, informe-nos por meio da Comunidade de desenvolvedores do Visual Studio. |
| TypeScript | O SDK TypeScript foi preterido no Visual Studio 2022 e não é mais instalado por padrão em nenhuma carga de trabalho. Os projetos que compilam o TypeScript devem instalar o pacote NuGet Microsoft.TypeScript.MSBuild . Para dar suporte a projetos que não podem ser atualizados imediatamente, o SDK TypeScript ainda está disponível como um componente opcional no instalador do Visual Studio, bem como no Visual Studio Marketplace. |
| Visual C++ | Você pode usar o Visual Studio 2022 para trabalhar em projetos que foram criados em versões anteriores do Visual Studio de volta para o Visual Studio 2010. Quando você abre o projeto pela primeira vez, você tem a opção de atualizar para o compilador e conjunto de ferramentas mais recentes ou continuar usando os originais. Se você optar por continuar usando os originais, o Visual Studio 2022 não modificará o arquivo de projeto e usará o conjunto de ferramentas da instalação anterior do Visual Studio para criar seu projeto. Manter as opções originais significa que você ainda pode abrir o projeto na versão original do Visual Studio, se necessário. Para obter mais informações, consulte Usar multiplataforma nativa no Visual Studio para criar projetos antigos. |
| Extensibilidade do Visual Studio/VSIX | Projetos com MinimumVersion 14.0 ou menos são atualizados para declarar MinimumVersion 15.0, o que impede que o projeto seja aberto em versões anteriores do Visual Studio. Para permitir que um projeto seja aberto em versões anteriores, defina MinimumVersion como $(VisualStudioVersion). Consulte também Como migrar projetos de extensibilidade para o Visual Studio 2017. |
| Gerenciamento de laboratório do Visual Studio | Você pode usar o Microsoft Test Manager ou Visual Studio 2010 SP1 e posterior para abrir ambientes criados em qualquer uma dessas versões. No entanto, para Visual Studio 2010 SP1 a versão do Microsoft Test Manager deve corresponder à versão do Team Foundation Server antes de você pode criar ambientes. (Importante: Team Foundation Server, ou TFS, agora é conhecido como Azure DevOps Server.) |
| Ferramentas do Visual Studio para Apache Cordova | O suporte para Apache Cordova foi removido no Visual Studio 2019. Como não há equivalente no Visual Studio 2022, não há um caminho de migração automática para esses projetos. Você pode usar a extensão Cordova Tools for Visual Studio Code (que fornece suporte para a versão mais recente do Cordova) ou continuar usando o Visual Studio 2017. |
| Implantação da Web (wdproj) | O suporte para projetos de implantação da Web foi removido no Visual Studio 2012 com a adição do suporte ao perfil de publicação. Como não há equivalente no Visual Studio 2022, não há um caminho de migração automática para esses projetos. Em vez disso, abra o arquivo wdproj em um editor de texto e copie e cole todas as personalizações no arquivo pubxml (perfil de publicação), conforme descrito em StackOverflow. |
| Windows Communication Foundation, Fundação de Fluxo de Trabalho do Windows | Você pode abrir este projeto no Visual Studio 2022, Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 e Visual Studio 2012. |
| Arquitectura de Apresentação do Windows | Você pode abrir este projeto no Visual Studio 2022, Visual Studio 2019, Visual Studio 2017, Visual Studio 2013, Visual Studio 2012 e Visual Studio 2010 SP1. |
| Aplicativos do Windows Phone | Projetos para Windows Phone não são suportados no Visual Studio 2022. Para manter aplicativos do Windows Phone 8.x, use o Visual Studio 2015. Para manter projetos do Windows Phone 7.x, use o Visual Studio 2012. |
| Aplicações da Loja Windows | Projetos universais do Windows JavaScript não são suportados no Visual Studio 2022. Para manter esses projetos, use o Visual Studio 2017. Os SDKs do Windows 10 anteriores à Atualização de Criadores de outono do Windows 10 (compilação 16299) foram removidos do instalador do Visual Studio 2019. Você pode baixar os SDKs mais antigos manualmente ou redirecionar seus projetos para usar os SDKs mais recentes. Projetos universais do Windows usando project.json não são suportados. Recomendamos atualizar esses projetos para usar referências de pacote. Como alternativa, adicione uma referência a Microsoft.NET.Test.Sdk versão 16.0.0.0 no arquivo project.json. Projetos para Windows Store 8.1 e 8.0 não são suportados no Visual Studio 2022. Para manter esses aplicativos, continue a usar o Visual Studio 2015. |
| Xamarin | A partir do Visual Studio 2022 17.11, o Xamarin está sem suporte. Em vez disso, os projetos Xamarin devem ser atualizados para a MAUI do .NET. |
Migrar um projeto
Embora tentemos manter a compatibilidade com versões anteriores, pode haver alterações que não são compatíveis com versões anteriores. Quando isso acontece, uma versão mais recente do Visual Studio não carrega o projeto ou oferece um caminho de migração. Talvez seja necessário manter esse projeto em uma versão anterior do Visual Studio. Para obter mais informações sobre os tipos de projeto suportados no Visual Studio 2022, consulte a página Platform Targeting and Compatibility (Segmentação e compatibilidade de plataforma ).
Às vezes, uma versão mais recente do Visual Studio pode abrir um projeto, mas ele deve atualizar ou migrar o projeto de uma forma que pode torná-lo incompatível com versões anteriores. O Visual Studio usa os seguintes critérios para determinar se essa migração é necessária:
Compatibilidade com as versões de destino das plataformas, de volta ao Visual Studio 2013 RTM.
Compatibilidade de ativos de tempo de design com versões anteriores do Visual Studio. (Ou seja, diferentes canais do Visual Studio 2022, Visual Studio 2019, Visual Studio 2017, Visual Studio 2015 RTM & Update 3, Visual Studio 2013 RTM & Update 5, Visual Studio 2012 Update 4 e Visual Studio 2010 SP1.) O Visual Studio 2022 visa falhar graciosamente com ativos de tempo de design preteridos sem corrompê-los, de modo que as versões anteriores ainda possam abrir o projeto.
Se os novos ativos de tempo de design quebrariam a compatibilidade com versões anteriores até o Visual Studio 2013 RTM & Atualização 5.
A equipe de engenharia proprietária do tipo de projeto examina esses critérios e faz a chamada no que diz respeito ao suporte, compatibilidade e migração. Novamente, tentamos manter a compatibilidade entre as versões do Visual Studio para que, quando você cria e modifica projetos em uma versão do Visual Studio, ele funciona apenas em outras versões.
Às vezes, a compatibilidade não é possível. Em seguida, o Visual Studio abre o assistente de atualização para fazer as alterações unidirecionais necessárias. Essas alterações unidirecionais podem envolver a alteração da ToolsVersion propriedade no arquivo de projeto, que indica exatamente qual versão do MSBuild pode transformar o código-fonte do projeto nos artefatos executáveis e implantáveis que você deseja.
O que torna um projeto incompatível com versões anteriores do Visual Studio não é a versão do Visual Studio , mas a versão do MSBuild , conforme determinado pelo ToolsVersion. Se sua versão do Visual Studio contém a cadeia de ferramentas MSBuild que corresponde ao em um projeto, então Visual ToolsVersion Studio pode invocar essa cadeia de ferramentas para criar o projeto.
Para manter a compatibilidade com projetos criados em versões anteriores, o Visual Studio 2022 inclui as cadeias de ferramentas MSBuild necessárias para oferecer suporte ToolsVersion a 15, 14, 12 e 4. Projetos que usam qualquer um desses ToolsVersion valores devem resultar em uma compilação bem-sucedida. (Assunto, novamente, se o Visual Studio 2022 oferece suporte ao tipo de projeto, conforme descrito em Segmentação e compatibilidade de plataforma.)
Você pode ficar tentado a atualizar manualmente ou migrar um projeto para um valor mais recente ToolsVersion . É desnecessário fazer essa alteração, e provavelmente geraria muitos erros e avisos que você deve corrigir para que o projeto seja construído novamente. Além disso, se o Visual Studio não oferecer suporte a um específico ToolsVersion no futuro, o projeto acionará o processo de migração do projeto quando você abri-lo porque seu ToolsVersion valor deve ser alterado.
Projetos pré-MSBuild
Advertência
Projetos .NET anteriores ao MSBuild (ou seja, projetos .NET criados com versões do Visual Studio anteriores ao MSBuild) são conversíveis somente quando você os atualiza com uma versão do Visual Studio até o Visual Studio versão 17.12. Os projetos não serão conversíveis ao usar o Visual Studio versão 17.13 ou posterior. Converta todos esses projetos que você ainda precisa agora com o Visual Studio 17.12 e armazene os resultados convertidos. Os outros formatos de projeto continuarão a ser conversíveis e as versões anteriores do Visual Studio continuarão a converter até mesmo arquivos de projeto pré-MSBuild no futuro. No entanto, ainda é recomendável armazenar os resultados convertidos, como em versões futuras do Visual Studio ou atualizações futuras de versões anteriores do Visual Studio (incluindo 2017 e 2019), restrições adicionais de funcionalidade de atualização podem ser aplicadas.