Выбор версии UWP

Каждая версия Windows 10 и Windows 11 предоставляет новые и улучшенные функции для платформы UWP. При создании приложения UWP в Microsoft Visual Studio можно выбрать для него целевую версию. Проекты, использующие .NET Standard 2.0, должна иметь минимальную версию сборки 16299 или выше.

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

Проект UWP, созданный в текущих версиях Visual Studio 2015, нельзя открыть в Visual Studio 2015.

В следующей таблице описаны доступные версии Windows 10 и Windows 11. Обратите внимание, что эта таблица применяется только для создания приложений UWP, которые поддерживаются исключительно в Windows 10 и Windows 11. Вы не можете разрабатывать приложения UWP для более ранних версий Windows. Необходимо установить выпуск пакета SDK, соответствующий целевой версии.

Версия Description
Сборка 19041 (версия 2004) Это последняя версия Windows 10, выпущенная в мае 2020 г. К основным функциям этого выпуска относятся:
* WSL2: В подсистему Windows для Linux добавлена новая архитектурная модель, и теперь она работает с фактическим ядром Linux в Windows. Дополнительные сведения см. в статье о WSL2.
* MSIX: новые функции в Windows обеспечивают дополнительную поддержку современного формата упаковки приложений MSIX, включая возможность создавать пакеты с включенными службами, создавать размещенные приложения и включать функции, требующие удостоверения пакета в непакованных приложениях. Дополнительные сведения см. в документации по MSIX.
Сведения об этих и многих других функциях, добавленных в этой версии Windows, см. в Центре разработки или на странице о новых возможностях в Windows 10 для разработчиков
Сборка 18362 (версия 1903) Эта версия Windows 10 была выпущена в апреле 2019 г. Вот некоторые функции из этого выпуска:
* XAML Islands: Теперь Windows 10 позволяет использовать элементы управления универсальной платформы Windows в классических приложениях, не относящихся к UWP. Если вы разрабатываете приложения для WPF, Windows Forms или C++ Win32, изучите добавление новых функций пользовательского интерфейса Windows 10 в существующее приложение.
* Подсистема Windows для Linux: Теперь вы можете обращаться к файлам Linux прямо из Windows, а также использовать несколько новых параметров командной строки. Актуальные сведения о WSL см. здесь.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 18362
Сборка 17763 (версия 1809) Эта версия Windows 10 была выпущена в октябре 2018 г. Обратите внимание, что для целевой версии Windows необходимо использовать Visual Studio 2017 или Visual Studio 2019. Вот некоторые функции из этого выпуска:
* Машинное обучение Windows: Платформа машинного обучения Windows Machine Learning официально вышла и предоставляет ряд новых возможностей, например, более быструю оценку и поддержку передовых моделей машинного обучения. Дополнительные сведения о платформе см. в разделе Машинное обучение Windows.
* Fluent Design: В Windows 10 добавлены новые функции, такие как меню, всплывающее окно командной строки и анимации свойств XAML. Актуальные сведения см. в статье The Fluent Design System for Windows app creators (Озбор системы проектирования Fluent Design для разработчиков приложений Windows).
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 17763
Сборка 17134 (версия 1803) Эта версия Windows 10 была выпущена в апреле 2018 г. Обратите внимание, что для целевой версии Windows необходимо использовать Visual Studio 2017 или Visual Studio 2019. Вот некоторые функции из этого выпуска:
* Fluent Design: В Windows 10 добавлены новые функции, такие как представление дерева, обновление путем оттягивания и представление навигации. Актуальные сведения см. в статье The Fluent Design System for Windows app creators (Озбор системы проектирования Fluent Design для разработчиков приложений Windows).
* Консольные приложения UWP: Теперь вы можете создавать консольные приложения C++/WinRT или C++/CX UWP, которые выполняются в окне консоли, например DOS или PowerShell.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 17134
Сборка 16299 (Fall Creators Update, версия 1709) Эта версия Windows 10 была выпущена в октябре 2017 г. Обратите внимание, что для целевой версии Windows необходимо использовать Visual Studio 2017 или Visual Studio 2019. Вот некоторые функции из этого выпуска:
* .NET Standard 2.0: Значительное увеличение числа API-интерфейсов .NET, а также внедрение ваших избранных пакетов NuGet и сторонних библиотек в .NET Standard. Подробыне сведения и документацию см. здесь. Обратите внимание, что для доступа к новым API в качестве минимальной версии необходимо задать сборку 16299.
* Fluent Design: Чтобы помочь пользователям сосредоточиться на важных элементах пользовательского интерфейса и улучшить приложение, используются свет, глубина, перспектива и движение.
* Условный XAML: Легко настраиваемые свойства и экземпляры объектов на основании присутствия API-интерфейса в среде выполнения позволяют приложениям без проблем работать на разных устройствах с разными версиями.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в Windows 10 для разработчиков
Сборка 15063 (Creators Update, версия 1703) Эта версия Windows 10 выпущена в марте 2017 г. Обратите внимание: чтобы выбрать эту версию Windows в качестве целевой, необходимо использовать Visual Studio 2017 или Visual Studio 2019. Вот некоторые функции из этого выпуска:
* Анализ рукописного ввода: Теперь Windows Ink может классифицировать росчерки пера как письмо или рисунок, а также распознавать текст, фигуры и базовые структуры в макетах.
* API Windows.UI.Composition: Анимацию теперь легко объединять и применять в приложении.
* Live Editing: Редактируйте XAML прямо во время работы приложения и наблюдайте результаты внесенных изменений в реальном времени.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 15063
Сборка 14393 (Юбилейное обновление, версия 1607) Эта версия Windows 10 выпущена в июле 2016 г. Вот некоторые функции из этого выпуска:
* Windows Ink: Новые элементы управления InkCanvas и InkToolbar.
* API Кортаны: используйте новые действия Кортаны для интеграции поддержки Кортаны с функциями вашего приложения.
* Windows Hello: Microsoft Edge теперь поддерживает Windows Hello, что дает веб-разработчикам доступ к биометрической проверке подлинности.
Сведения об этих и многих других функциях, добавленных в этом выпуске Windows, см. в статье о новых возможностях в сборке 14393
Сборка 10586 (ноябрьское обновление, версия 1511) Эта версия Windows 10 была выпущена в ноябре 2015 года. Выделенные функции включают введение API ORTC (обмен данными в режиме реального времени) для видеосвязи в API Microsoft Edge и поставщиков, чтобы приложения могли использовать проверку подлинности лиц Windows Hello. Подробные сведения о функциях в этой сборке.
Сборка 10240 (Windows 10, версия 1507) Это начальная версия Windows 10 с июля 2015 года. Подробные сведения о функциях в этой сборке.

Мы настоятельно рекомендуем новым разработчикам и разработчикам, которые пишут код для общей аудитории, всегда использовать последнюю сборку Windows (19041). Разработчики, пишущие корпоративные приложения, должны настоятельно учитывать поддержку более старой минимальной версии.

Что отличается в каждой версии UWP?

В каждой последующей версии Windows 10 и Windows 11 доступны новые и измененные API для UWP. Дополнительные сведения о том, какие функции были добавлены в ту или иную версию, см. в статье Новые возможности для разработчиков в Windows 10/11.

Справочные разделы, которые перечисляют все семейства устройств и их версии, а также все контракты API и их версии, см. в разделах семейств устройств и контрактов API.

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

Универсальная платформа Windows поддерживает ограниченный набор API-интерфейсов .NET, которые доступны теперь при любой целевой версии или минимальной версии, указанных для проекта. Эта страница содержит дополнительные сведения о доступных типах.

Если вы хотите создавать повторно используемые кросс-платформенные библиотеки, на UWP поддерживается .NET Standard. В документации по .NET Standard приведены сведения о том, какие версии .NET Standard поддерживаются в каких версиях UWP.

Если вы разрабатываете приложение для настольных систем, воспользуйтесь статьей о версиях и зависимостях .NET Framework, где приводятся подробные сведения о доступности .NET Framework.

Выбор версии, используемой для приложения

В диалоговом окне "Новый универсальный проект Windows" в Visual Studio можно выбрать версию целевой версии и минимальную версию. Кроме того, вы можете изменить целевую и минимальную версии для приложения UWP в разделе Приложение на странице Свойства.

  • Целевая версия. Версия Windows 10 или Windows 11, в которой будет работать ваше приложение. Этот параметр задает параметр TargetPlatformVersion в файле проекта. Он также определяет значение атрибута TargetDeviceFamily@MaxVersionTested в манифесте пакета приложения. Выбранное значение указывает версию платформы UWP, предназначенную для проекта, и поэтому набор API, доступных вашему приложению, поэтому рекомендуется выбрать самую последнюю версию. Дополнительные сведения о манифесте пакета приложения и некоторые рекомендации по настройке TargetDeviceFamily вручную см. в разделе TargetDeviceFamily.
  • Минимальная версия. Для поддержки основных функций приложения необходима самая ранняя версия Windows 10 или Windows 11. Этот параметр задает параметр TargetPlatformMinVersion в файле проекта. Он также определяет значение атрибута TargetDeviceFamily@MinVersion в манифесте пакета приложения. Выбранное значение указывает минимальную версию платформы UWP, с которым может работать проект.

Помните, что приложение работает в любой версии Windows в диапазоне от минимальной версии до целевой версии. Если эти два являются одной и той же версией, вам не нужно ничего специального. Если они разные, то вот некоторые вещи, которые следует учитывать.

  • В коде можно свободно (то есть без условных проверок) вызывать любой API, который существует в версии, указанной минимальной версией.
  • Убедитесь, что вы тестируете код на устройстве с минимальной версией, чтобы убедиться, что он работает без необходимости использовать API только в целевой версии.
  • Значение целевой версии используется для идентификации всех ссылок (winmds контракта), используемых для компиляции проекта. Но эти ссылки позволят компилировать код с вызовами API, которые не обязательно будут существовать на устройствах, которые вы объявили, что поддерживаете (с помощью минимальной версии). Таким образом, любой API, который был представлен после минимальной версии , необходимо вызвать с помощью адаптивного кода. Подробные сведения об адаптивном коде см. в статье Version adaptive code (Адаптивный к версии код).