跳到主要内容

Unreal Engine引擎移植UWP

简介​

本方案适用于Unreal Engine。在保持现有代码架构基本不变的基础上，通过MSIX打包技术，将传统Win32应用转换为UWP格式，实现微软商店分发。

整体流程概览​

SDK集成与EXE构建​

此阶段是基础，确保游戏本身功能完整。

SDK集成​

在Unreal Engine项目中，按照SDK集成的标准指南，完成依赖库导入、API调用、配置设置等工作。务必在此阶段完成所有与SDK相关的功能开发和测试。

Windows平台构建：​

  • 打开项目 → 文件(File) → 打包项目(Package Project)

  • 选择目标平台：

    • Windows (64位)

    • Windows (32位) - 如需要

  • 选择输出目录：

    • 建议创建空文件夹，如 Builds/Windows

    • 确保磁盘有足够空间（通常需要5-20GB）

打包成功后，输出目录结构如下：

Builds/Windows/
├── YourGame.exe              # 主执行文件
├── YourGame/Binaries/        # 依赖DLL文件
├── YourGame/Content/         # 游戏资源文件
├── YourGame/Intermediate/    # 中间文件
└── Engine/                   # 引擎运行时文件

处理沙盒兼容性​

MSIX的沙盒环境会限制某些默认在Win32下可用的操作，如访问注册表、系统文件目录等。

  • 文件系统访问：应用程序可能尝试向 C:\Program Files 或安装目录等受保护路径写入数据，这会失败。需要将数据写入 Windows.Storage.ApplicationData.Current.LocalFolder（对应 %USERPROFILE%\AppData\Local\Packages\[包名]\LocalState）路径。

  • 注册表访问：应用程序可能读写 HKEY_LOCAL_MACHINE 或 HKEY_CURRENT_USER\Software\[某些全局设置]，这些写入操作会被重定向到虚拟化区域。需要应引导程序将设置存储到 HKEY_CURRENT_USER\Software\Classes\Local Settings\Software\[应用名]。

  • 进程间通信：复杂的IPC可能被阻塞，需确保通信方式在沙盒内可行。

  • 测试与调试：必须进行彻底的测试，验证SDK的所有功能在MSIX安装版中与传统exe版本表现一致。

构建、测试与分发​

  • 生成MSIX包：通过MSIX打包技术，生成msix格式微软应用商店程序包。

  • 本地测试：安装MSIX包，进行完整的功能测试。

  • 运行WACK：使用Windows App Certification Kit对包进行认证测试，解决任何兼容性问题。

  • 商店提交：将通过认证的MSIX包提交至Microsoft Partner Center，完成商店上架流程。

注意：请将本地计算机设置成【开发人员模式】，否则UWP应用无法正常安装