如何在 MonoDevelop 中为 MonoTouch 项目生成 XML 注释？答案

【问题标题】：How do I generate XML comments for MonoTouch projects in MonoDevelop?如何在 MonoDevelop 中为 MonoTouch 项目生成 XML 注释？
【发布时间】：2011-04-13 04:26:14
【问题描述】：

当我使用 MonoDevelop 构建项目时，我似乎无法在我的 C# 代码中生成包含 cmets 的 XML 文件。

我已检查项目设置的“编译器”选项卡上的 Generate xml documentation 框，但在我的项目输出或源文件夹中的任何位置都没有看到 XML 文件。

我正在使用 Mono 10.2.1、MonoDevelop 2.4.2 和 MonoTouch 4

【问题讨论】：

标签： c# mono xamarin.ios monodevelop

【解决方案1】：

简答：MonoTouch 的 C# 编译器还不支持生成 doc cmets 文件。

长答案：MonoTouch 使用 smcs（Silverlight 配置文件）编译器，因为它基于 Silverlight 框架配置文件。在 Mono 2.10 之前，Mono 的 C# 编译器使用 System.Reflection.Emit 来生成 IL，这意味着它必须在它所针对的框架版本上运行。不幸的是，Silverlight 没有 XmlDocument 和编译器用于处理 XML doc cmets 的其他类，因此在编译器的 smcs 构建中禁用了这些功能。在 Mono 2.10 中，C# 编译器已移植到 IKVM.Reflection，它允许单个编译器（在“完整”框架上运行）以任何框架配置文件或版本为目标。但是，迁移还没有完成，旧版本的 smcs 现在仍然存在。这将在 Mono 的未来版本中得到修复。

【讨论】：

很高兴听到（和无赖）。谢谢迈克尔。

【解决方案2】：

我自己刚刚尝试过，对于一个名为“MonoSandbox”的项目，我最终在 bin\Debug 文件夹中的 exe 文件旁边找到了“MonoSandbox.xml”。

确定是构建成功了吗？

【讨论】：

是的，它的构建成功。我能够很好地运行代码。更具体地说，我正在尝试构建一个 MonoTouch 项目
@johnl1479：啊。之前可能值得一提。我怀疑 MonoTouch 部分与它有关，因为这可能是一个相当不同的构建步骤。
我会把它归因于我的 stackoverflow noob-ness