Universal Windows Platform build support в Unity: что это и как работает

Universal Windows Platform (UWP) build support в Unity — это модуль, который позволяет собирать игры и приложения для устройств на базе Windows 10 и Windows 11 с учетом особенностей экосистемы Microsoft. Включая поддержку Xbox One, HoloLens и других устройств под управлением Windows. С его помощью разработчики получают доступ к API Windows Runtime, интеграции с магазином Microsoft Store и оптимизации под железо.

Если вы видите в настройках опцию Universal Windows Platform Build Support — это означает, что можно собирать проект под UWP. Но чтобы всё заработало, нужно не только установить модуль, но и настроить среду разработки, и параметры сборки. Далее разберём, как это работает, какие плюсы даёт и какие подводные камни могут встретиться.

Зачем нужен в и чем он отличается от обычной сборки под Windows

Обычная сборка под Windows (Standalone) создаёт исполняемый файл (.exe), который запускается на любом ПК с подходящей версией ОС. же собирает приложение в формате .appx, который:

• Работает в изолированной песчанице — приложение не имеет доступа к системе без явных разрешений, что повышает безопасность.
• Поддерживает кроссплатформенность в рамках Windows — одна сборка может запускаться на ПК, планшетах, Xbox и HoloLens.
• Интегрируется с Microsoft Store — позволяет публиковать игру или приложение в официальном магазине.
• Использует DirectX 12 и другие современные API — даёт доступ к функциям, недоступным в классических Win32-приложениях.

Минусы тоже есть: UWP-приложения требуют сертификации для публикации в Store, имеют ограничения на доступ к файловой системе и реестру, а также могут не поддерживать некоторые плагины, работающие в Standalone-режиме.

Требования к системе и программному обеспечению

Чтобы собирать проекты под в Unity, нужно:

1. Установить Windows 10 или Windows 11 (версия 1809 или новее).
2. Скачать и установить Visual Studio 2022 (рекомендуется Community Edition) с компонентом Universal Windows Platform development.
3. Установить Windows 10 SDK или Windows 11 SDK через установщик Visual Studio.
4. В через Hub добавить модуль Universal Windows Platform Build Support для нужной версии движка.

Без этих компонентов сборка просто не запустится — выдаст ошибку о отсутствии необходимых инструментов.

Как установить Universal Windows Platform Build Support в Unity

Процесс установки модуля зависит от версии Unity, но в целом выглядит так:

1. Откройте Unity Hub.
2. Перейдите в раздел Installs и выберите нужную версию Unity.
3. Нажмите на три точки рядом с версией и выберите Add modules.
4. В списке найдите Universal Windows Platform Build Support и отметьте его галочкой.
5. Нажмите Done и дождитесь завершения установки.

После установки модуля в настройках проекта (File > Build Settings) появится опция Universal Windows Platform в списке платформ.

Если модуль не появляется, проверьте:

• Что у вас установлена последняя версия Unity Hub.
• Что выбранная версия поддерживает UWP (например, 2021.3 LTS или новее).
• Что у вас есть права администратора для установки компонентов.

Настройка проекта под UWP: основные параметры

Перед сборкой нужно настроить проект под UWP. Вот ключевые параметры, на которые стоит обратить внимание:

1. Target Device — выберите, для какого устройства собираете приложение: Any Device, PC, Xbox One или HoloLens.
2. Architecture — выберите архитектуру: x86, x64 или ARM (для устройств на базе процессоров Qualcomm).
3. Build Configuration — Release или Debug. Для финальной сборки используйте Release.
4. Minimum API Level — минимальная версия API Windows, которую будет поддерживать ваше приложение. Чем выше — тем меньше устройств сможет его запустить.
5. Target SDK Version — версия SDK, под которую вы собираете приложение. Должна быть не ниже минимального уровня.

Также в Player Settings (Edit > Project Settings > Player) нужно:

• Указать Package Name (идентификатор приложения в формате com.yourcompany.yourapp).
• Загрузить значки и логотипы для магазина (если планируете публиковаться в Microsoft Store).
• Настроить разрешения (например, доступ к микрофону, камере, интернету).

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

Сравнение и Standalone Windows: что выбрать

Не всегда очевидно, какую платформу выбрать для сборки под Windows. В таблице ниже — сравнение ключевых аспектов и Standalone.

Выбор зависит от целей проекта. Если вы делаете игру для Xbox или хотите опубликоваться в Microsoft Store, UWP — единственный вариант. Для классических ПК-игр без привязки к экосистеме чаще выбирают Standalone.

Распространённые ошибки и их решения

При работе с в разработчики часто сталкиваются с типичными проблемами. Вот самые распространённые из них и способы их решения:

• Ошибка: "UWP build support not installed" — значит, модуль не установлен в выбранной версии Unity. Решение: установите его через Unity Hub, как описано выше.
• Ошибка: "Windows SDK not found" — отсутствует нужная версия Windows SDK. Решение: установите через установщик Visual Studio.
• Ошибка: "App manifest validation failed" — проблемы с манифестом приложения (например, неверный Package Name или отсутствующие разрешения). Решение: проверьте настройки в Player Settings > Publishing Settings.
• Ошибка: "D3D12 not supported" — если вы используете DirectX 12, но устройство его не поддерживает. Решение: выберите в настройках графики Direct3D11 или убедитесь, что целевое устройство поддерживает DX12.
• Приложение не запускается на Xbox — возможно, не выбран правильный Target Device. Решение: в настройках сборки выберите Xbox One и убедитесь, что у вас есть лицензия разработчика для Xbox.

Если ошибка не решена, проверьте логи сборки в Unity (Console) или в Visual Studio — там часто есть подробности о причине проблемы.

Пошаговая инструкция: первая сборка под UWP

Чтобы собрать простой проект под UWP, выполните следующие шаги:

1. Установите все необходимые компоненты (Unity с модулем UWP, Visual Studio, Windows SDK).
2. Создайте новый проект в или откройте существующий.
3. Перейдите в File > Build Settings.
4. Нажмите Add Open Scenes, чтобы добавить текущую сцену в сборку.
5. Выберите платформу Universal Windows Platform и нажмите Switch Platform.
6. В Player Settings настройте параметры сборки (Package Name, разрешения, Target Device и т. д.).
7. Нажмите Build, выберите папку для сборки и дождитесь завершения.
8. После сборки откроет проект в Visual Studio. Скомпилируйте его через Build > Build Solution.
9. Готовый .appx файл будет в папке AppPackages внутри проекта Visual Studio.

Чтобы запустить приложение:

• Дважды кликните на .appx файл (если у вас включён режим разработчика в Windows).
• Или установите через PowerShell: Add-AppxPackage -Path "путь_к_файлу.appx".

Часто задаваемые вопросы

Можно ли собирать UWP-приложения на или Linux?

Нет. Сборка под возможна только на Windows, так как требует Windows SDK и Visual Studio. На или можно разрабатывать проект, но для финальной сборки всё равно потребуется Windows.

Нужно ли платить за публикацию в Microsoft Store?

Да, для публикации приложений в Microsoft Store требуется учёт разработчика, который стоит 19 долларов в год (для физических лиц). Для компаний стоимость выше — 99 долларов в год.

Можно ли использовать для коммерческих проектов?

Да, подходит для коммерческих проектов. Однако нужно учитывать ограничения платформы (например, песчаницу) и требования Microsoft Store, если вы планируете там публиковаться.

Как отладить UWP-приложение в Unity?

Для отладки используйте Visual Studio. После сборки проекта в он автоматически откроется в VS. Запустите отладку через Debug > Start Debugging. Также можно использовать Unity Remote для отладки на устройстве.