排查使用应用安装程序文件遇到的安装问题

如果在通过应用安装程序文件安装应用程序时发现任何问题，本主题将提供一些可能有帮助的故障排除指南。

为了能在 Windows 10 中旁加载应用，用户设备必须满足下面的要求：

Windows 10：

Windows 10 1909 及更早版本：

在用户计算机中第一次旁加载应用程序时会遇到一些常见问题。 接下来的几个部分介绍了最常见的问题及其解决方案。

每个 Windows 10 版本都改进了旁加载体验，在下表中可以找到每个主要版本中提供哪些功能。 如果你尝试使用你的 Windows 10 版本不支持的方法旁加载应用，将出现部署错误。

必须使用设备信任的证书对应用包进行签名。 默认情况下，常见证书颁发机构提供的证书在 Windows 操作系统中是受信任的。

但是，如果用于对应用包进行签名的证书不受信任，或者是在开发过程中使用的本地生成的/自签名证书，则应用安装程序可能会报告该包不受信任，并阻止其安装：

若要解决此问题，对设备具有本地管理员权限的用户必须使用 计算机证书 工具将证书导入以下容器之一：

重要

不要将包签名证书导入到用户证书存储中。 验证包标识时，应用安装程序不会搜索用户证书。

可以通过从“开始”菜单进行搜索来轻松找到计算机证书管理工具：

成功导入签名证书后，重新运行应用安装程序将显示包受信任且可以安装：

Windows 10应用程序可以具有基于用于生成应用的应用程序平台的框架依赖项。 如果你使用的是 C# 或 VB，应用将需要 .NET 运行时和 .NET 框架包。 C++ 应用程序需要 VCLibs。

重要

如果应用包在发布模式配置中生成，将从 Microsoft Store 获取框架依赖项。 但是，如果应用是在调试模式配置中生成的，将从 .appinstaller 文件中指定的位置获取依赖项。

在从 HTTP 终结点安装时，务必验证是否可以访问具有正确 MIME 类型的所有文件。 验证这些文件的最简单方法是遵循 Visual Studio 所生成 HTML 页面中提供的链接。 你必须检查这些文件：

由于目前不支持虚 URL，因此使用 ms-appinstaller 协议时，源参数必须以 结尾 .appinstaller。 是否重定向到以 .appinstaller结尾的文件并不重要。 这也将以同样的方式失败。 解决此问题的唯一方法是确保原始 URL 以 .appinstaller结尾。

如果应用安装程序无法安装应用，这些步骤将有助于确定安装问题。

将应用包文件下载到本地文件夹，并尝试使用 Add-AppxPackage PowerShell 命令进行安装。

将 .appinstaller 文件下载到本地文件夹，并尝试使用 Add-AppxPackage -Appinstaller PowerShell 命令进行安装。

应用部署基础结构发出日志，这些日志通常用于通过 Windows 事件查看器调试安装问题：Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server