如何在Uno平台实现WinUI与Prism的整合及项目模板选型
基础模板选型建议
优先选型结论
直接使用你通过命令创建的、仅包含WinUI Desktop与Wasm头部项目的WinUI栈Uno解决方案作为项目启动基础,不建议选择旧版Prism Blank App (Uno Platform)模板。
选型判断依据
- 旧Prism空白模板存在不可忽视的结构缺陷:
- 模板默认基于UWP API栈实现
Microsoft.UI.Xaml命名空间,解决方案中缺失WinUI Desktop项目头,后续需要从头补全WinUI项目结构、替换底层API实现,整体迁移成本远高于从原生WinUI模板适配Prism的成本 - 该模板的架构版本长期未跟进Uno的WinUI分支更新,和当前官方维护的API栈适配性差,后续升级Uno SDK时极易出现兼容故障
- 模板默认基于UWP API栈实现
- 原生WinUI Uno模板的适配成本更低:
- 项目直接采用WinUI版
Microsoft.UI.Xaml实现栈,结构完全匹配Uno当前的长期支持架构 - 可通过命令灵活裁剪不需要的目标平台项目,避免冗余代码干扰调试
- 项目直接采用WinUI版
PrismApplication替换操作的常见失败原因与修正步骤
你在WinUI Uno模板基础上尝试替换基础类失败,通常是因为没有同步完成全链路的继承与初始化逻辑修改,可按照以下步骤操作:
- 版本兼容性校验
提前确认引用的Prism.UnoNuGet包版本和当前使用的Uno SDK版本严格匹配,跨大版本引用会直接导致自定义类型无法识别、类继承关系不生效的问题 - 共享项目层的类替换
修改共享项目内的App.xaml根节点声明、App.xaml.cs类定义,将原有继承的Microsoft.UI.Xaml.Application替换为PrismApplication,同时补上PrismApplication要求重写的核心方法(如RegisterTypes、CreateShell) - 各平台头项目的入口逻辑修正
分别修改WinUI、Wasm头部项目的应用入口代码,将默认的手动实例化App的逻辑,替换为Prism.Uno要求的标准初始化流程,不要直接在头项目中手动实例化自定义的PrismApplication类
注:你之前执行的项目生成命令
dotnet new unoapp-winui -o "Weather.History" -uwp=false -ios=false -android=false -macos=false -sw=false -sg=false生成的项目结构本身完全合规,不需要重新创建解决方案
内容的提问来源于stack exchange,提问作者Tommy
相关产品推荐
相关产品推荐

