XCode 5: 文档查看器只显示“Xcode的新特性”

4
当我在XCode 5中选择“帮助->文档和API参考”时,唯一显示在文档查看器窗口中的内容是“Xcode新功能”注释。我无法看到浏览或加载任何实际的API文档内容的方法。
我检查了~/Library/Developer/Shared/Documentation/DocSets文件夹,并验证了iOS5-iOS7的文档集存在。重新安装XCode 4.6.3后,我还验证了旧版组织者帮助中可以看到文档内容。
我不想再保留XCode 4只是为了离线阅读文档;如何强制XCode 5加载本地文档集?
5个回答

4

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

顺便提一下,我不是开发者,只是一个用户。


惊人的应用!强烈推荐。 - mts
1
看起来是个不错的应用,但考虑到它作为付费应用的成本,对于我的需求来说有些过头了。 - Admagistrator

4

简短回答:

似乎搜索文档是唯一的选择。右侧边栏仅适用于当前文档(在这种情况下为“Xcode中的新功能”)。文档可在Xcode 5中可见,但似乎没有公开直接浏览它们的方式。

详细回答:

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

苹果开发者页面 "Xcode 5中的新功能" 提供了有关新文档查看器的信息。该描述听起来类似于在线库的工作原理,如果当前文档有多个部分,则会显示当前打开文档的目录。例如,我链接的页面是“Xcode中的新内容”文档的一部分。从链接页面和应用程序的外观上看,没有迹象表明有浏览类别的方法,就像在Xcode 4中一样。

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

在线开发者库的导航仍然很少。就离线文档而言,苹果提供的.docset文件在Show Package Contents -> Contents/Resources/Documentation/navigation/index.html中存储了相同的接口。如果您在Xcode文档窗口上使用“分享”按钮将页面在Web浏览器中打开(我在Safari比Chrome 31上更好运),则可以单击网页左上角的Mac/iOS开发人员库链接。在Safari中,这将打开位于DocSet文件夹中的一个DocSets的Finder窗口。然后,您可以转到导航文件夹并打开index.html(Safari加载此文件,而Chrome则会旋转)以获得与在线库相同的界面。
希望旧的类别浏览得到重新实现(或有人重新发现如何查看它)。同时,开始制作和使用书签可能会有所帮助,这些书签是文章标题/部分旁边的灰色标志,并使用文档窗口的左侧边栏进行浏览。主项目窗口的右侧边栏还具有快速帮助(带有波浪线的框),可能会有所帮助,在Xcode 5中的功能说它可以显示来自代码的Doxygen或HeaderDoc样式的文档注释。

谢谢,这似乎是浏览/查看离线文档的唯一方法,而不必保留旧版本的XCode或使用第三方应用程序。 - Admagistrator

2

您需要前往设置菜单(Xcode>偏好设置...),然后到下载选项卡。在那里,您可以选择所需的文档(iOS、Xcode、OSX等)。


1
我在处理一些与之无关的问题(创建自己的文档并在Xcode上实际检查它),因此我最终来到这个问题并且与文档查看器一起搞砸了。
这可能是我的Xcode版本中的新功能,或者我可能只是误解了你的要求,但我可以通过按下此按钮来访问文档的树形结构:

enter image description here


谢谢,自从我发布原始问题以来,我还没有使用过Xcode 5文档查看器。我检查了一下,最新版本似乎又变得有点有用了。苹果似乎有意重新编写他们的应用程序,并发布缺少大量功能的版本(例如最新版本的iWork)。 - Admagistrator

1
很遗憾,Treeviewer似乎已经消失了,我曾经喜欢浏览所有主题并偶然发现有趣的东西。最接近的解决方法是选择一个极小的搜索术语并选择“显示所有结果”。虽然仍然无法获得全部内容,但总比没有强。我希望他们能把它带回来,但也许逻辑是他们试图引导人们查看网站上的文档。

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接