.NET MAUI安装后运行报错:无法加载Microsoft.ui.xaml.dll
.NET MAUI 安装后无法加载'Microsoft.ui.xaml.dll'的解决方案
检查项目WinUI依赖配置
右键项目 → 属性 → Windows设置,确认“生成依赖项”中已勾选Microsoft.UI.Xaml,且版本与开发环境一致。同时检查项目的.csproj文件,确保包含正确的PackageReference:<PackageReference Include="Microsoft.UI.Xaml" Version="2.8.5" />(版本号请替换为你实际使用的版本)
启用Windows App SDK独立打包
在项目的.csproj文件中添加以下配置,强制打包时包含Windows App SDK的所有依赖组件:<PropertyGroup> <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained> </PropertyGroup>此配置会避免依赖系统已安装的Windows App SDK运行时,减少版本不兼容问题。
确认发布模式的部署设置
若使用发布模式打包,打开Visual Studio的发布配置窗口,将“部署模式”设置为独立,并选择对应目标系统的架构(如x64、arm64)。独立模式会将所有必要的运行时文件打包进安装包,无需依赖系统预装组件。验证安装包文件完整性
解压生成的.appx或.msix安装包,检查Dependencies目录下对应架构的子文件夹中是否存在Microsoft.ui.xaml.dll及相关资源文件。若文件缺失,说明打包过程未正确包含依赖,需重新检查项目配置后重新打包。修复Windows App SDK运行时
卸载系统中已安装的Windows App SDK运行时,通过Visual Studio安装器重新安装“Windows App SDK C# Templates”组件,或安装与项目版本匹配的Windows App SDK Runtime安装包。
内容的提问来源于stack exchange,提问作者ju53
相关产品推荐
相关产品推荐

