XCode 5：文档查看器仅显示“Xcode中的新功能”

Question

当我在XCode 5中选择“帮助 - ＆gt;文档和API参考”时，文档查看器窗口中显示的唯一内容是“Xcode中的新功能”注释。我看不到任何方式来浏览或加载任何实际的API文档内容。

我检查了〜/ Library / Developer / Shared / Documentation / DocSets文件夹并验证了iOS5 - iOS7的文档集。重新安装XCode 4.6.3后，我还验证了文档内容可以在旧的Organizer帮助中看到。

我宁愿不让XCode 4只是为了离线阅读文档;如何强制XCode 5加载本地文档集？

Answer 1

你试过Dash ......？这将允许您离线阅读文档并下载Mac / iOS文档集：http://kapeli.com/dash

仅供参考我不是开发人员，只是用户。

Answer 2

简短回答：

似乎只搜索文档是唯一的选择。右侧边栏是仅适用于当前文档的索引（在本例中为“Xcode中的新功能”）。文档在那里并且对Xcode 5可见，但它似乎没有暴露出直接浏览它们的方法。

答案很长：

在我看来，您必须搜索文档而不是能够浏览它。例如，使用默认搜索设置（“自动”上的放大镜），搜索“Mountain Lion”（不突出显示自动完成条目）将显示搜索页面，而SDK指南下将是“OS X Mountain”条目狮子v10.8“。右侧边栏将变成“OS X中的新功能”类别的浏览器。这似乎是“浏览”文档的唯一方法。即使使用View-＆gt; Show Tab Bar并打开新标签页也只会打开一个空白页。

Apple Developer页面"New Features in Xcode 5"包含有关新文档查看器的信息。说明听起来与在线图书馆的工作方式类似，如果当前文档有多个部分，它将显示当前打开的文档的目录。例如，我链接的页面是文档“Xcode中的新功能”的一部分。链接页面和查看应用程序都没有迹象表明有一种方法可以浏览Xcode 4中的类别。

Xcode 5 release notes确实说您可以像以前一样将文档存储在DocSets文件夹中。

在线开发人员库仍然只有极少量的导航。就离线文档而言，Apple提供的.docset文件在Show Package Contents中存储了相同的界面 - ＆gt;内容/资源/文件/导航/ index.html的。如果您使用Xcode文档窗口中的“共享”按钮在Web浏览器中打开页面（我在使用Safari时比Chrome 31好得多），您可以单击左上角的Mac / iOS Developer Library链接的网页。在Safari中，这将打开位于DocSet文件夹中的一个DocSet中的Finder窗口。然后，您可以转到导航文件夹并打开index.html（Safari加载了这个，而Chrome坐下并旋转）以获得与在线库相同的界面。

希望旧类别浏览得到重新实现（或有人重新发现如何查看它）。与此同时，开始制作和使用书签（文章标题/部分旁边的灰色标记）可能会有所帮助，并使用“文档”窗口的左侧边栏进行浏览。主项目窗口的右侧边栏还有一个快速帮助（带有波浪线的框）可能有一些用处，Xcode 5中的功能说它可以显示来自代码的Doxygen或HeaderDoc样式文档注释。

Answer 3

您必须将设置菜单（Xcode＆gt;偏好设置...）转到下载选项卡。在那里，您可以选择所需的文档（iOS，Xcode，OSX，...）

Answer 4

令人失望的是Treeviewer似乎已经消失了，因为我曾经喜欢浏览所有主题并偶然发现一些有趣的东西。

最接近的解决方法 - 各种 - 我来到（在上面直接在safari中浏览文档集的建议之外，如果你在safari上设置书签可以工作）是选择一个非常小的搜索词并选择“全部显示”结果”。你仍然没有得到所有东西，但它总比没有好。

我希望他们把它带回来，但也许逻辑是他们试图引导人们访问网站上的文档。

Answer 5

我正在努力处理一些无关的问题（创建我自己的文档并实际在Xcode上查看），所以我最终在这个问题中弄乱了文档查看器。

这可能是我的Xcode版本中的新内容，或者我可能只是误解了你想要的东西，但我可以通过按下这个按钮来访问文档的树结构：