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

Чтобы перенести приложение из UWP в пакет SDK для приложений Windows, код пользовательского интерфейса, скорее всего, требует лишь нескольких изменений пространства имен, в то время как большая часть кода платформы может оставаться такой же.

Примечание.

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

Несмотря на то, что вам может потребоваться настроить некоторый код из-за различий между классическими приложениями и приложениями UWP, перенос большинства приложений требует всего нескольких шагов.

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

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

Примечание.

Если исходный код UWP написан в C++/CX, необходимо перенести этот код (см. раздел "Перемещение на C++/WinRT" из C++/CX).

Миграция с помощью помощника по обновлению .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# в приложение WinUI 3, использующее пакет SDK для приложений Windows.