Миграция из UWP в пакет SDK для приложений Windows

Если вам достаточно текущих функций на универсальной платформе Windows (UWP), переносить тип проектов не нужно. WinUI 2.x и Windows SDK поддерживают типы проектов UWP.

Но если вы решили перенести приложение с UWP на Windows App SDK, в большинстве случаев в коде пользовательского интерфейса нужно изменить всего несколько пространств имен. Значительная часть кода для платформы останется без изменений. Вам потребуется изменить код из-за различий между приложениями UWP и классическими приложениями. Но мы ожидаем, что для большинства приложений (в зависимости от размера базы кода, конечно же), на миграцию потребуется несколько дней, а не недель.

На высоком уровне это шаги по миграции вручную (но см. следующий раздел, чтобы получить сведения об использовании помощника по обновлению .NET):

1. Создайте пакетный классический проект WinUI 3 (см. раздел "Создание первого проекта WinUI 3"). Его можно перенести в существующее решение.
2. Копирование кода XAML/UI. Во многих случаях вы можете просто изменить пространства имен (например, Windows.UI.* на Microsoft.UI.*).
3. Копирование кода логики приложения. Для некоторых API потребуются изменения, например для всплывающих элементов, средств выбора и дополнительных плиток.

Полные сведения см. в разделах, приведенных в таблице ниже. Они описывают и демонстрируют, как вручную перенести приложение универсальная платформа Windows (UWP) в пакет SDK для приложений Windows.

Обратите внимание на то, что поддерживается при миграции с UWP на WinUI 3. В этом разделе описываются все функции, которые еще не поддерживаются в WinUI 3 и Windows App SDK. Если вашему приложению нужны какие-либо из этих функций или библиотек, мы рекомендуем отложить миграцию.

Миграция с помощью помощника по обновлению .NET

В качестве дальнейшего шага, помогающего перенести приложения UWP в пакет SDK для приложений Windows и WinUI 3, мы использовали помощник по обновлению .NET, добавив поддержку миграции приложений UWP на C#. Поддержка UWP автоматизирует большую часть процесса миграции. Дополнительные сведения см. в разделе "Миграция из UWP в пакет SDK для приложений Windows" с помощником по обновлению .NET.

Темы в этом разделе

Раздел	Описание
Общая стратегия миграции	Рекомендации и стратегии для подхода к процессу миграции и настройке среды разработки для миграции.
Сопоставление функций UWP с пакетом SDK для приложений Windows	В этом разделе сравниваются основные области функций в разных формах, в которых они отображаются в UWP и в пакете SDK для приложений Windows.
Поддерживаемые возможности	Узнайте, какие функции в настоящее время доступны в WinUI 3 Desktop, чтобы оценить, следует ли сегодня пытаться перенести приложение UWP.
Сопоставление API и библиотек UWP с пакетом SDK для приложений Windows	В этом разделе представлено сопоставление API-интерфейсов и библиотек UWP с эквивалентами пакета SDK для приложений Windows.
Руководства по областям компонентов	Коллекция разделов руководства по миграции, каждая из которых посвящена определенной области функций.
Пример 1— PhotoLab (C#)	В этом разделе описано, как взять пример приложения UWP и перенести его в пакет SDK для приложений Windows.
Пример 2. Редактор фотографий (C++/WinRT)	В этом разделе рассматриваются примеры приложения редактора фотографий C++/WinRT UWP и его перенос в пакет SDK для приложений Windows.
Дополнительные рекомендации по миграции	В этом разделе содержатся дополнительные рекомендации по миграции, которые не классифицируются в области функций в руководствах по областям функций.
Миграция из UWP в пакет SDK для приложений Windows с помощью помощника по обновлению .NET	Помощник по обновлению .NET — это средство командной строки, которое может помочь при переносе приложения UWP C# в приложение Библиотеки пользовательского интерфейса Windows (WinUI) 3, использующее пакет SDK для приложений Windows.