Escolher uma versão do UWPChoose a UWP version

Cada versão do Windows 10 trouxe recursos novos e aprimorados para a plataforma UWP.Each version of Windows 10 has brought new and improved features to the UWP platform. Ao criar um aplicativo UWP no Microsoft Visual Studio, você pode escolher qual a versão-alvo.When creating a UWP app in Microsoft Visual Studio, you can choose which version to target. Os projetos que usam .NET Standard 2.0 devem ter uma Versão Mínima do Build 16299 ou posterior.Projects using .NET Standard 2.0 must have a Minimum Version of Build 16299 or later.

Aviso

Não é possível abrir projetos UWP criados em versões atuais do Visual Studio no Visual Studio 2015.UWP projects created in current versions of Visual Studio cannot be opened in Visual Studio 2015.

A tabela a seguir descreve as versões disponíveis do Windows 10.The following table describes the available versions of Windows 10. Observe que esta tabela só se aplica à construção de aplicativos UWP, que têm suporte apenas no Windows 10.Please note that this table only applies for building UWP apps, which are only supported on Windows 10. 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.You cannot develop UWP apps for older versions of Windows, and you must have installed the appropriate build of the SDK in order to target that version.

VersãoVersion DescriçãoDescription
Build 19041 (versão 2004)Build 19041 (version 2004) Essa é a última versão do Windows 10, lançada em maio de 2020.This is the latest version of Windows 10, released in May 2020. Os recursos de destaque dessa versão incluem:Highlighted features of this release include:
* 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.* WSL2: Windows Subsystem for Linux has been updated with a new architectural model, and now runs an actual Linux kernal on Windows. Saiba mais em sobre o WSL2.Learn more at about 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.* MSIX: New features within Windows provide further support for the modern MSIX app packaging format, including the ability to create packages with included services, creation of hosted apps, and the ability to include features that require package identity in non-packaged apps. Saiba mais nos documentos do MSIX.Learn more in the MSIX docs.
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 desenvolvedoresFor more information on these and the many other features added in this release of Windows, visit the Dev Center or the more in-depth page on What's new in Windows 10 for developers
Build 18362 (versão 1903)Build 18362 (version 1903) Essa versão do Windows 10 foi lançada em abril de 2019.This version of Windows 10 was released in April 2019. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* Ilhas XAML: Agora, o Windows 10 permite que você use controles de UWP em aplicativos da área de trabalho que não são UWP.* XAML Islands: Windows 10 now enables you to use UWP controls in non-UWP desktop applications. 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.If you’re developing for WPF, Windows Forms, or C++ Win32, check out how you can add the latest Windows 10 UI features to your existing app.
* 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.* Windows Subsystem for Linux: You can now access Linux files directly from within Windows, and use several new command line options. Confira as informações mais recentes em sobre WSL.See the latest at about WSL.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 18362For information on these and many other features added in this release of Windows, visit What's new in build 18362
Build 17763 (versão 1809)Build 17763 (version 1809) Esta versão do Windows 10 foi lançada em outubro de 2018.This version of Windows 10 was released in October 2018. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* 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.* Windows Machine Learning: Windows Machine Learning has now officially launched, providing features like faster evaluation and support for cutting-edge machine learning models. Para saber mais sobre a plataforma, confira Windows Machine Learning.To learn more about the platform, see Windows Machine Learning.
* Design Fluente: Novos recursos, como a barra de menus, submenu da barra de comandos e animações de propriedade XAML, foram adicionados ao Windows 10.* Fluent Design: New features such as menu bar, command bar flyout, and XAML property animations have been added to Windows 10. Confira as novidades na Visão geral do design Fluente.See the latest at the Fluent design overview.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 17763For information on these and many other features added in this release of Windows, visit What's new in build 17763
Build 17134 (versão 1803)Build 17134 (version 1803) Esta versão do Windows 10 foi lançada em abril de 2018.This is version of Windows 10 was released in April 2018. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* Design Fluente: Novos recursos, como o modo de exibição em árvore, deslizar para atualizar e modo de exibição de navegação, foram adicionados ao Windows 10.* Fluent Design: New features such as tree view, pull-to-refresh, and navigation view have been added to Windows 10. Confira as novidades na Visão geral do design Fluente.See the latest at the Fluent design overview.
* Aplicativos UWP de console: Agora, você pode escrever aplicativos 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.* Console UWP apps: You can now write C++ /WinRT or /CX UWP console apps that run in a console window such as a DOS or PowerShell console window.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 17134For information on these and many other features added in this release of windows, visit What's new in build 17134
Build 16299 (Fall Creators Update, versão 1709)Build 16299 (Fall Creators Update, version 1709) Esta versão do Windows 10 foi lançada em outubro de 2017.This verion of Windows 10 was released in October 2017. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* .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.* .NET Standard 2.0: Enjoy a massive increase in the number of .NET APIs and incorporate your favorite NuGet packages and third party libraries into .NET Standard. Veja mais detalhes e explore esta documentação.See more details and explore the documentation here. Observe que você deve definir sua versão mínima como o Build 16299 para acessar essas novas APIs.Please note that you must set your minimum version to Build 16299 to access these new APIs.
* Design Fluente: Use luz, profundidade, perspectiva e movimento para aprimorar seu aplicativo e ajudar os usuários a se concentrarem nos elementos importantes da interface do usuário.* Fluent Design: Use light, depth, perspective, and movement to enhance your app and help users focus on important UI elements.
* XAML condicional: Defina facilmente as propriedades e instancie objetos com base na presença de uma API em runtime, permitindo que seus aplicativos sejam executados perfeitamente em todos os dispositivos e versões.* Conditional XAML: Easily set properties and instantiate objects based on the presence of an API at runtime, enabling your apps to run seamlessly across devices and versions.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no Windows 10 para desenvolvedoresFor information on these and many other features added in this release of windows, visit What's new in Windows 10 for developers
Build 15063 (Creators Update, versão 1703)Build 15063 (Creators Update, version 1703) Esta versão do Windows 10 foi lançada em março de 2017.This version of Windows 10 was released in March 2017. Observe que você precisa usar o Visual Studio 2017 ou o Visual Studio 2019 para ter como destino essa versão do Windows.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* Análise do Ink: Agora, o Windows Ink pode categorizar traços de tinta dentro de traços de escrita ou desenho, e reconhecer texto, formas e estruturas básicas de layout.* Ink Analysis: Windows Ink can now categorize ink strokes into either writing or drawing strokes, and recognized text, shapes, and basid layout structures.
* APIs do Windows.Ui.Composition: Combine e aplique facilmente animações em seu aplicativo.* Windows.Ui.Composition APIs: Easily combine and apply animations across your app.
* Edição em tempo real: Edite XAML enquanto seu aplicativo está em execução, e visualize as mudanças aplicadas em tempo real.* Live Editing: Edit XAML while your app is running, and see the changes applied in real-time.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 15063For information on these and many other features added in this release of windows, visit What's new in build 15063
Build 14393 (Atualização de Aniversário, versão 1607)Build 14393 (Anniversary Update, version 1607) Esta versão do Windows 10 foi lançada em julho de 2016.This version of Windows 10 was released in July 2016. Alguns recursos destacados desta versão incluem:Some highlighted features from this release include:
* Windows Ink: Novos controles InkCanvas e InkToolbar.* Windows Ink: New InkCanvas and InkToolbar controls.
* APIs da Cortana: Use as novas Ações da Cortana para integrar o suporte à Cortana a funções específicas do seu aplicativo.* Cortana APIs: Use new Cortana Actions to integrate Cortana support with specific functions of your app.
* Windows Hello: Agora, o Microsoft Edge oferece suporte ao Windows Hello, dando aos desenvolvedores da Web acesso à autenticação biométrica.* Windows Hello: Microsoft Edge now supports Windows Hello, giving web developers access to biometric authentication.
Para saber mais sobre esses e muitos outros recursos adicionados a essa versão do Windows, visite Novidades no build 14393For information on these and many other features added in this release of windows, visit What's new in build 14393
Build 10586 (Atualização de novembro, versão 1511)Build 10586 (November Update, version 1511) Esta versão do Windows 10 foi lançada em novembro de 2015.This version of Windows 10 was released in November 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.Highlighted features include the introduction of ORTC (object real-time communications) APIs for video communication in Microsoft Edge and Providers APIs to enable apps to use Windows Hello face authentication. Mais informações sobre os recursos introduzidos neste build.More information on features introduced in this build.
Build 10240 (Windows 10, versão 1507)Build 10240 (Windows 10, version 1507) Esta é a versão de lançamento inicial do Windows 10, em julho de 2015.This is the initial release version of Windows 10, from July 2015. Mais informações sobre os recursos introduzidos neste build.More information on features introduced in this 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).We highly recommend that new developers and developers writing code for a general audience always use the latest build of Windows (19041). Os desenvolvedores que criam Aplicativos corporativos devem realmente considerar oferecer suporte a uma Versão mínima mais antiga.Developers writing Enterprise apps should strongly consider supporting an older Minimum Version.

O que está diferente em cada versão do UWP?What's different in each UWP version?

APIs novas e alteradas para UWP estão disponíveis em todas as versões sucessivas do Windows 10.New and changed APIs for UWP are available in every successive version of Windows 10. Para obter informações específicas sobre quais recursos foram adicionados a qual versão, consulte Novidades para desenvolvedores no Windows 10.For specific information about what features were added in which version, see What's new for developers in Windows 10.

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.For reference topics that enumerate all device families and their versions, and all API contracts and their versions, see Device families and API contracts.

Disponibilidade da API do .NET em versões da UWP.NET API availability in UWP versions

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.UWP supports a limited subset of .NET APIs, which are available regardless of the Target Version or Minimum Version of your project. Esta página fornece mais informações sobre os tipos disponíveis.This page provides more information on the types available.

Se você quiser criar bibliotecas reutilizáveis de plataforma cruzada, o .NET Standard tem suporte na UWP.If you wish to create reusable cross-platform libraries, .NET Standard is supported on UWP. A documentação do .NET Standard fornece informações sobre qual .NET Standard tem suporte em quais versões da UWP.The .NET Standard documentation provides information on which .NET Standard is supported in which UWP versions.

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.If you are developing a Desktop app, see instead .NET Framework versions and dependencies for detailed information on .NET framework availability.

Escolha qual versão deve ser usada para o seu aplicativoChoose which version to use for your app

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.In the New Universal Windows Project dialog in Visual Studio, you can choose a version for Target Version and for Minimum Version. 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.Additionally, you can change the Target Version and Minimum Version of your UWP app in the application section of the app's Properties.

  • Versão de destino.Target Version. A versão do Windows 10 em que seu aplicativo se destina a ser executado.The version of Windows 10 that your app is intended to run on. Isso define a configuração TargetPlatformVersion no seu arquivo de projeto.This sets the TargetPlatformVersion setting in your project file. Também determina o valor do atributo *TargetDeviceFamily@MaxVersionTested* no manifesto do pacote do aplicativo.It also determines the value of the *TargetDeviceFamily@MaxVersionTested* attribute in your app package manifest. 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.The value you choose specifies the version of the UWP platform that your project is targeting—and therefore the set of APIs available to your app—so we recommend that you choose the most recent version possible. Para saber mais sobre o manifesto do pacote de aplicativo e algumas diretrizes sobre como configurar a TargetDeviceFamily manualmente, consulte TargetDeviceFamily.For more info about your app package manifest, and some guidelines around configuring TargetDeviceFamily manually, see TargetDeviceFamily.
  • Versão mínima.Minimum Version. A versão mais antiga do Windows 10 precisava dar suporte às funções básicas do seu aplicativo.The earliest version of Windows 10 needed to support the basic functions of your app. Isso define a configuração TargetPlatformMinVersion no seu arquivo de projeto.This sets the TargetPlatformMinVersion setting in your project file. Também determina o valor do atributo *TargetDeviceFamily@MinVersion* no manifesto do pacote do aplicativo.It also determines the value of the *TargetDeviceFamily@MinVersion* attribute in your app package manifest. O valor que você escolher especifica a versão mínima da plataforma UWP com a qual seu projeto pode trabalhar.The value you choose specifies the minimum version of the UWP platform that your project can work with.

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.Be aware that you're declaring that your app works on any version of Windows in the range from Minimum Version to Target Version. Se as duas forem da mesma versão, então você não precisará fazer nada especial.If those two are the same version then you don't need to do anything special. Se eles forem diferentes, então aqui estão algumas coisas que devem ser lembradas.If they're different then here are some things to be aware of.

  • 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.In your code, you can freely (that is, without conditional checks) call any API that exists in the version specified by Minimum Version.
  • 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.Ensure that you test your code on a device running the Minimum Version, to be sure that it works without requiring APIs only present in the Target Version.
  • O valor de Versão de destino é usado para identificar todas as referências (contrato winmds) usadas para compilar seu projeto.The value of Target Version is used to identify all the references (contract winmds) used to compile your project. 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).But those references will enable you to compile your code with calls to APIs that won't necessarily exist on devices that you've declared that you support (via Minimum Version). Portanto, qualquer API introduzida após a Versão mínima precisará ser chamada por meio do código adaptável.Therefore, any API that was introduced after Minimum Version will need to be called via adaptive code. Para saber mais sobre o código adaptável, confira Código adaptável à versão.For more information about adaptive code, see Version adaptive code.