4

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

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

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

4

5 回答 5

4

简短的回答:

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

长答案:

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

Apple 开发人员页面“Xcode 5 中的新功能”包含有关新文档查看器的信息。描述听起来类似于在线图书馆的工作方式,如果当前文档有多个部分,它将向您显示当前打开的文档的目录。例如,我链接的页面是文档“Xcode 中的新功能”的一部分。从链接页面和查看应用程序来看,都没有迹象表明有一种方法可以像 Xcode 4 那样浏览类别。

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

在线开发人员库仍然有少量的导航。在离线文档方面,Apple 提供的 .docset 文件在 Show Package Contents -> Contents/Resources/Documentation/navigation/index.html 中存储了相同的接口。如果您使用 Xcode 文档窗口中的“共享”按钮在 Web 浏览器中打开页面(我在 Safari 上的运气比 Chrome 31 好得多),您可以单击左上角的 Mac/iOS 开发人员库链接的网页。在 Safari 中,这将打开位于 DocSet 文件夹中的一个 DocSet 中的 Finder 窗口。然后,您可以转到导航文件夹并打开 index.html(Safari 加载了这个,而 Chrome 则坐着旋转)以获得与在线库相同的界面。

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

于 2013-09-27T03:21:02.137 回答
4

您是否尝试过 Dash...?这将使您可以离线阅读文档并下载 Mac / iOS 文档集: http: //kapeli.com/dash

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

于 2013-09-26T10:33:49.873 回答
2

你必须去设置菜单(Xcode>首选项...),到选项卡下载。在那里你可以选择你想要的文档(iOS,Xcode,OSX,...)

于 2013-10-18T15:59:51.987 回答
1

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

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

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

于 2013-10-05T09:07:03.700 回答
1

我正在努力解决一些不相关的问题(创建我自己的文档并在 Xcode 上实际检查它),所以我最终遇到了这个问题并弄乱了文档查看器。

它可能是我的 Xcode 版本中的新内容,或者我可能只是误解了您想要的内容,但我可以通过按此按钮访问文档的树结构:

在此处输入图像描述

于 2014-01-14T19:19:29.107 回答