Atualizar projetos existentes para uma versão versão diferente do SDK do Aplicativo Windows
Se você criou um projeto com uma versão anterior do SDK do Aplicativo Windows (antigo Project Reunion) ou WinUI 3, pode atualizar o projeto para usar uma versão mais recente. Para saber mais sobre o que está disponível atualmente em cada canal de versão, consulte Canais de versão do SDK do Aplicativo Windows.
Observação
Essas instruções podem ter problemas devido à exclusividade do cenário individual de cada aplicativo. Siga atentamente e, se encontrar um problema, registre um bug no repositório GitHub microsoft-ui-xaml.
Atualização entre versões lançadas após a 1.0
Se o projeto não estiver fazendo referência à versão do pacote NuGet do SDK do Aplicativo Windows que você precisa, você poderá usar o Gerenciador de Pacotes NuGet no Visual Studio para atualizar as referências de pacote NuGet do seu projeto. Por exemplo, se você criar um novo projeto usando uma versão estável do VSIX do SDK do Aplicativo Windows, seu projeto fará referência a uma versão estável do SDK do Aplicativo Windows. Mas você pode facilmente reconfigurar esse projeto para fazer referência, digamos, a uma versão experimental do SDK do Aplicativo Windows. Ou reconfigure-o para fazer referência à versão estável mais recente.
Para ver as etapas, consulte as instruções em Usar o SDK do Aplicativo Windows em um projeto.
Atualizar da versão 0.8 para a versão 1.0
Se você criou um projeto usando a versão 0.8 (por exemplo, versão 0.8.4), pode seguir estas instruções para atualizar o projeto para a versão 1.0.
Pré-requisito: Baixe e instale a versão experimental mais recente do SDK do Aplicativo Windows. Para obter mais informações, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Instruções
No arquivo
.wapproj
, se TargetPlatformMinVersion for anterior a10.0.17763.0
, altere para10.0.17763.0
.No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes. Esse processo consiste em desinstalar referências de pacote existentes do Project Reunion dos arquivos
.csproj
/.vcxproj
e.wapproj
e instalar as referências de pacoteWindowsAppSDK
nesses arquivos.Digite os seguintes comandos para desinstalar pacotes
ProjectReunion
existentes do.csproj
/.vcxproj
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
Em seguida, execute o seguinte para desinstalar pacotes
ProjectReunion
existentes do.wapproj
:uninstall-package Microsoft.ProjectReunion uninstall-package Microsoft.ProjectReunion.WinUI
Agora execute os comandos para instalar o pacote
WindowsAppSDK
estável.Para adicionar a referência de pacote
WindowsAppSDK
ao.csproj
/.vcxproj
:install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0
Para adicionar a referência de pacote
WindowsAppSDK
ao.wapproj
:install-package Microsoft.WindowsAppSDK -Version 1.0.0
Atualização da versão 0.8 ou 0.8 Preview para 1.0 Experimental ou Preview 3
Importante
As versões 1.0 Preview 1 e Preview 2 contêm um bug crítico. Se você já tiver instalado uma dessas pré-visualizações, consulte Problema importante que afeta o 1.0 Preview 1 e o Preview 2. Recomendamos usar a versão 1.0 Preview 3 (1.0.0-preview3)..
Se você criou um projeto usando a versão 0.8 Preview ou qualquer versão da 0.8 (por exemplo, versão 0.8.1), pode seguir estas instruções para atualizar o projeto para a versão 1.0 Preview 3 ou Experimental.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
- No arquivo .wapproj, se sua TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Insira os seguintes comandos para o 1.0 Preview 3:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.WindowsAppSDK -Version 1.0.0-preview3 -ProjectName {yourProjectName}
Ou os seguintes comandos para 1.0 Experimental:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.WindowsAppSDK -Version 1.0.0-experimental1 -ProjectName {yourProjectName}
Faça as seguintes alterações no (pacote).wapproj do aplicativo:
Remova o grupo de itens (se você estiver atualizando de uma versão diferente da 0.8.0, verá o número de versão correspondente referenciado neste grupo de itens):
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Adicione este grupo de itens em substituição pelo 1.0 Preview 3:
<ItemGroup> <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-preview3]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Ou este grupo de itens em substituição pelo 1.0 Experimental:
<ItemGroup> <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-experimental1]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="[1.0.0-experimental1]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Faça as seguintes alterações no arquivo de projeto (.csproj ou .vcproj):
Remova o grupo de itens (se você estiver atualizando de uma versão diferente da 0.8.0, verá o número de versão correspondente referenciado neste grupo de itens):
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0" /> <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0" /> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
Adicione este grupo de itens em substituição pelo 1.0 Preview 3:
<ItemGroup> <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-preview3" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
Ou este grupo de itens em substituição pelo 1.0 Experimental:
<ItemGroup> <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-experimental1" /> <PackageReference Include="Microsoft.WindowsAppSDK.Foundation" Version="1.0.0-experimental1" /> <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="1.0.0-experimental1" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
Se não for possível compilar a solução, limpe a saída da compilação, reinicie o Visual Studio e tente executar novamente o aplicativo.
Atualização do 0.8 Preview para o 0.8 ou entre versões estáveis 0.8
Se você criou um projeto usando a versão 0.8 Preview, pode seguir estas instruções para atualizar seu projeto para uma versão estável da 0.8. Estas instruções também serão pertinentes se você tiver criado um projeto com uma versão estável anterior à 0.8 (por exemplo, 0.8.0) e quiser atualizar seu projeto para uma versão estável mais recente (por exemplo, 0.8.2).
Observação
Você poderá atualizar automaticamente o projeto por meio do Gerenciador de Extensões do Visual Studio, sem passar pelas etapas manuais abaixo. No Visual Studio 2019, clique em Extensões>Gerenciar Extensões e selecione Atualizações na barra de menus à esquerda. Selecione "Project Reunion" na lista e clique em Atualizar.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
- No arquivo .wapproj, se sua TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Digite os seguintes comandos:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.ProjectReunion -Version 0.8.2 -ProjectName {yourProjectName}
Faça as seguintes alterações no (pacote).wapproj do aplicativo:
Remova o grupo de itens (se você estiver atualizando de uma versão diferente da 0.8 Preview, verá o número de versão correspondente referenciado neste grupo de itens):
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Adicione este grupo de itens como substituição:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.2]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.2]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Faça as seguintes alterações no arquivo de projeto (.csproj ou .vcproj):
- Remova o grupo de itens (se você estiver atualizando de uma versão diferente da 0.8 Preview, verá o número de versão correspondente referenciado neste grupo de itens):
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" /> <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" /> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
- Adicione este grupo de itens como substituição:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.2" /> <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.2" /> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.2" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
- Remova o grupo de itens (se você estiver atualizando de uma versão diferente da 0.8 Preview, verá o número de versão correspondente referenciado neste grupo de itens):
Se não for possível compilar a solução, limpe a saída da compilação, reinicie o Visual Studio e tente executar novamente o aplicativo.
Atualizar da versão 0.5 para a versão 0.8
Se você criou um projeto usando a versão 0.5 Stable, pode seguir estas instruções para atualizar seu projeto para uma versão 0.8 Stable.
Observação
Você poderá atualizar automaticamente o projeto por meio do Gerenciador de Extensões do Visual Studio, sem passar pelas etapas manuais abaixo. No Visual Studio 2019, clique em Extensões>Gerenciar Extensões e selecione Atualizações na barra de menus à esquerda. Selecione "Project Reunion" na lista e clique em Atualizar.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
- No arquivo .wapproj, se sua TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Digite os seguintes comandos:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.ProjectReunion -Version 0.8.0 -ProjectName {yourProjectName}
Adicione a seguinte linha ao arquivo de projeto (.csproj ou .vcproj), dentro do primeiro
<PropertyGroup>
:<UseWinUI>true</UseWinUI>
Faça as seguintes alterações no (pacote).wapproj do aplicativo:
Adicione esta seção:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Localize a seguinte linha:
<AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
Mova essa linha e coloque-a em uma nova linha diretamente abaixo da marca
<TargetPlatformVersion>
.Remova este grupo de itens (se você estiver atualizando de uma versão anterior à 0.5.7, verá um número de versão anterior referenciado neste grupo de itens):
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.7]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Se não for possível compilar a solução, limpe a saída da compilação, reinicie o Visual Studio e tente executar novamente o aplicativo.
Atualização da 0.5 Preview para a 0.8 Preview
Se você criou um projeto usando a versão 0.5 Preview, pode seguir estas instruções para atualizar seu projeto para usar a versão 0.8 Preview.
Observação
Você poderá atualizar automaticamente o projeto por meio do Gerenciador de Extensões do Visual Studio, sem passar pelas etapas manuais abaixo. No Visual Studio 2019, clique em Extensões>Gerenciar Extensões e selecione Atualizações na barra de menus à esquerda. Selecione "Project Reunion" na lista e clique em Atualizar.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
No arquivo .wapproj, se sua TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Os modelos de projeto padrão para aplicativos C++ e C# incluíam as linhas a seguir. O evento
Application.Suspending
não é mais chamado para aplicativos de área de trabalho, portanto, certifique-se de remover estas linhas (e quaisquer outros usos desse evento) se elas ainda estiverem presentes em seu código:this.Suspending += OnSuspending;
Suspending({ this, &App::OnSuspending });
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Digite os seguintes comandos:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.ProjectReunion -Version 0.8.0-preview -ProjectName {yourProjectName}
Faça as seguintes alterações no (pacote).wapproj do aplicativo:
Adicione esta seção:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]"> <IncludeAssets>build</IncludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Adicione a seguinte linha a uma nova linha diretamente abaixo da marca
<TargetPlatformVersion>
.<AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
Remova esta linha:
<AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
E estas linhas:
<Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" /> <Import Project="$(Microsoft_WinUI_AppX_targets)" />
E este grupo de itens:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]" GeneratePathProperty="true"> <ExcludeAssets>all</ExcludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0]" GeneratePathProperty="true"> <ExcludeAssets>all</ExcludeAssets> </PackageReference> </ItemGroup>
Faça as seguintes alterações no arquivo de projeto (.csproj ou .vcproj):
Remova este grupo de itens:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="0.5.0-prerelease" /> <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.5.0-prerelease" /> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.5.0-prerelease" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
Adicione este grupo de itens:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" /> <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" /> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" /> <Manifest Include="$(ApplicationManifest)" /> </ItemGroup>
Se não for possível compilar a solução, limpe a saída da compilação, reinicie o Visual Studio e tente executar novamente o aplicativo.
Atualização da 0.5 Preview para a versão 0.5
Se você criou um projeto usando a versão 0.5 Preview, pode seguir estas instruções para atualizar seu projeto para a versão estável da 0.5.7.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
[Somente aplicativos de área de trabalho] No arquivo .wapproj, se TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Os modelos de projeto padrão para aplicativos C++ e C# incluíam as linhas a seguir. O evento
Application.Suspending
não é mais chamado para aplicativos de área de trabalho, portanto, certifique-se de remover estas linhas (e quaisquer outros usos desse evento) se elas ainda estiverem presentes em seu código:this.Suspending += OnSuspending;
Suspending({ this, &App::OnSuspending });
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Digite os seguintes comandos:
uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject} uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject} install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}
Se você tiver um aplicativo UWP, o processo de atualização deverá ser concluído nesse estágio. Se você tiver um aplicativo de área de trabalho, faça as seguintes alterações em seu Aplicativo (pacote).wapproj:
Adicione esta seção:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Localize a marca
<TargetPlatformVersion>
e adicione o seguinte em uma nova linha diretamente abaixo da marca<AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
Remova esta linha:
<AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
E estas linhas:
<Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" /> <Import Project="$(Microsoft_WinUI_AppX_targets)" />
E este grupo de itens:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true"> <ExcludeAssets>all</ExcludeAssets> </PackageReference> <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true"> <ExcludeAssets>all</ExcludeAssets> </PackageReference> </ItemGroup>
Atualização do WinUI 3 Preview 4 para a versão 0.5
Se você criou um aplicativo de área de trabalho usando o WinUI 3 Preview 4, pode seguir estas instruções para atualizar o projeto para o Project Reunion 0.5.
Antes de começar, verifique se você tem todos os pré-requisitos do SDK do Aplicativo Windows instalados, incluindo o pacote VSIX e NuGet mais recente. Para obter mais detalhes, confira Instalar ferramentas para o SDK do Aplicativo Windows.
Primeiro, faça o seguinte:
No arquivo .wapproj, se sua TargetPlatformMinVersion for anterior a 10.0.17763.0, altere-a para 10.0.17763.0.
Os modelos de projeto padrão para aplicativos C++ e C# incluíam as linhas a seguir. O evento
Application.Suspending
não é mais chamado para aplicativos de área de trabalho, portanto, certifique-se de remover estas linhas (e quaisquer outros usos desse evento) se elas ainda estiverem presentes em seu código:this.Suspending += OnSuspending;
Suspending({ this, &App::OnSuspending });
Em seguida, faça estas alterações no projeto:
No Visual Studio, acesse Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes.
Digite os seguintes comandos:
uninstall-package Microsoft.WinUI -ProjectName {yourProject} install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}
Faça as seguintes alterações no (pacote).wapproj do aplicativo:
Adicione esta seção:
<ItemGroup> <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]"> <IncludeAssets>build</IncludeAssets> </PackageReference> </ItemGroup>
Remova as seguintes linhas:
<AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
<Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />
Exclua o arquivo
Microsoft.WinUI.AppX.targets
existente na pasta {SeuProjeto}(pacote)/build/ do projeto.
Windows developer