9

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

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

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

见附图。

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

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

在此处输入图像描述

4

1 回答 1

18

不是我所知道的，而是一些可能使您的生活更轻松的技术：

  1. 按control+6快速弹出该文档项（方法名称和编译指示标记列表）。

  2. 顺便说一句，当它启动时，很多人不知道您可以直接开始输入，它还会在该弹出窗口中进行搜索，删除与您输入的内容不匹配的项目。

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

    在此处输入图像描述

  4. 另一个很棒的工具是快速打开（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 的文档浏览器中显示该“文档集”（在 Xcode 4.x 的 Organizer 中，在单独的文档窗口中Xcode 5) 通过导航到项目的文件夹，在终端命令行中运行以下命令：

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

    除了构建可以在 Xcode 中查看的文档集之外，这些文档系统还允许您构建可能与第三方共享的文档（如果您需要这样做）。Appledoc 尤其会生成一个非常像 Apple 的 HTML 文档站点。例如，这里是上述方法声明的文档。

    这个单独的“从命令行构建文档集”并不像您设想的“插件”那么巧妙，但我发现通过 Xcode 5 的内置文档解析，我个人集成了我的文档我的开发过程中的代码。（我很尴尬地说，它曾经是我推迟到开发过程结束的那些事情之一。）

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

于 2013-10-11T13:35:46.960 回答