如何设置“Xcode 文档”（用于 Xcode 5）

Posted 2023-03-08

【中文标题】如何设置“Xcode 文档”（用于 Xcode 5）

【英文标题】：How to setup "Docs for Xcode" (for use with Xcode 5)

【发布时间】：2013-10-12 22:36:05

【问题描述】：

新手，

第一次获得 xcode 5。我的理解是，xcode 5 不允许来自第三方的文档，但有一种解决方法是使用应用商店中名为 Docs for Xcode 的应用。然而具有讽刺意味的是，“Docs for Xcode”没有文档，所以我不确定如何设置它。

到目前为止，这是我想出的：

在您选择要保存哪个文件夹“Docs for Xcode”的初始设置之后 访问 cocoadocs.org 搜索您要查找的库 点击右上角的xcode标志 点击添加到xcode 您的浏览器会将其导入“Docs for Xcode”中

但是，我还没有弄清楚如何让 Xcode 查看“Docs for Xcode”保存到的目录。有人知道吗？

【参考方案1】：

反之亦然，您需要授予对 Xcode 文件夹（即~/Library/Developer/Shared/Documentation/DocSets/）的访问权限。这应该在授予访问权限时预先选择。

（我在 1.0.3 中更清楚地说明了这一点，很抱歉造成混淆。）

【讨论】：

~/Library 已隐藏，不会显示在Please click Grant Access 对话窗口中。在终端窗口中执行chflags nohidden ~/Library 以便能够深入了解它。您还需要在终端窗口中创建完整的目录树。

@gone：这不是真的。它确实显示了很多（如果您将 NSOpenPanel 指向子文件夹，则隐藏 ~/Library 无关紧要！）如果 DocSets 已经存在（如果不存在，则不能“钻入~/Library”来选择它，因为它不存在）。这就是为什么该应用程序会指导您如何创建目录，并使用要使用的确切命令，如果您的 Xcode 安装如此新鲜以至于其中还没有 Apple 文档集更新（首先很少发生）。

简单地说，~/Library 无法在“授予访问权限”对话框中钻取，因此我无法访问所需的文件夹。在我使用 chflags 之后，它运行良好，但我必须创建一些子文件夹。

@gone 同样，如果 DocSets 文件夹已经存在，您将不会有“深入研究”。该应用程序将为您预选 子文件夹，不管 ~/Library 隐藏状态。 ~/Library 是隐藏的，只有在查看 ~ 时才有意义——如果 DocSets 存在，你永远不必这样做，因为你更深了几个层次。这就是 Finder 和 NSOpenPanel 的工作原理。你显然不相信我，但是好吧：试试看！

我已经描述了我需要执行的步骤。说得够多了。