Xcode 5 文档窗口缺少 sdk 指南和示例的完整概述

Posted 2023-03-08

【中文标题】Xcode 5 文档窗口缺少 sdk 指南和示例的完整概述

【英文标题】：Xcode 5 documentation window missing a full overview of sdk guides and examples

【发布时间】：2013-09-20 19:16:34

【问题描述】：

我在新的 xcode 5 中查找 SDK 指南时遇到问题。我已经下载了供离线使用的文档，当我打开 xcode 文档的新窗口时，无法像以前那样查看所有指南和示例的列表.

【问题讨论】：

您究竟是如何准备文档的？你看到了什么？文档不再像以前那样在管理器中，它现在位于帮助菜单下。

alt+cmd+shift+?或者，如果我进入帮助菜单并选择文档和 API 参考。我看到一个类似于浏览器的窗口，我可以在其中输入搜索词和后退/前进按钮。下面有主文档视图和左右侧边栏。左侧边栏包含书签页面，右侧显示当前打开的参考或指南的索引。但是没有像 xcode 4 或 developer.apple.com ios 文档类型那样对所有指南和示例进行总体概述。

【参考方案1】：

是的，Ivan，Xcode 5 文档存在很多问题，包括您提到的那个。另一个例子：当你打开 Xcode 文档时，底部的 Provide Feedback 链接不起作用。 Xcode 5 文档中有很多断开的链接。最好的办法是为每个问题记录bug report with Apple。我知道记录错误需要时间 :( 但这似乎是唯一的方式。希望所有问题都能很快得到解决，以便开发人员可以提高工作效率。

【讨论】：

这很奇怪，因为它对我不起作用:(我也为此提出了一个错误 (#15048231)。Xcode 5 文档中也有一些损坏的链接。另一件令人沮丧的事情是：如果您在搜索框中搜索任何方法名称，然后在搜索建议下拉列表中单击正确的方法，即使这样，该方法的类名也会打开，而不是直接打开方法本身。我可以继续，但让我停下来在这里。我正在向 Apple 提出错误。可能还有其他人面临同样的问题。

确实有很多像书签一样的错误，当我标记任何书签时，它只会记住首页而不是我所指的部分。

还有另一个有趣的观察：如果我搜索任何东西（方法名称、属性等）而不下载离线文档，那么 Xcode 文档搜索总是会将我带到包含该方法的类页面的顶部，或者财产。但是后来我下载了 iOS 文档集以供离线使用（Xcode Menu --> Preferences --> Downloads），现在当我搜索任何方法或属性时，会直接路由到方法或属性而不是类页面的顶部。万岁！！

【参考方案2】：

您需要的所有文档都在 Xcode 5 中的 alt+cmd+shift+? 下，而不是 cmd+shift+2。

【讨论】：

我以前知道那个快捷方式，我以前一直在使用它进行搜索，但是现在当它打开时，您并没有像以前那样列出所有指南，可以访问和浏览它们.我现在只能选择进行搜索，并且只有与该搜索相关的结果列表。这张图片上的东西link

现在，如果您输入“核心数据起点”，最热门的是“音频转换器服务参考”，正确的结果排在第 7 位。我在另一台我有 xcode 4 的机器上尝试了它，它返回正确的搜索，但我从不搜索它，因为我可以到框架 - > coredata 并找到我需要的东西。他们在他们的网站 developer.apple.com 上仍然有旧的方式，所以我希望他们不要从那里删除它。

【参考方案3】：

您可以参考在线文档：

https://developer.apple.com/library/mac/navigation/

（我也希望苹果能尽快解决这个问题）

【讨论】：

不幸的是，这就是目前可用的全部内容，但这不是一个好的工作流程，因为我喜欢让我的所有文档离线，这样我就可以在没有任何互联网连接的情况下处理我的应用程序，包括本地运行的网络服务。

【参考方案4】：

我还将向 Apple 提交有关此问题的错误报告。这是 Apple 文档的倒退。 Xcode 4.x 更适合获取编程指南并找到很酷的东西。现在你必须知道你正在寻找的方法和属性。不酷。

【参考方案5】：

解决方案： 删除 xCode 首选项文件：

com.apple.dt.Xcode.plist
com.apple.dt.Xcode.LSSharedFileList.plist
(and any other xCode related files)

在 ~/Library/Preferences/

然后重启 xcode。

【讨论】：

Maverick 更新后Bug 再次出现，但之前的解决方案不再起作用