XCode:当前类的更好的符号导航器

Question

XCode 5是否有插件或其他某种方式通过仅显示当前类并显示#pragma标记(就像我们单击跳转栏一样)来使符号导航器更有用()？

所有这些的重点是我们不必单击跳转栏，导航器始终在右侧面板上显示为选项卡。

我认为左侧面板上的默认符号导航器功能较弱。

见所附图片。

编辑:我最终自己创建了插件。您可以在以下位置下载它:https://github.com/zolomatok/ZMDocItemInspector

如果您有兴趣编写自己的插件，这里有一个详细的教程可以帮助您:https://github.com/zolomatok/Creating-an-Xcode-plugin

Answer 1

我不知道，但是一些可以使您的生活更轻松的技术:

按Control + 6可以快速弹出该文档项(方法名称和实用标记列表)。

顺便提一下，很多人不知道您可以开始输入文字，它还会在该弹出窗口中进行搜索，删除与您输入的内容不符的项目。

您可能要考虑使用符号导航器，您可以通过按Command + 2或通过点击导航面板中的第二个选项卡来拉起它:

另一个很棒的工具是快速打开(shift + command + O(即字母“oh”))。

代码折叠也是一种快速折叠代码的方法，因此您可以快速导航到特定例程。您可以按shift + option + command +向左箭头快速折叠所有代码，滚动到所需的位置，然后展开(全部或仅显示该例程)。

稍微复杂一点，但是您可以使用一个文档系统。我使用appledoc。您可以在代码中放入符合HeaderDoc或Doxygen格式的注释。因此，请考虑以下方法声明:

/** Initialize `Download` operation, downloading from `url`, saving the file to `path`.
 *
 * The operation starts when this operation is added to an operation queue.
 *
 * @param url The remote URL of the file being downloaded.
 *
 * @param path The local filename of the file being downloaded. This should be the full path of the file (both the path and filename) and should be in a directory that the user has permission.
 *
 * If this `nil`, the filename will be taken from the `lastPathComponent` of the URL, and will be stored in the `Documents` folder.
 *
 * @return Download operation
 *
 * @see initWithURL:
 */

- (id)initWithURL:(NSURL *)url path:(NSString *)path;

该注释的结构是(a)以/**开头，而不仅仅是/*； (b)指定@param和@return描述。当您执行此操作时，可以将代码输入这些文档引擎中的一个，您将获得一组不错的文档。这也包括一个类层次结构。

但是，虽然大家都知道我们应该记录我们的代码，但是在Xcode 5中，我们这样做的理由更加具有说服力，因为我们的注释会自动实时地实时集成到Xcode的 native 帮助系统中。通过在代码中插入这些注释，Xcode 5现在可以像在Cocoa类中一样，在“快速帮助”窗口中自动为您显示方法的文档。

为了回答您可以看到整个类层次结构的问题，可以使用appledoc构建并安装一个“文档集”，该文档集可以在Xcode的文档浏览器中显示(在Xcode 4.x的Organizer中，在单独的Documentation窗口中)。 Xcode 5)，通过在终端命令行中运行以下命令导航到项目的文件夹:

appledoc --project-name MyApp --install-docset --output ../MyAppDocumentation .

除了构建可以在Xcode中查看的文档集之外，这些文档系统还使您可以构建可以与第三方共享的文档(如果需要的话)。特别是Appledoc会生成一个非常类似于Apple的HTML文档站点。例如，here's the documentation用于上述方法声明。

这个单独的“从命令行构建文档集”并不像您所设想的“插件”那样精巧，但是我发现利用Xcode 5的内置文档解析功能，我亲自集成了我的文档我的开发过程中的代码。 (我很尴尬地说，它曾经是我推迟到开发过程结束时要做的事情之一。)

有关简化与Xcode交互的更多技术，请参阅WWDC 2012视频 Working Efficiently with Xcode或WWDC 2013视频 Xcode Core Concepts。