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

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

必备条件

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

Windows 10:

  • 用于对程序包签名的证书必须受设备信任。 有关更多详细信息,请参阅下面的 受信任的证书 部分。
  • Windows 10 版本必须支持 .appinstaller 文件方案和分发协议。

Windows 10 1909 及更早版本:

常见问题

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

Windows 版本

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

版本 旁加载注意事项
内部版本 17134 (2018 年 4 月更新版本 1803) 通过 UNC/共享文件夹可以访问 .appinstaller 文件。 还提供可配置的更新检查。
内部版本 16299(Fall Creators Update 版本 1709) 引入 .appinstaller 文件以便为你的应用提供自动更新。 此版本仅支持 HTTP 终结点。 更新检查不可配置,每 24 小时进行一次。
内部版本 15063(Creators Update 版本 1703) 应用安装程序应用能够从 Microsoft Store 下载应用依赖项(仅在发布模式下)。
内部版本 14393(周年更新版本 1607) 引入应用安装程序应用来安装 .appx 和 .appxbundle 文件,.appinstaller 文件不受支持。
内部版本 10586(11 月更新版本 1511) 只有通过 PowerShell 使用 Add-AppxPackage 命令才能使用旁加载。
内部版本 10240(Windows 10 版本 1507) 只有通过 PowerShell 使用 Add-AppxPackage 命令才能使用旁加载。

受信任的证书

必须使用设备信任的证书对应用包进行签名。 默认情况下,通用证书颁发机构提供的证书在 Windows受信任。

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

使用缺少或不受信任的证书签名的 MSIX

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

  1. 本地计算机:受信任的人员
  2. 本地计算机:建议不要 (根)

重要

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

通过从"开始"菜单进行搜索,可以轻松找到计算机证书管理工具:

通过"开始"菜单查找本地计算机证书工具

成功导入签名证书后,重新运行应用安装程序会显示包受信任且可安装:

使用受信任的证书签名的 MSIX

未安装依赖项

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

重要

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

无法访问文件

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

  • .appinstaller 文件,以 application/xml
  • .appx``.appxbundle和 文件,以application/vns.ms-appx

应用安装失败并出现错误消息:参数不正确

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

隔离应用安装程序应用问题

如果应用安装程序安装应用,这些步骤将有助于识别安装问题。

验证应用包文件安装

  • 将应用包文件下载到本地文件夹,然后尝试使用 Add-AppxPackage PowerShell 命令安装它。

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

应用安装程序事件日志

应用部署基础结构发出日志,这些日志通常可用于通过以下方法调试安装Windows 事件查看器:Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server