是否有一个插件或其他方式让XCode 5使符号导航器更有用,只显示当前类并使#pragma标记看起来好像我们点击跳转条一样?
所有这一切的重点是我们不必单击跳转栏,导航器总是显示为右侧面板上的选项卡。
我认为左侧面板上的默认符号导航器很弱。
见附图。
编辑:我最终自己创建了这个插件。您可以在https://github.com/zolomatok/ZMDocItemInspector
下载如果您有兴趣编写自己的插件,这里有一个详细的教程帮助您:https://github.com/zolomatok/Creating-an-Xcode-plugin
答案 0 :(得分:17)
不是我所知道的,而是一些可能让您的生活更轻松的技巧:
按 control + 6 以快速显示弹出的文档项(方法名称和编译语标记列表)。
顺便说一下,当这个问题出现时,很多人都不知道你可以开始打字,它也会在弹出窗口中进行搜索,修剪出与你输入的内容不匹配的项目。
您可能需要考虑使用符号导航器,可以通过按命令 + 2 或通过点击导航面板中的第二个选项卡来提取:
另一个很棒的工具是快速打开( shift + 命令 + O (这就是字母“哦”))。< / p>
代码折叠也是一种快速折叠代码的方法,因此您可以快速导航到特定的例程。您可以按 shift + 选项 + 命令 + 左箭头快速折叠所有代码,滚动到你需要,然后展开(全部或只是那个例程)。
稍微复杂一些,但您可以使用文档系统。我使用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中的管理器中) ,在Xcode 5的单独文档窗口中,导航到终端命令行中运行以下命令的项目文件夹:
appledoc --project-name MyApp --install-docset --output ../MyAppDocumentation。
除了构建可以在Xcode中查看的文档集之外,这些文档系统还允许您构建可能与第三方共享的文档(如果您需要这样做)。 Appledoc特别生成了一个类似Apple的HTML文档站点。例如,here's the documentation用于上述方法声明。
这个单独的“从命令行构建一个docset”并不像你想象的那样“加入”,但我发现使用Xcode 5内置的文档解析,我个人集成了在我的开发过程中记录我的代码。 (我很尴尬地说,它曾经是我推迟到开发过程结束的那些事情之一。)
有关简化与Xcode交互的更多技巧,请参阅WWDC 2012视频Working Efficiently with Xcode或WWDC 2013视频Xcode Core Concepts。