Поделиться через

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

  • Статья

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

Примечание.

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

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

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

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

Обратите внимание на то, что поддерживается при миграции с 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.

Преимущества контейнеризации

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

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

Раздел Описание
Общая стратегия миграции Рекомендации и стратегии для подхода к процессу миграции и настройке среды разработки для миграции.
Сопоставление функций 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.

См. также