Выбор версии UWPChoose a UWP version

Каждая версия Windows 10 предоставляет новые и улучшенные функции для платформы UWP.Each version of Windows 10 has brought new and improved features to the UWP platform. При создании приложения UWP в Microsoft Visual Studio можно выбрать для него целевую версию.When creating a UWP app in Microsoft Visual Studio, you can choose which version to target. Проекты, использующие .NET Standard 2.0, должна иметь минимальную версию сборки 16299 или выше.Projects using .NET Standard 2.0 must have a Minimum Version of Build 16299 or later.

Предупреждение

Проект UWP, созданный в текущих версиях Visual Studio 2015, нельзя открыть в Visual Studio 2015.UWP projects created in current versions of Visual Studio cannot be opened in Visual Studio 2015.

В следующей таблице описаны доступные версии Windows 10.The following table describes the available versions of Windows 10. Обратите внимание, что эта таблица применяется только для создания приложений UWP, которые поддерживаются исключительно в Windows 10.Please note that this table only applies for building UWP apps, which are only supported on Windows 10. Вы не можете разрабатывать приложения UWP для более ранних версий Windows. Необходимо установить выпуск пакета SDK, соответствующий целевой версии.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.

ВерсияVersion ОписаниеDescription
Сборка 19041 (версия 2004)Build 19041 (version 2004) Это последняя версия Windows 10, выпущенная в мае 2020 г.This is the latest version of Windows 10, released in May 2020. К основным функциям этого выпуска относятся:Highlighted features of this release include:
* WSL2. В подсистему Windows для Linux добавлена новая архитектурная модель, и теперь она работает с фактическим ядром Linux в Windows.* WSL2: Windows Subsystem for Linux has been updated with a new architectural model, and now runs an actual Linux kernal on Windows. Дополнительные сведения см. в статье о WSL2.Learn more at about WSL2.
* MSIX. Новые функции в Windows обеспечивают дополнительную поддержку для современного формата упаковки приложений MSIX, в том числе предоставляют возможность создавать пакеты с включенными службами, размещенные приложения, а также возможность добавления функций, требующих идентификатор пакета в неупакованных приложениях.* 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. Дополнительные сведения см. в документации по MSIX.Learn more in the MSIX docs.
Сведения об этих и многих других функциях, добавленных в этой версии Windows, см. в Центре разработки или на странице о новых возможностях в Windows 10 для разработчиков.For 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
Сборка 18362 (версия 1903)Build 18362 (version 1903) Эта версия Windows 10 была выпущена в апреле 2019 г.This version of Windows 10 was released in April 2019. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* XAML Islands. Теперь Windows 10 позволяет использовать элементы управления универсальной платформы Windows в классических приложениях WPF, Windows Forms и C++ на платформе Win32.* XAML Islands: Windows 10 now enables you to use UWP controls in non-UWP desktop applications. Если вы разрабатываете приложения для WPF, Windows Forms, или C++ Win32, изучите добавление новых функций пользовательского интерфейса Windows 10 в существующее приложение.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.
* Подсистема Windows для Linux. Теперь вы можете обращаться к файлам Linux прямо из Windows, а также использовать несколько новых параметров командной строки.* Windows Subsystem for Linux: You can now access Linux files directly from within Windows, and use several new command line options. Актуальные сведения о WSL см. здесь.See the latest at about WSL.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 18362.For information on these and many other features added in this release of Windows, visit What's new in build 18362
Сборка 17763 (версия 1809)Build 17763 (version 1809) Эта версия Windows 10 была выпущена в октябре 2018 г.This version of Windows 10 was released in October 2018. Обратите внимание: чтобы выбрать эту версию Windows в качестве целевой, необходимо использовать Visual Studio 2017 или Visual Studio 2019.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* Машинное обучение Windows. Теперь платформа "Машинное обучение Windows" выпущена официально и предоставляет ряд новых возможностей, например более быструю оценку и поддержку передовых моделей машинного обучения.* Windows Machine Learning: Windows Machine Learning has now officially launched, providing features like faster evaluation and support for cutting-edge machine learning models. Дополнительные сведения о платформе см. в разделе Машинное обучение Windows.To learn more about the platform, see Windows Machine Learning.
* Fluent Design. В Windows 10 добавлены новые функции, такие как меню, всплывающее окно командной строки и анимации свойств XAML.* Fluent Design: New features such as menu bar, command bar flyout, and XAML property animations have been added to Windows 10. Актуальные сведения см. в статье The Fluent Design System for Windows app creators (Озбор системы проектирования Fluent Design для разработчиков приложений Windows).See the latest at the Fluent design overview.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 17763.For information on these and many other features added in this release of Windows, visit What's new in build 17763
Сборка 17134 (версия 1803)Build 17134 (version 1803) Эта версия Windows 10 была выпущена в апреле 2018 г.This is version of Windows 10 was released in April 2018. Обратите внимание: чтобы выбрать эту версию Windows в качестве целевой, необходимо использовать Visual Studio 2017 или Visual Studio 2019.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* Fluent Design. В Windows 10 добавлены новые функции, такие как представление дерева, обновление путем оттягивания и представление навигации.* Fluent Design: New features such as tree view, pull-to-refresh, and navigation view have been added to Windows 10. Актуальные сведения см. в статье The Fluent Design System for Windows app creators (Озбор системы проектирования Fluent Design для разработчиков приложений Windows).See the latest at the Fluent design overview.
* Консольные приложения UWP. Теперь вы можете создавать консольные приложения C++/WinRT или C++/CX UWP, которые выполняются в окне консоли, например DOS или 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.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 17134.For information on these and many other features added in this release of windows, visit What's new in build 17134
Сборка 16299 (Fall Creators Update, версия 1709)Build 16299 (Fall Creators Update, version 1709) Эта версия Windows 10 была выпущена в октябре 2017 г.This verion of Windows 10 was released in October 2017. Обратите внимание: чтобы выбрать эту версию Windows в качестве целевой, необходимо использовать Visual Studio 2017 или Visual Studio 2019.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* .NET Standard 2.0. Значительное увеличение числа API-интерфейсов .NET, а также внедрение ваших избранных пакетов NuGet и сторонних библиотек в .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. Подробыне сведения и документацию см. здесь.See more details and explore the documentation here. Обратите внимание, что для доступа к новым API в качестве минимальной версии необходимо задать сборку 16299.Please note that you must set your minimum version to Build 16299 to access these new APIs.
* Fluent Design. Чтобы помочь пользователям сосредоточиться на важных элементах пользовательского интерфейса и улучшить приложение, используются свет, глубина, перспектива и движение.* Fluent Design: Use light, depth, perspective, and movement to enhance your app and help users focus on important UI elements.
* Условный XAML. Легко настраиваемые свойства и экземпляры объектов на основании присутствия API-интерфейса в среде выполнения позволяют приложениям без проблем работать на разных устройствах с разными версиями.* 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.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в Windows 10 для разработчиков.For information on these and many other features added in this release of windows, visit What's new in Windows 10 for developers
Сборка 15063 (Creators Update, версия 1703)Build 15063 (Creators Update, version 1703) Эта версия Windows 10 выпущена в марте 2017 г.This version of Windows 10 was released in March 2017. Обратите внимание: чтобы выбрать эту версию Windows в качестве целевой, необходимо использовать Visual Studio 2017 или Visual Studio 2019.Please note that you must be using Visual Studio 2017 or Visual Studio 2019 in order to target this version of Windows. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* Анализ рукописного ввода. Теперь Windows Ink может классифицировать росчерки пера как письмо или рисунок, а также распознавать текст, фигуры и базовые структуры в макетах.* Ink Analysis: Windows Ink can now categorize ink strokes into either writing or drawing strokes, and recognized text, shapes, and basid layout structures.
* API Windows.UI.Composition. Анимацию теперь легко объединять и применять в приложении.* Windows.Ui.Composition APIs: Easily combine and apply animations across your app.
* Live Editing. Редактируйте XAML прямо во время работы приложения и наблюдайте результаты внесенных изменений в реальном времени.* Live Editing: Edit XAML while your app is running, and see the changes applied in real-time.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 15063.For information on these and many other features added in this release of windows, visit What's new in build 15063
Сборка 14393 (Юбилейное обновление, версия 1607)Build 14393 (Anniversary Update, version 1607) Эта версия Windows 10 выпущена в июле 2016 г.This version of Windows 10 was released in July 2016. Вот некоторые функции из этого выпуска:Some highlighted features from this release include:
* Windows Ink. Новые элементы управления InkCanvas и InkToolbar.* Windows Ink: New InkCanvas and InkToolbar controls.
* API Кортаны. Используйте новые действия Кортаны для интеграции поддержки Кортаны с функциями вашего приложения.* Cortana APIs: Use new Cortana Actions to integrate Cortana support with specific functions of your app.
* Windows Hello. Microsoft Edge теперь поддерживает Windows Hello, что дает веб-разработчикам доступ к биометрической проверке подлинности.* Windows Hello: Microsoft Edge now supports Windows Hello, giving web developers access to biometric authentication.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 14393.For information on these and many other features added in this release of windows, visit What's new in build 14393
Сборка 10586 (ноябрьское обновление, версия 1511)Build 10586 (November Update, version 1511) Эта версия Windows 10 была выпущена в ноябре 2015 г.This version of Windows 10 was released in November 2015. Среди новых функций интерфейс API ORTC для видеосвязи в Microsoft Edge и API для поставщиков, которые позволяют приложениям использовать распознавание лиц 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. Подробные сведения о функциях в этой сборке.More information on features introduced in this build.
Сборка 10240 (Windows 10, версия 1507)Build 10240 (Windows 10, version 1507) Это исходная версия Windows 10, выпущенная в июле 2015 г.This is the initial release version of Windows 10, from July 2015. Подробные сведения о функциях в этой сборке.More information on features introduced in this build.

Мы настоятельно рекомендуем новым разработчикам и разработчикам, которые пишут код для общей аудитории, всегда использовать последнюю сборку Windows (19041).We highly recommend that new developers and developers writing code for a general audience always use the latest build of Windows (19041). Разработчикам корпоративных приложений настоятельно рекомендуется поддерживать минимальную версию.Developers writing Enterprise apps should strongly consider supporting an older Minimum Version.

Чем отличаются разные версии UWP?What's different in each UWP version?

В каждой последующей версии Windows 10 доступны новые и измененные API для UWP.New and changed APIs for UWP are available in every successive version of Windows 10. Подробные сведения о том, какие функции были добавлены в ту или иную версию, см. в разделе Новые возможности для разработчиков в Windows 10.For specific information about what features were added in which version, see What's new for developers in Windows 10.

Разделы справки со всеми семействами устройств и их версиями, а также контрактами API и их версиями см в разделе Семейства устройств и Контракты 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.

Доступность .NET API по версиям универсальной платформы Windows.NET API availability in UWP versions

Универсальная платформа Windows поддерживает ограниченный набор API-интерфейсов .NET, которые доступны теперь при любой целевой версии или минимальной версии, указанных для проекта.UWP supports a limited subset of .NET APIs, which are available regardless of the Target Version or Minimum Version of your project. Эта страница содержит дополнительные сведения о доступных типах.This page provides more information on the types available.

Если вы хотите создавать повторно используемые кросс-платформенные библиотеки, на UWP поддерживается .NET Standard.If you wish to create reusable cross-platform libraries, .NET Standard is supported on UWP. В документации по .NET Standard приведены сведения о том, какие версии .NET Standard поддерживаются в каких версиях UWP.The .NET Standard documentation provides information on which .NET Standard is supported in which UWP versions.

Если вы разрабатываете приложение для настольных систем, воспользуйтесь статьей о версиях и зависимостях .NET Framework, где приводятся подробные сведения о доступности .NET Framework.If you are developing a Desktop app, see instead .NET Framework versions and dependencies for detailed information on .NET framework availability.

Выбор версии для вашего приложенияChoose which version to use for your app

В диалоговом окне Новый универсальный проект Windows в Visual Studio вы можете выбрать версию для целевой и минимальной версии.In the New Universal Windows Project dialog in Visual Studio, you can choose a version for Target Version and for Minimum Version. Кроме того, вы можете изменить целевую и минимальную версии для приложения UWP в разделе Приложение на странице Свойства.Additionally, you can change the Target Version and Minimum Version of your UWP app in the application section of the app's Properties.

  • Целевая версия.Target Version. Версия Windows 10, на которой будет работать ваше приложение.The version of Windows 10 that your app is intended to run on. При этом задается значение параметра TargetPlatformVersion в файле проекта.This sets the TargetPlatformVersion setting in your project file. Также устанавливается значение атрибута *TargetDeviceFamily@MaxVersionTested* в манифесте пакета приложения.It also determines the value of the *TargetDeviceFamily@MaxVersionTested* attribute in your app package manifest. Выбранное значение определяет версию платформы UWP, для которой предназначен ваш проект, а значит и набор интерфейсов API, доступных вашему приложению, поэтому мы рекомендуем выбрать самую последнюю версию.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. Дополнительные сведения о манифесте пакета приложения и некоторые рекомендации по настройке TargetDeviceFamily вручную см. в разделе TargetDeviceFamily.For more info about your app package manifest, and some guidelines around configuring TargetDeviceFamily manually, see TargetDeviceFamily.
  • Минимальная версия.Minimum Version. Для поддержки основных функций приложения необходима самая ранняя версия Windows 10.The earliest version of Windows 10 needed to support the basic functions of your app. При этом задается значение параметра TargetPlatformMinVersion в файле проекта.This sets the TargetPlatformMinVersion setting in your project file. Также устанавливается значение атрибута *TargetDeviceFamily@MinVersion* в манифесте пакета приложения.It also determines the value of the *TargetDeviceFamily@MinVersion* attribute in your app package manifest. Выбранное значение задает минимальную версию платформы UWP, с которой проект может работать.The value you choose specifies the minimum version of the UWP platform that your project can work with.

Помните, что объявляете, что ваше приложение работает в любой версии Windows в диапазоне от минимальной до целевой версии.Be aware that you're declaring that your app works on any version of Windows in the range from Minimum Version to Target Version. Если это одинаковые версии, вам не нужно выполнять никаких особенных действий.If those two are the same version then you don't need to do anything special. Если они разные, то нужно учитывать следующие моменты.If they're different then here are some things to be aware of.

  • В коде вы можете свободно (то есть, без условных проверок) вызвать любой API-интерфейс, существующий в версии, заданной атрибутом Минимальная версия.In your code, you can freely (that is, without conditional checks) call any API that exists in the version specified by Minimum Version.
  • Обязательно протестируйте код на устройстве с минимальной версией, чтобы убедиться, что он работает без API-интерфейсов, которые присутствует только в целевой версии.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.
  • Значение атрибута Целевая версия используется для идентификации всех ссылок (winmds контрактов) при компиляции проекта.The value of Target Version is used to identify all the references (contract winmds) used to compile your project. Но эти ссылки позволяют скомпилировать код с помощью вызовов API-интерфейсов, которые необязательно есть на устройствах, которые объявлены вам как поддерживаемые (с помощью атрибута Минимальная версия).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). Следовательно, любой API-интерфейс, реализованной после минимальной версии, должен вызываться через адаптивный код.Therefore, any API that was introduced after Minimum Version will need to be called via adaptive code. Подробные сведения об адаптивном коде см. в статье Version adaptive code (Адаптивный к версии код).For more information about adaptive code, see Version adaptive code.