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

Question

是否有一个插件或其他方式让XCode 5使符号导航器更有用,只显示当前类并使#pragma标记看起来好像我们点击跳转条？

所有这一切的重点在于我们不必单击跳转条,导航器始终显示为右侧面板上的选项卡.

在我看来,左侧面板上的默认符号导航器很弱.

见附图.

编辑:我自己最终创建了插件.您可以从以下网址下载:https://github.com/zolomatok/ZMDocItemInspector

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

Answer 1

不是我所知道的,而是一些可能让你的生活更轻松的技巧:

1. 按control+ 6可快速显示弹出的文档项(方法名称和编译指示列表).

2. 顺便说一句,当这个问题出现时,很多人都不知道你可以开始输入,它也会在弹出窗口中进行搜索,修剪出与你输入的内容不匹配的项目.

3. 您可能需要考虑使用符号导航器,您可以通过按command+ 2或通过点击导航面板中的第二个选项卡来上拉:

   

4. 另一个很棒的工具是Quick Open(shift+ command+ O(这就是字母"哦")).

5. 代码折叠也是一种快速折叠代码的方法,因此您可以快速导航到特定的例程.你可以按shift+ option+ command+ left arrow快速折叠你的所有代码,滚动到你需要的东西,然后展开(全部或只是那个例程).

6. 稍微复杂一些,但您可以使用文档系统.我用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的本机帮助系统中.通过在代码中插入这些注释,Xcode 5现在会自动在快速帮助窗口中显示方法的文档,就像它对Cocoa类一样.

   在回答您能够看到整个类层次结构的问题时,使用appledoc可以构建和安装可以在Xcode的文档浏览器中显示的"docset"(在Xcode 4.x的Organizer中,在单独的Documentation窗口中) Xcode 5)导航到终端命令行中运行以下命令的项目文件夹:

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

   除了构建可在Xcode中查看的文档集之外,这些文档系统还允许您构建可能与第三方共享的文档(如果您需要这样做).Appledoc特别生成了一个类似Apple的HTML文档站点.例如,这是上述方法声明的文档.

   这个单独的"从命令行构建一个docset"并不像你想象的那样"加入",但我发现使用Xcode 5内置的文档解析,我个人整合了我的文档.我的开发过程中的代码.(我很尴尬地说它曾经是我推迟到开发过程结束的那些事情之一.)

有关简化与Xcode交互的更多技巧,请参阅WWDC 2012视频使用Xcode或WWDC 2013视频Xcode Core Concepts 高效工作.