在断开环境中使用 MSIX 打包工具

 MSIX 打包工具已知问题与故障排除技巧 - MSIX |Microsoft Learn

 

MSIX 封装工具已知问题及故障排除技巧

 

本文介绍了已知问题，并提供了在使用 MSIX 打包工具将应用转换为 MSIX 时需要考虑的排查建议。如果你需要在断开环境中获取MSIX封装工具或驱动程序，可以查看我们的其他文档。

已知问题

获取最新的 MSIX 打包工具 Insider 预览版本

如果您已选择加入我们的内部计划，请确保您拥有正确版本的MSIX打包工具：

• 进入MSIX打包工具中的“关于”部分查看你使用的版本。
• 点击这里确定最新的 Insider 预览版本，并确认你安装了该版本的 MSIX 打包工具。
• 确保注册的飞行MSA是登录Microsoft Store的账户。
• 通过你电脑上的Microsoft Store手动更新MSIX打包工具。如果你有这个选项，打开商店，进入“下载和更新”，点击获取更新。或者，搜索MSIX打包工具，在产品页面上你可以提示更新。
• 要安装 MSIX 打包工具以便离线使用，请按照以下说明确保通过我们的离线流程获得最新应用。

如果您有兴趣加入我们的内部人员计划，请访问“加入MSIX包装工具内部人士！”。

MSIX 打包工具驱动程序

MSIX 打包工具驱动程序作为 Windows Update 的按需功能包（FOD）提供。如果电脑上禁用了 Windows Update 服务，或者 Windows Insider 的飞行环设置与电脑的作系统版本不匹配，安装失败将会失败。

如果你在获取驱动时遇到困难，或者你在离线环境中工作，可以在这里找到下载驱动的链接。

如果你下载了驱动，但在转换包时遇到问题，可能是以下原因之一。

网络连接问题

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

• -2145107924（0x8024402c）
• -2145107945（0x80244017）
• -2145123272（0x80240438）

Windows Server Update Service（WSUS）、配置管理器或影响 Windows Update 连接的组策略

以下错误代码可能表明您的电脑上的策略正在影响 Windows Update 连接性：-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 版本管理要求

如果你使用MSIX打包工具版本中1.2019.701.0之前的版本转换现有安装程序，说明该工具开启了强制Microsoft商店版本要求，或者使用了未将最低版本设置为10.0.16299.0的工具来创建你的包（Windows 10，版本1709）。这将在将应用部署到Windows 10（版本1709或更高版本）时出现错误提示。

要解决这个问题，打开MSIX打包工具，通过包编辑器编辑你的应用。打开你的清单，将元素属性设置为“10.0.16299.0”。MinVersionTargetDeviceFamily

XML

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

MSIX 及服务

在MSIX打包工具1.2019.1220.0版本中，我们增加了创建带有服务的MSIX包的支持。由于作系统对服务支持的限制，MSIX 打包工具会自动将带服务的 MSIX 包中支持的最小版本更改为 10.0.19025.0。这意味着你不能在低于Windows 10 2004版本的作系统上安装包含服务的MSIX，但你可以使用MSIX打包工具创建该MSIX，直到Windows 10 1809。如果你需要在较低的作系统上安装这个应用，请适当更新最小版本，但请注意服务支持将无法生效。

框架与驱动

如果应用需要框架，确保在转换的监控阶段安装该框架。查看日志确认是否存在这种情况。如果你的应用需要安装驱动，你需要评估这是否是应用正常运行所必需的。MSIX 目前不支持驱动程序安装。

远程机器

如果你在使用远程虚拟机进行转换时遇到问题，请参见“远程机器转换设置说明”。

转换过程中的问题

• 有些安装人员可能会因退出代码259无法转换。这表明安装程序生成了一个线程，没有等待它完成。换句话说，主线程安装完成了，但因为生成了一个仍在运行的线程，导致错误259退出。我们建议您使用适合setup.exe的安装选项。

签约过程中的问题

不良PE证书（0x800700C1）

当包包含带有损坏证书的二进制文件时，就会出现这个问题。要解决这个问题，可以用命令导出文件头并检查有没有坏元素。手动重写头部以修复问题。一般来说，MSIX 打包工具会自动检测坏头。如果问题依旧，提交反馈。更多信息请见此处。dumpbin.exe /headers

设备保护签名

务必遵循这些步骤，并在Microsoft Store的商业应用中分配相应的角色。

证书过期

• 签包时使用时间戳。
• 你可以用有效的签名或时间戳证书重新签约。

你可以在MSIX Toolkit - Scripts中使用批处理转换脚本重新签约你的应用。

故障排除

日志文件

无论你的转换是否成功，每次转换都会生成日志文件。这些内容可以在这里找到：

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

故障代码会被编写，表示转换过程中的任何故障点。错误代码旨在用户友好。

来自远程设备或虚拟机的日志文件

如果转换是在远程设备或虚拟机上进行的，我们建议您从该设备复制日志文件，并将其作为反馈项的一部分附加。这将帮助我们更高效地诊断和解决问题。

你可以在这里找到远程转换的日志：%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

如果你能共享包含本地客户端和远程服务器作的整个日志文件夹，那会更有帮助。

常见问题

MakePri/Manifest 翻译错误

当包裹清单出现问题时，就会出现此错误。要找出问题，请进入包装编辑器并打开清单。打开清单后，你可以识别问题并提供正确的解决方案。

未找到文件

该文件可能已打开或不存在。要解决这个问题，可以添加相应的文件或关闭当前正在使用的文件。注意，如果它是打开的，你不会报错。相反，你会收到一个或错误。File not FoundAccess DeniedFile in Use

文件类型关联

关于文件类型关联（FTA）的问题因软件包而异。MSIX 打包工具支持双击安装的文件关联。例如，如果你的应用有上下文菜单，它不会自动添加，所以你需要手动添加到清单中。请参见 desktop4：FileExplorerContextMenus manifest 元素示例。

带参数的捷径

MSIX 打包工具会捕获所有用户级快捷键和参数。如果这些快捷方式检测不正确，你可以手动添加到清单中。详情请参见 desktop7：快捷方式。

安装目录

这种情况在使用备用硬盘进行应用转换时更为常见。如果你选择更改安装位置，它会改变所有文件的根地址。这意味着MSIX打包工具需要知道所有这些文件的去向，并在转换过程中被捕获。

你可以通过使用 Package Support Framework 的 write to install 目录修复来解决这个问题。我们在MSIX工具中默认添加了此功能，允许将其降至1809。如果你的申请在1709年不工作，而在1809年，这很可能就是问题所在。

发送反馈

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

1. 打开反馈中心或输入Windows + F。
2. 提供标题和复现问题的必要步骤。
3. 在类别中，选择应用并选择MSIX打包工具。
4. 附上与转换相关的日志文件。你可以在上面提供的文件夹中找到日志。
5. 如果可能的话，附加转换后的MSIX包。
6. 点击提交。

你也可以直接通过MSIX打包工具的设置中的反馈标签发送反馈。

 

在断开环境中使用 MSIX 打包工具

 

虽然我们让用户通过 Microsoft Store 轻松获取 MSIX 打包工具，但我们知道并非每个人都能访问 Store，或进入他们想要进行转换的互联环境。所以这个话题是关于在断开模式下使用这个工具。这里的信息仅适用于我们的公开发布;不包括我们的Insider项目发布。

获取MSIX打包工具

你可以在下方下载最新版本的离线套餐。

如果你在使用包装工具的离线副本时遇到问题，请下载下面的该工具的离线许可副本。

拿到离线版后，你可以使用把应用包和许可证添加到你的电脑上。

离线安装示例