Maui默认项目发布后MSIX安装包无法打开,求助解决办法
解决MAUI MSIX安装报错
The app was not started的方法及排查途径 获取详细报错信息的途径
- 事件查看器:打开事件查看器,依次展开「Windows日志」→「应用程序」,筛选来源为
AppXDeployment-Server或Microsoft-Windows-AppxDeploymentServer的事件,这些事件会包含具体错误代码和详细描述,帮助定位问题。 - PowerShell命令日志:
- 运行
Get-AppxLog -All可查看所有AppX相关安装日志,检索对应MSIX包的安装失败记录。 - 手动执行安装命令并开启详细输出:
Add-AppxPackage -Path "你的MSIX文件路径" -Verbose,Verbose模式会实时输出安装过程的每一步,便于捕获具体失败环节。
- 运行
- Visual Studio发布日志:发布生成的日志文件通常位于项目目录的
bin\Release\net7.0-windows10.0.19041.0\win10-x64\AppPackages\[你的包名]\下,找到Publish.log文件,检查发布过程中是否存在潜在的配置或打包错误。
可能的解决方法
- 验证并安装证书:右键MSIX文件→「属性」→「数字签名」,查看签名证书。如果是测试证书,需将其安装到「本地计算机」的「受信任的根证书颁发机构」(仅用于测试环境,正式发布需使用正规证书)。
- 清理旧应用实例:先卸载已安装的同名应用,通过
Get-AppxPackage | Where-Object {$_.Name -like "*你的应用名称*"}获取包全名,再执行Remove-AppxPackage "[包全名]"卸载,重启电脑后重新尝试安装。 - 检查版本兼容性:打开MAUI项目的
.csproj文件,确认<TargetPlatformMinVersion>设置的版本不高于当前Windows 11 22H2的版本(推荐设置为10.0.19041.0),避免版本不匹配导致安装失败。 - 修复MAUI工作负载:打开Visual Studio安装器,选择「修改」,找到
.NET Multi-platform App UI development工作负载,点击「修改」修复可能损坏的组件。 - 重新生成发布包:删除项目的
bin和obj目录,重新构建并发布项目,清除缓存的旧文件可能解决打包过程中产生的异常。
内容的提问来源于stack exchange,提问作者Der_Floh
相关产品推荐
相关产品推荐

