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

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

如果你已选择加入我们的 预览体验计划，请确保拥有正确版本的 MSIX 打包工具：

如果你有兴趣加入我们的预览体验计划， 请单击此处。

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

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

如果已下载驱动程序并在包转换过程中遇到问题，则可能是以下问题之一。

以下错误代码可能表明你遇到了连接问题：

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

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

在这种情况下，MSIX 打包工具会在错误消息和日志中通知你驱动程序需要重启。 重启计算机，然后再次开始转换以解决此问题。

如果在转换过程中收到此错误，则检查日志文件时，应找到如下所示的条目：

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

当该工具启动新的系统事件跟踪会话，但已超出 Windows 可以创建的最大会话数时，会发生此错误。 如果超出默认限制 (64) 将遇到ERROR_NO_SYSTEM_RESOURCES错误，从而导致驱动程序失败。

解决方案是通过以下步骤停止某些现有事件跟踪会话：

现在，可以再次尝试使用 MSIX 打包工具执行转换。

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

如果使用低于 1.2019.701.0 的 MSIX 打包工具版本转换现有安装程序，则该工具已对其强制实施 Microsoft Store 版本控制要求，或使用其他工具创建未将最低版本设置为 10.0.16299.0 的包， (Windows 10版本 1709) 。 将应用部署到 Windows 10 版本 1709 或更高版本时，这将导致错误消息。

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

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

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

如果在使用远程 VM 进行转换时遇到问题，请参阅 远程计算机转换的设置说明。

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

请确保按照以下步骤操作，并在适用于企业的 Microsoft Store中分配适当的角色。

可以使用 批处理转换脚本来辞职应用。

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

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

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

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

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

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

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

该文件可能已打开或不存在。 若要解决此问题，请添加相应的文件或关闭当前正在使用的文件。 请注意，如果它处于打开状态，则不会收到 File not Found 错误。 相反，你会收到 Access Denied 或 File in Use 错误。

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

MSIX 打包工具将捕获所有用户级别的快捷方式以及参数。 如果未正确检测到这些快捷方式，可以将其手动添加到清单。 有关详细信息 ，请参阅 desktop7：Shortcut 。

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

可以使用包支持框架写入来安装目录修补程序来解决此问题。 默认情况下，我们在 MSIX 工具中将此功能添加为一项功能，这允许将其降到 1809。 如果应用程序在 1709 年不工作，并且位于 1809 年，则可能是问题。

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

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

注意

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