Xcode4 如何填充Xcode 4“;选项+;点击";爆米花?

Xcode4 如何填充Xcode 4“;选项+;点击";爆米花?,xcode4,Xcode4,在Xcode 4中,如果option+单击某个关键字,则该关键字将显示在一个弹出窗口中,其中包含一组描述性信息,如下所示: 但是,当我option+单击我自己的方法或变量时,我得到的只是一个指向声明对象的文件的链接: 这是如何做到的?我可以利用这一点编写自己的代码吗? (我注意到在一些框架标题中,有一些特殊的注释语法。这可能相关吗?您必须为API创建自己的“文档集”。在Xcode的文档中搜索“文档集指南”并深入研究。本指南的“文档集”部分特别说明了“快速帮助”使用此功能 设置好文档后,此弹出

在Xcode 4中,如果option+单击某个关键字,则该关键字将显示在一个弹出窗口中,其中包含一组描述性信息,如下所示:

但是,当我option+单击我自己的方法或变量时,我得到的只是一个指向声明对象的文件的链接:

这是如何做到的?我可以利用这一点编写自己的代码吗?

(我注意到在一些框架标题中,有一些特殊的注释语法。这可能相关吗?

您必须为API创建自己的“文档集”。在Xcode的文档中搜索“文档集指南”并深入研究。本指南的“文档集”部分特别说明了“快速帮助”使用此功能


设置好文档后,此弹出窗口不仅可以找到描述,还可以在实用程序窗格的QuickHelp以及组织者的文档浏览器中找到描述。

从Xcode 5.0开始,变量和方法的Doxygen和HeaderDoc格式将自动解析并在Quick Help弹出窗口中呈现。更多信息,但这里有一些关键点:

/**
 * Add a data point to the data source.
 * (Removes the oldest data point if the data source contains kMaxDataPoints objects.)
 *
 * @param aDataPoint An instance of ABCDataPoint.
 * @return The oldest data point, if any.
 */
 - (ABCDataPoint *)addDataToDataSource:(ABCDataPoint *)aDataPoint;
在Xcode中呈现为:

至于属性,它非常简单:

/// Base64-encoded data.
@property (nonatomic, strong) NSData *data;
单击选项时,将显示此可爱的弹出窗口:


我已经对此进行了一些研究,你说的没错。请继续关注它。非常酷,这看起来很不简单,但看起来很棒!太糟糕了,苹果没有将其内部文档工具作为Xcode工具的一部分发布。然后,我再次听说它可能无法通过开发者社区的审查(阅读“可能需要大修”):-)@约书亚诺兹,呵呵。我听到了。当您在文件本身中时,这可以很好地工作(如图所示)。但是,如果您正在处理另一段使用该类的代码,那么单击选项似乎会丢失文档。我错过什么了吗?有没有办法让文档在整个过程中填充?