Escolher uma versão do UWP

Cada versão do Windows 10 e Windows 11 trouxe recursos novos e aprimorados para a plataforma UWP. Ao criar um aplicativo UWP no Microsoft Visual Studio, você pode escolher qual a versão-alvo. Os projetos que usam .NET Standard 2.0 devem ter uma Versão Mínima do Build 16299 ou posterior.

Aviso

Não é possível abrir projetos UWP criados em versões atuais do Visual Studio no Visual Studio 2015.

A tabela a seguir descreve as versões disponíveis do Windows 10 e Windows 11. Observe que esta tabela só se aplica à construção de aplicativos UWP, que têm suporte apenas no Windows 10 e Windows 11. Você não pode desenvolver aplicativos UWP para versões mais antigas do Windows, e precisa instalar o build apropriado do SDK para direcionar a essa versão.

Versão	Descrição
Build 19041 (versão 2004)	Essa é a última versão do Windows 10, lançada em maio de 2020. Os recursos destacados desta versão incluem: * WSL2: o Subsistema do Windows para Linux foi atualizado com um novo modelo de arquitetura e agora executa um kernel real do Linux no Windows. Saiba mais em sobre o WSL2. * MSIX: os novos recursos no Windows fornecem suporte adicional ao formato moderno de empacotamento de aplicativos MSIX, incluindo a capacidade de criar pacotes com serviços incluídos, a criação de aplicativos hospedados e a capacidade de incluir recursos que exigem identificador de pacote em aplicativos não empacotados. Saiba mais nos documentos do MSIX. Para saber mais sobre esses e os muitos outros recursos adicionados a essa versão do Windows, visite o Centro de Desenvolvimento ou a página mais detalhada Novidades no Windows 10 para desenvolvedores
Build 18362 (versão 1903)	Essa versão do Windows 10 foi lançada em abril de 2019. Alguns recursos destacados desta versão incluem: * Ilhas XAML: o Windows 10 agora permite que você use controles UWP em aplicativos de área de trabalho não UWP. Se você estiver desenvolvendo para WPF, Windows Forms ou C++ Win32, confira como você pode adicionar os recursos mais recentes da interface do usuário do Windows 10 ao seu aplicativo existente. * Subsistema do Windows para Linux: agora você pode acessar os arquivos do Linux diretamente de dentro do Windows e usar várias opções de linha de comando novas. Confira as informações mais recentes em sobre WSL. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 18362
Build 17763 (versão 1809)	Esta versão do Windows 10 foi lançada em outubro de 2018. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows. Alguns recursos destacados desta versão incluem: * Windows Machine Learning: o Windows Machine Learning foi oficialmente lançado, oferecendo recursos como avaliação mais rápida e suporte para modelos de machine learning de ponta. Para saber mais sobre a plataforma, confira Windows Machine Learning. * Fluent Design: novos recursos, como a barra de menus, submenu da barra de comandos e animações de propriedade XAML, foram adicionados ao Windows 10. Confira as novidades na Visão geral do design Fluente. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 17763
Build 17134 (versão 1803)	Esta versão do Windows 10 foi lançada em abril de 2018. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows. Alguns recursos destacados desta versão incluem: * Design Fluente: novos recursos, como exibição de árvore, pull para atualização e exibição de navegação, foram adicionados Windows 10. Confira as novidades na Visão geral do design Fluente. * Aplicativos UWP do console: agora você pode escrever apps de console UWP C++ /WinRT ou /CX que são executados em uma janela de console, como a janela de console do DOS ou do PowerShell. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 17134
Build 16299 (Fall Creators Update, versão 1709)	Essa versão do Windows 10 foi lançada em outubro de 2017. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows. Alguns recursos destacados desta versão incluem: * .NET Standard 2.0: aproveite um grande aumento no número de APIs .NET e incorpore seus pacotes NuGet favoritos e bibliotecas de terceiros ao .NET Standard. Veja mais detalhes e explore esta documentação. Observe que você deve definir sua versão mínima como o Build 16299 para acessar essas novas APIs. * Design Fluente: use luz, profundidade, perspectiva e movimento para aprimorar seu app e ajudar os usuários a se concentrarem nos elementos importantes da interface de usuário. * XAML condicional: defina com facilidade propriedades e instancie objetos com base na presença de uma API em tempo de execução, permitindo que seus aplicativos sejam executados perfeitamente em todos os dispositivos e versões. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no Windows 10 para desenvolvedores
Build 15063 (Creators Update, versão 1703)	Esta versão do Windows 10 foi lançada em março de 2017. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows. Alguns recursos destacados desta versão incluem: * Análise do Ink: o Windows Ink agora pode categorizar traços de tinta dentro dos traços de escrita ou desenho, e reconhecer texto, formas e estruturas básicas de layout. * APIs Windows.Ui.Composition: combine e aplique com facilidade animações em seu aplicativo. * Edição ao Vivo: edite XAML enquanto seu aplicativo está em execução, e visualize as mudanças aplicadas em tempo real. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, acesse Novidades no build 15063
Build 14393 (Atualização de Aniversário, versão 1607)	Esta versão do Windows 10 foi lançada em julho de 2016. Alguns recursos destacados desta versão incluem: * Windows Ink: novos controles do New InkCanvas e InkToolbar. * APIs da Cortana: use as novas ações da Cortana para integrar o suporte da Cortana com funções específicas do seu aplicativo. * Windows Hello: o Microsoft Edge agora oferece suporte ao Windows Hello, dando aos desenvolvedores da Web acesso à autenticação biométrica. Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, acesse Novidades no build 14393
Build 10586 (Atualização de novembro, versão 1511)	Esta versão do Windows 10 foi lançada em novembro de 2015. Os recursos destacados incluem a introdução das APIs de ORTC (comunicações em tempo real do objeto) para a comunicação de vídeo no Microsoft Edge e as APIs de provedores para permitir que os aplicativos usem a autenticação de rosto do Windows Hello. Mais informações sobre os recursos introduzidos neste build.
Build 10240 (Windows 10, versão 1507)	Esta é a versão de lançamento inicial do Windows 10, em julho de 2015. Mais informações sobre os recursos introduzidos neste build.

Recomendamos que os novos desenvolvedores e aqueles que escrevem código para o público geral sempre usem o build mais recente do Windows (19041). Os desenvolvedores que criam Aplicativos corporativos devem realmente considerar oferecer suporte a uma Versão mínima mais antiga.

O que está diferente em cada versão do UWP?

APIs novas e alteradas para UWP estão disponíveis em todas as versões sucessivas do Windows 10 e Windows 11. Para obter informações específicas sobre quais recursos foram adicionados a qual versão, consulte Novidades para desenvolvedores no Windows 10/11.

Para tópicos de referência que enumeram todas as famílias de dispositivos e suas versões e todos os contratos de API e suas versões, consulte Famílias de dispositivos e Contratos de API.

Disponibilidade da API do .NET em versões da UWP

A UWP é compatível com um subconjunto limitado de APIs do .NET, as quais estão disponíveis independentemente da Versão de destino ou da Versão mínima do seu projeto. Esta página fornece mais informações sobre os tipos disponíveis.

Se você quiser criar bibliotecas reutilizáveis de plataforma cruzada, o .NET Standard tem suporte na UWP. A documentação do .NET Standard fornece informações sobre qual .NET Standard tem suporte em quais versões da UWP.

Se você estiver desenvolvendo um aplicativo da área de trabalho, confira versões e dependências do .NET Framework para obter informações detalhadas sobre a disponibilidade do .NET framework.

Escolha qual versão deve ser usada para o seu aplicativo

Na caixa de diálogo Novo Projeto Universal do Windows no Visual Studio, você pode escolher uma versão para Versão de destino e para Versão mínima. Além disso, você pode alterar a Versão de Destino e a Versão Mínima do seu aplicativo UWP na seção aplicativo nas Propriedades do aplicativo.

• Versão de destino. A versão do Windows 10 e Windows 11 em que seu aplicativo se destina a ser executado. Isso define a configuração TargetPlatformVersion no seu arquivo de projeto. Também determina o valor do atributo TargetDeviceFamily@MaxVersionTested no manifesto do pacote do app. O valor que você escolher especifica a versão da plataforma UWP a qual seu projeto se destina — e, portanto, o conjunto de APIs disponíveis para seu aplicativo — portanto, recomendamos que você escolha a versão mais recente possível. Para saber mais sobre o manifesto do pacote de aplicativo e algumas diretrizes sobre como configurar a TargetDeviceFamily manualmente, consulte TargetDeviceFamily.
• Versão mínima. A versão mais antiga do Windows 10 ou Windows 11 precisava dar suporte às funções básicas do seu aplicativo. Isso define a configuração TargetPlatformMinVersion no seu arquivo de projeto. Também determina o valor do atributo TargetDeviceFamily@MinVersion no manifesto do pacote do app. O valor que você escolher especifica a versão mínima da plataforma UWP com a qual seu projeto pode trabalhar.

Lembre-se de que você está declarando que seu aplicativo funciona em qualquer versão do Windows no intervalo de Versão mínima até Versão de destino. Se as duas forem da mesma versão, então você não precisará fazer nada especial. Se eles forem diferentes, então aqui estão algumas coisas que devem ser lembradas.

• Em seu código, você pode livremente (ou seja, sem verificações de condição) chamar qualquer API que exista na versão especificada pela Versão mínima.
• Certifique-se de testar seu código em um dispositivo que executa a Versão mínima para ter certeza de que ele funciona sem a necessidade de APIs presentes apenas na Versão de destino.
• O valor de Versão de destino é usado para identificar todas as referências (contrato winmds) usadas para compilar seu projeto. Mas essas referências permitirão que você compile o código com chamadas para APIs que não existem necessariamente em dispositivos para os quais você declarou que oferece suporte (via Versão mínima). Portanto, qualquer API introduzida após a Versão mínima precisará ser chamada por meio do código adaptável. Para saber mais sobre o código adaptável, confira Código adaptável à versão.