Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Porta do Visual Studio 2019, migre e atualize projetosImportante
Esta não é a versão mais recente do Visual Studio. Para baixar a versão mais recente, visite https://visualstudio.microsoft.com/downloads/ e consulte as notas de versão do Visual Studio 2022.
Cada nova versão do Visual Studio dá 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.
Dica
Se você estiver procurando informações específicas para a próxima versão, consulte a versão do Visual Studio 2022 desta página.
Tentamos preservar a compatibilidade com versões anteriores, como 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 dar 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 ao projeto no Visual Studio 2019, consulte a página Direcionamento e Compatibilidade da Plataforma .
Tipos de projeto
A lista a seguir descreve o suporte no Visual Studio 2019 para projetos criados em versões anteriores.
Se você não vir um projeto ou tipo de arquivo mencionado aqui, consulte a versão do Visual Studio 2017 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 do .NET Core (xproj) | Projetos criados com o Visual Studio 2015 usaram ferramentas de visualização que incluíam um arquivo de projeto xproj. Visual Studio 2017: O formato xproj não tem suporte além da 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.) Não há suporte para projetos csproj no estilo SDK no Visual Studio 2015 e anteriores. Visual Studio 2019: Na versão 16.3 e posterior, você não pode carregar ou migrar projetos xproj. Para obter mais informações, consulte Migrando projetos do .NET Core para o formato csproj. |
| ASP.NET Aplicativo Web Principal e aplicativo Web ASP.NET Core com o Application Insights habilitado | Para cada usuário do Visual Studio, as informações do recurso são armazenadas no registro por instância do 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 de registro diferente do Visual Studio 2017 e do Visual Studio 2019 e não entra em conflito. Depois que um usuário cria um aplicativo Web ASP.NET, ASP.NET Aplicativo Web Core ou ASP.NET Aplicativo Web Core, o recurso é armazenado no arquivo .suo. O usuário pode abrir o projeto no Visual Studio 2015, Visual Studio 2017 ou Visual Studio 2019, e as informações de recurso são usadas para cada um, desde que o Visual Studio dê suporte a projetos e soluções que estão sendo usadas 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 2019, o usuário precisará se autenticar no Visual Studio 2019. |
| C#/Visual Basic Webform ou Windows Form | Você pode abrir o projeto no Visual Studio 2019, Visual Studio 2017 e Visual Studio 2015. |
| Teste de interface do usuário codificado | O teste de interface do usuário codificado para testes funcionais automatizados controlados por interface do usuário foi preterido no Visual Studio 2019. O Visual Studio 2019 será a última versão do teste de interface do usuário codificado. É recomendável usar o Selenium para testar aplicativos Web e Appium com o WinAppDriver para testar aplicativos de área de trabalho e UWP. |
| Projetos de teste de unidade de banco de dados (csproj, .vbproj) | Projetos de teste mais antigos da Unidade de Dados 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 das principais diferenças dos modelos mais antigos do Visual Studio para novos projetos é que a versão do FSharp.Core agora é sempre um pacote NuGet. O F# é instalado por padrão com qualquer Carga de Trabalho do .NET. |
| InstallShield Configuração do MSI |
Os projetos do instalador criados no Visual Studio 2010 podem ser abertos em versões posteriores com a ajuda da extensão Projetos do Instalador do Visual Studio. Consulte também a Extensão do Visual Studio 2017 do Conjunto de Ferramentas do WiX. InstallShield Limited Edition não está mais incluído no Visual Studio. Verifique com o Revenera sobre a disponibilidade do Visual Studio 2019. |
| LightSwitch | O LightSwitch não tem mais suporte no Visual Studio 2022, Visual Studio 2019 ou Visual Studio 2017. Projetos criados com o Visual Studio 2012 e abertos anteriormente no Visual Studio 2013 ou no Visual Studio 2015 são atualizados e só podem ser abertos no Visual Studio 2013 ou no Visual Studio 2015 posteriormente. |
| Teste de carga | Os recursos de teste de carga e desempenho da Web são preteridos no Visual Studio 2019 e posterior. 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 e Blazemeter. |
| Ferramentas do Microsoft Azure para Visual Studio | Para abrir esses tipos de projetos, primeiro instale o SDK do Azure para .NET e abra o projeto. Se necessário, seu projeto será atualizado. |
| Microsoft Test Manager | O Gerenciador de Testes da Microsoft e o Cliente de Comentários não estão mais sendo enviados no Visual Studio, começando pelo Visual Studio 2019. Aproveite os Planos de Teste do Azure (parte do Azure DevOps) para suas necessidades manuais e exploratórias de teste. |
| Estrutura model-View-Controller (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 foi alterado 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:
|
| Instalação da MSI (vdproj) | Consulte a seção InstallShield desta página. |
| Office 2007 VSTO | Requer uma atualização unidirecional para o Visual Studio 2019. |
| Office 2010 VSTO | Se o projeto for direcionado ao .NET Framework 4, você poderá abri-lo no Visual Studio 2010 SP1 e posterior. Todos os outros projetos exigem uma atualização unidirecional. |
| PcL (Biblioteca de Classes Portátil) | Bibliotecas de classes portáteis (ou PCLs) agora não têm suporte. O Visual Studio 2019 ainda abrirá e os criará, mas não é possível criar novos projetos de PCL. Recomendamos migrar 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 do Python | O suporte para aplicativos do Windows IoT Core do Python foi removido no Visual Studio 2019. Como não há equivalente no Visual Studio 2019, não há nenhum caminho de migração automática para esses projetos. Você pode continuar usando o Visual Studio 2017. |
| Ferramentas do R para Visual Studio | As Ferramentas do R para Visual Studio foram removidas da Carga de Trabalho de Ciência de Dados no Visual Studio 2019. Você pode continuar usando o Visual Studio 2017 ou alternativas como o RStudio. |
| Service Fabric (sfproj) | Os projetos de Aplicativo do Service Fabric podem ser abertos no Visual Studio 2015, Visual Studio 2017 e Visual Studio 2019, a menos que o projeto de Aplicativo do Service Fabric faça referência a um projeto de serviço do ASP.NET Core. Os projetos do Service Fabric do Visual Studio 2015 abertos no Visual Studio 2017 ou no Visual Studio 2019 são migrados de maneira unidirecional do formato xproj para o csproj. Consulte "Projetos do .NET Core (xproj)" anteriormente nesta tabela. |
| SharePoint 2010 | Quando um projeto de solução do SharePoint é aberto com o Visual Studio 2019, ele é atualizado para o SharePoint 2013 ou SharePoint 2016. A carga de trabalho "Desenvolvimento da Área de Trabalho do .NET" deve ser instalada no Visual Studio 2019 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 de Add-In do SharePoint criados no Office Developer Tools Preview 2 não podem ser abertos no Visual Studio 2019. Para contornar essa limitação, atualize para MinimumVisualStudioVersion 12.0 e MinimumOfficeToolsVersion para 12.2 no arquivo csproj vbproj. |
| Silverlight | Não há suporte para projetos silverlight no Visual Studio 2019. Para manter os aplicativos Silverlight, continue a usar o Visual Studio 2015. |
| SQL – Redgate | O Núcleo de Automação de Alterações sql do Redgate (anteriormente chamado de ReadyRoll Core), o SQL Prompt Core e o SQL Search não estão mais sendo 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 de Automação de Alterações sql e prompt de SQL que estão disponíveis no Rótulo de Ferramentas SQL do 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 ao 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 . |
| O SQL Server Integration Services (SSIS) | O suporte para o Visual Studio 2019 está disponível. Para obter mais informações, consulte a página Baixar e instalar o SSDT (SQL Server Data Tools) para Visual Studio , o blog da equipe do SSIS (SQL Server Integration Services) e a página projetos do SQL Server Integration Services no Marketplace. |
| Extensão da Janela de Teste | No Visual Studio 2019, algumas APIs de janela de teste que foram previamente 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. Para nosso conhecimento, poucas extensões assumiram uma dependência dessas APIs. Para obter mais informações e atualizações, exiba 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. |
| Visual C++ | Você pode usar o Visual Studio 2019 para trabalhar em projetos que foram criados em versões anteriores do Visual Studio de volta ao Visual Studio 2010. Ao abrir o projeto pela primeira vez, você tem a opção de atualizar para o compilador e o conjunto de ferramentas mais recentes ou continuar usando os originais. Se você optar por continuar usando os originais, o Visual Studio 2019 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 a multiplataforma nativa no Visual Studio para compilar 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). Veja também como migrar projetos de extensibilidade para o Visual Studio 2017. |
| Lab Management do Visual Studio | Você pode usar o Microsoft Test Manager ou o Visual Studio 2010 SP1 e posterior para abrir ambientes criados em qualquer uma dessas versões. No entanto, para o Visual Studio 2010 SP1, a versão do Microsoft Test Manager deve corresponder à versão do Team Foundation Server antes que você possa criar ambientes. (Importante: o Team Foundation Server, ou TFS, agora é conhecido como Servidor de DevOps do Azure.) |
| Ferramentas do Visual Studio para Apache Cordova | O suporte para o Apache Cordova foi removido no Visual Studio 2019. Como não há equivalente no Visual Studio 2019, não há nenhum caminho de migração automática para esses projetos. Você pode usar a extensão Ferramentas do Cordova para Visual Studio Code (que fornece suporte para a última versão 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 2019, não há nenhum 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 as personalizações no arquivo pubxml (perfil de publicação), conforme descrito no StackOverflow. |
| Windows Communication Foundation, Windows Workflow Foundation | Você pode abrir este projeto no Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 e Visual Studio 2012. |
| Windows Presentation Foundation | Você pode abrir esse projeto no Visual Studio 2019, Visual Studio 2017, Visual Studio 2013, Visual Studio 2012 e Visual Studio 2010 SP1. |
| Aplicativos do Windows Phone | Não há suporte para projetos para Windows Phone no Visual Studio 2019. Para manter os aplicativos do Windows Phone 8.x, use o Visual Studio 2015. Para manter projetos do Windows Phone 7.x, use o Visual Studio 2012. |
| Aplicativos da Windows Store | Não há suporte para Projetos Universais do Windows do JavaScript no Visual Studio 2019. Para manter esses projetos, use o Visual Studio 2017. Os SDKs do Windows 10 antes do Windows 10 Fall Creators Update (build 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. Não há suporte para projetos universais do Windows usando project.json. Recomendamos atualizar esses projetos para usar referências de pacote. Como alternativa, adicione uma referência ao Microsoft.NET.Test.Sdk versão 16.0.0.0 no arquivo project.json. Não há suporte para projetos para Windows Store 8.1 e 8.0 no Visual Studio 2019. Para manter esses aplicativos, continue usando o Visual Studio 2015. |
| Xamarin | A extensão do Xamarin Live Player para Visual Studio e Visual Studio para Mac foi removida. Isso remove a tela de emparelhamento e qualquer integração. Em vez disso, use o visualizador interno do Xamarin.Forms. O Emulador do Visual Studio para Android foi removido do Instalador do Visual Studio. Em vez disso, utilize o novo suporte Hyper-V no emulador Android do Google. |
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. (Consulte Direcionamento e Compatibilidade da Plataforma para os quais os tipos de projeto têm suporte no Visual Studio 2019.) Quando isso acontecer, uma versão mais recente do Visual Studio não carregará o projeto nem oferecerá um caminho de migração. Talvez seja necessário manter esse projeto em uma versão anterior do Visual Studio.
Às vezes, a versão mais recente do Visual Studio pode abrir um projeto, mas deve atualizar ou migrar o projeto de uma maneira que possa renderizá-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 em tempo de design com versões anteriores do Visual Studio. (Ou seja, canais diferentes do Visual Studio 2019, Visual Studio 2017; Visual Studio 2015 RTM & Atualização 3; Visual Studio 2013 RTM & Atualização 5; Visual Studio 2012 Atualização 4; Visual Studio 2010 SP 1.) O Visual Studio 2019 visa lidar graciosamente com falhas em recursos preteridos de tempo de design sem corrompê-los, de modo que as versões anteriores ainda possam abrir o projeto.
Se novos ativos de tempo de design quebrariam a compatibilidade com versões anteriores para o Visual Studio 2013 RTM &Atualização 5.
A equipe de engenharia que possui o tipo de projeto analisa esses critérios e faz a chamada em que há 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 só funciona 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 desejados.
O que renderiza 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 por ToolsVersion. Se sua versão do Visual Studio contiver a cadeia de ferramentas do MSBuild que corresponde à ToolsVersion de um projeto, o Visual Studio poderá invocar essa cadeia de ferramentas para criar o projeto.
Para manter a compatibilidade com projetos criados em versões anteriores, o Visual Studio 2019 inclui as cadeias de ferramentas necessárias do MSBuild para dar suporte ToolsVersion a 15, 14, 12 e 4. Os projetos que usam qualquer um desses ToolsVersion valores devem resultar em uma compilação bem-sucedida. (Assunto, novamente, se o Visual Studio 2019 dá suporte ao tipo de projeto, conforme descrito em Direcionamento e Compatibilidade da Plataforma.)
Você pode ser tentado a atualizar ou migrar manualmente um projeto para um valor mais recente ToolsVersion . É desnecessário fazer essa alteração e provavelmente gerará muitos erros e avisos que você deve corrigir para que o projeto seja compilado novamente. Além disso, se o Visual Studio não der suporte a um específico ToolsVersion no futuro, o projeto disparará o processo de migração do projeto quando você abri-lo porque seu ToolsVersion valor deve ser alterado.
Próximas etapas
Consulte os seguintes artigos para mais discussões: