如何避免自定义 Xcode 仪器的“不支持...平台”错误

Question

我有一个自定义 Xcode 工具，我在分析应用程序时一直（重新）使用它。我的标准工作流程是：

1. 打开仪器的项目并运行它（启动仪器调试会话）；然后
2. 分析我的目标项目，并查看我的自定义仪器的运行情况。

好的，没关系。

但是每次我想要分析应用程序时都执行第 1 步很麻烦。因此，我将其保存在 Instruments 中的“文件”»“另存为模板...”中以备将来使用。

但是当尝试使用该模板时（而不是运行那个单独的 Instrument 项目），我得到一个错误。对于 macOS 分析会话说：

[仪器名称]不支持macOS平台。

同样，对于 iOS 分析会话，它说：

[仪器名称]不支持iOS平台。

这是为什么？我需要做什么来指定自定义工具可以在哪些平台上使用？

---

我在 Big Sur 11.6 上使用 Xcode 13.0 (13A233)。

Answer 1

事实证明，这条错误消息“不支持 [macOS/iOS] 平台”具有误导性。在这种情况下，问题不是它不支持平台，而是根本没有正确安装仪器。

要安装自定义仪器以便随意重复使用，应打开仪器的项目并执行“产品”»“存档”，点击“分发内容”，然后选择“内置产品”：

这将构建一个 .instrdst 包。然后，您可以在 macOS Finder 中双击它进行安装：

安装后，如果需要，您可以再次使用模板来管理可在分析会话期间使用的仪器集合。例如，这是一个使用已安装的自定义仪器包的分析会话（在此示例中，说明了读写器模式的工作原理）：

但关键是，现在自定义的仪器包已经安装，您可以使用它，而无需在分析您的应用程序之前在 Xcode 中手动运行仪器。

---

请注意，此“不支持 [macOS/iOS] 平台”问题的解决方案是自定义仪器所独有的。它不应该与可能带有合法limitations 的工具混淆，以了解它可以使用哪些平台。有些仪器仅在特定平台上受支持。但在上述情况下，问题在于未正确安装自定义仪器，并且错误消息具有误导性。