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

时间:2013-10-11 12:56:58

标签: xcode plugins xcode5 symbols

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

所有这一切的重点是我们不必单击跳转栏,导航器总是显示为右侧面板上的选项卡。

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

见附图。

编辑:我最终自己创建了这个插件。您可以在https://github.com/zolomatok/ZMDocItemInspector

下载

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

enter image description here

1 个答案:

答案 0 :(得分:17)

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

  1. control + 6 以快速显示弹出的文档项(方法名称和编译语标记列表)。

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

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

    enter image description here

  4. 另一个很棒的工具是快速打开( shift + 命令 + O (这就是字母“哦”))。< / p>

  5. 代码折叠也是一种快速折叠代码的方法,因此您可以快速导航到特定的例程。您可以按 shift + 选项 + 命令 + 左箭头快速折叠所有代码,滚动到你需要,然后展开(全部或只是那个例程)。

  6. 稍微复杂一些,但您可以使用文档系统。我使用appledoc。您可以在代码中添加符合HeaderDocDoxygen格式的注释。因此,请考虑以下方法声明:

    /** 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中的管理器中) ,在Xcode 5的单独文档窗口中,导航到终端命令行中运行以下命令的项目文件夹:

      

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

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

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

  7. 有关简化与Xcode交互的更多技巧,请参阅WWDC 2012视频Working Efficiently with Xcode或WWDC 2013视频Xcode Core Concepts