将 Facebook Docset 与 Xcode 集成答案

【问题标题】：Integrating Facebook Docset with Xcode将 Facebook Docset 与 Xcode 集成
【发布时间】：2012-10-15 23:38:17
【问题描述】：

所以我下载了最新的 3.1 Facebook iOS sdk，并在脚本下找到了我运行的 build_documentation.sh。它完成并生成了一个 com.facebook.Facebook-SDK-3_0-for-iOS.docset 文件。我试图让它与 XCode 很好地集成。我知道苹果文档可以创建显示在快速帮助面板中的文档。我自己的自定义文档效果很好。

有谁知道我必须做些什么才能获得与 Facebook 相同类型的文档集成？

编辑：我尝试根据here 的说明将文档集添加到相应的文件夹中并重新启动了 Xcode，但它没有工作

【问题讨论】：

将文档集复制到 ~/Library/Developer/Shared/Documentation/DocSets 在这里工作。也许检查 Console.app 是否有任何提示？
@Pfitz 无法从 Console.app 中找出任何内容，但 Dash.app 确实告诉我 Facebook SDK 文档缺少索引。我不知道这是否有帮助。

标签： ios xcode facebook appledoc

【解决方案1】：

如果您从包中安装 SDK，则不必自己生成文档集。

转到https://developers.facebook.com/ios
点击下载 SDK 按钮

【讨论】：

完美！这行得通。虽然我很想确切地知道安装是如何工作的，但无论如何都能完成工作！
@Endama 为什么直接从 .pkg 安装 Facebook 框架会起作用？它将它移动到 /Library/...，not 到 ~/Library/...（注意代表用户目录的“~”)
我真的不确定...我想我可能已将 Appledocs 配置为从 /Library 中提取？

【解决方案2】：

您可以通过以下方式获取 Facebook 文档工作：

使用提供的 shell 脚本构建 Facebook 文档
将 .docset 移至 /Library/Developer/Shared/Documentation/DocSets

如果它不起作用，您可能需要检查是否将文档集移至 ~/Library/Developer/Shared/Documentation/DocSets。这有时是错误的

为什么直接从 .pkg 安装 Facebook 框架会起作用？
它将其移动到 /Library/...，而不是 ~/Library/...

【讨论】：