MSIX 打包工具的已知问题和故障排除提示

本文描述使用 MSIX 打包工具将应用转换为 MSIX 时存在的已知问题,并提供故障排除提示供用户参考。 如果需要在断开连接的环境中获取 MSIX 打包工具或驱动程序,请查看其他 文档

已知问题

获取 MSIX 打包工具的最新 Insider Preview 内部版本

如果已选择使用我们的会员计划,请确保具有正确版本的 MSIX 打包工具:

  • 转到 MSIX 打包 工具中的"关于"部分,查看你使用的版本。
  • 转到 此处 以确定最新的 Insider Preview 版本,并确认已安装该版本的 MSIX 打包工具。
  • 确保已注册进行航班飞行的 MSA 是登录到该Microsoft Store。
  • 通过计算机上手动Microsoft Store MSIX 打包工具。 如果此选项可用,请打开"应用商店",转到" 下载和更新",然后单击"获取 更新"。 或者,搜索"MSIX 打包工具",然后在产品页上提示其进行更新。
  • 若要安装 MSIX 打包工具供脱机使用,请按照这些说明操作,确保通过脱机过程获取最新应用。

如果有兴趣加入我们的会员计划,请单击此处。

MSIX 打包工具驱动程序

MSIX 打包工具驱动程序作为按需功能提供, (FOD) 包Windows 更新。 如果计算机上禁用了 Windows 更新服务,或者预览体验成员Windows设置与计算机的 OS 版本不匹配,则将无法安装。

如果在获取驱动程序时遇到问题,或在脱机环境中工作,可在此处找到下载驱动程序 的链接

如果已下载驱动程序,并且在包转换过程中发生问题,则可能是以下问题之一。

网络连接问题

以下错误代码可能指示你遇到连接问题:

  • -2145107924 (0x8024402c)
  • -2145107945 (0x80244017)
  • -2145123272 (0x80240438)

Windows服务器更新服务 (WSUS) 、Configuration Manager 或组策略影响 Windows 更新 连接

以下错误代码可能指示计算机上策略正在影响Windows 更新连接:-2145124306 (0x8024002e) 。

如果收到此错误代码,可能需要检查环境 设置和策略

驱动程序需要重新安装

在这种情况下,MSIX 打包工具将在错误消息中通知你,并记录驱动程序需要重启。 重新启动计算机并再次启动转换以解决此问题。

启动 MSIX 打包工具驱动程序驱动程序时0x80131500

如果在转换期间收到此错误,则检查日志文件时,应找到如下所示的条目:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

当工具启动新的系统事件跟踪会话,但你已超出可创建系统范围的最大会话Windows时,会发生此错误。 如果超过默认限制 (64) 将ERROR_NO_SYSTEM_RESOURCES错误,这将导致驱动程序失败。

解决方法是按照以下步骤停止一些现有的事件跟踪会话:

  1. 打开"开始"菜单并查找性能监视器。
  2. 右键单击它,然后选择"更多 - 以> 管理员角色运行"。
  3. 从树菜单中,选择"数据收集器集 -> 事件跟踪会话"。
  4. 右键单击列表中的某些现有会话,然后选择"停止"。

现在,可以重试使用 MSIX 打包工具执行转换。

最低版本

需要注意的一些功能会自动更改 MSIX 包中的微型名称版本支持。

强制执行 Microsoft Store 版本控制要求

如果使用低于 1.2019.701.0MSIX 打包工具版本转换现有安装程序,则该工具对 强制执行 Microsoft Store 版本控制要求,或者使用另一个工具创建未将最低版本设置为 10.0.16299.0 (Windows 10 版本 1709) 的包。 将应用部署到版本 1709 Windows 10版本时,这可能会导致错误消息。

若要解决此问题,请打开 MSIX 打包工具 ,并通过包编辑器 编辑应用。 打开清单,将 MinVersion 元素 TargetDeviceFamily 的 属性设置为"10.0.16299.0"。

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

具有服务的 MSIX

在 MSIX 打包工具版本 1.2019.1220.0 中,我们添加了对使用服务创建 MSIX 包的支持。 由于服务支持的 OS 限制,MSIX 打包工具会自动将包含服务的 MSIX 包中支持最低版本更改为 10.0.19025.0。 这意味着无法在低于 Windows 10 版本 2004 的 OS 上安装具有服务的 MSIX,但可以使用 MSIX 打包工具创建该 MSIX,Windows 10版本 1809。 如果需要在较低的 OS 上安装此应用,请适当更新最低版本,但请注意,对服务的支持将不起作用。

框架和驱动程序

如果应用需要框架,请确保在转换的监视阶段安装框架。 浏览日志以确保发生这种情况。 如果应用需要安装驱动程序,则需要评估应用正常运行是否需要此驱动程序。 MSIX 目前不支持驱动程序安装。

远程计算机

如果在使用远程 VM 进行转换时发现问题,请参阅远程 计算机转换的设置说明

转换期间的问题

  • 某些安装程序可能会转换失败并出现退出代码 259。 这表示安装程序衍生了一个线程,但未等待该线程完成。 换而言之,主线程已完成安装,但它衍生了一个仍在运行的线程,因此退出并返回了错误 259。 我们建议对 setup.exe 使用适当的安装选项。

签名期间的问题

错误的 PE 证书 (0x800700C1)

当包包含证书损坏的二进制文件时,会出现此问题。 若要解决此问题,请使用 命令 dumpbin.exe /headers 转储文件标头并检查是否有错误元素。 手动重写标头以解决此问题。 通常,MSIX 打包工具会自动检测错误的标头。 如果此问题仍然存在,请提交反馈。 可在此处找到详细信息。

Device Guard 签名

请确保按照这些步骤操作,并确保在角色中分配适用于企业的 Microsoft Store。

证书已过期

  • 对包进行签名时,请使用时间戳。
  • 可以使用有效的签名或时间戳证书重新签名。

可以使用批处理转换脚本 对应用进行转换

疑难解答

日志文件

不管转换是否成功,每次转换都会生成日志文件。 可在以下位置找到这些日志文件:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

将会写入故障代码,指示转换期间出现的任何故障点。 错误代码易于理解。

来自远程设备或 VM 的日志文件

如果在远程设备或 VM 上执行转换,我们建议复制该设备提供的日志文件,并将其附加为反馈项的一部分。 这有助于我们更有效地诊断和解决问题。

可在以下位置找到远程转换生成的日志:%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

如果可以共享整个 Logs 文件夹,该文件夹将包含本地客户端以及远程服务器上发生的操作,则更有利。

常见问题

MakePri/Manifest 转换错误

当包的清单出现问题时,会发生此错误。 若要确定问题,请转到"包编辑器"并打开清单。 打开清单时,可以识别问题并提供正确的修复。

找不到文件

该文件可能打开或不存在。 若要解决此问题,请添加相应的文件或关闭当前使用的文件。 请注意,如果打开,将不会 File not Found 收到错误。 相反,你收到 或 Access DeniedFile in Use 错误。

文件类型关联

与 FTA 的文件类型关联 (因) 包而异。 MSIX 打包工具支持双击安装的文件关联。 例如,如果应用具有上下文菜单,则不会自动添加它,因此需要手动将其添加到清单。 有关 示例,请参阅 desktop4:FileExplorerContextMenus 清单元素。

具有参数的快捷方式

MSIX 当前不支持具有参数的快捷方式。 如果检测到安装程序包含这些参数,MSIX 将创建一个没有参数的磁贴。

安装目录

对于使用辅助驱动器执行应用转换的人来说,这更常见。 如果选择更改安装位置,它会更改所有文件的根目录。 这意味着 MSIX 打包工具需要知道所有这些文件的去向,并且将在转换期间捕获这些文件。

可以通过使用包支持框架写入来安装目录修补程序来解决此问题。 在 MSIX 工具中,我们默认已添加此功能,该功能允许此功能降低至 1809。 如果应用程序在 1709 中未运行且在 1809 中,则可能是问题。

发送反馈

发送反馈的最佳方式是通过反馈中心。

  1. 打开“反馈中心”或按 Windows 键 + F
  2. 提供标题和必要的步骤以重现问题。
  3. 在“类别”下选择“应用”,然后选择“MSIX 打包工具”。
  4. 附加与转换相关的任何日志文件。 可以在上面提供的文件夹中找到日志。
  5. 附加转换的 MSIX 包(如果可能)。
  6. 单击“提交” 。

也可以直接在 MSIX 打包工具中向我们发送反馈,方法是转到“设置”下的“反馈”选项卡。

注意

可能需要等待 24 小时,我们才能收到你的反馈。 因此,如果使用 VM 来转换包,可能需要在转换后,持续打开 VM 并使其保持当前状态 24 小时。 此外,还可以手动将转换日志附加到反馈。