使用 ILMerge 的内化特性时要小心了

ILMerge 是个.NET 实用工具，可以将多个程序集合并为一个并将类型的可见性由 public 改为 internal。这么做的结果既有积极的一面，也有消极的一面，取决于用户如何使用生成的结果集。

如果开发者创建好了框架或应用，想将其与所有依赖的框架或库绑定起来以向用户隐藏这些内容，同时使得最终的框架易于安装与使用，那么 ILMerge 就是个不错的选择。可以通过命令提示符或编程的方式使用 ILMerge。其中一个可设定的属性是 Internalize，它用于隐藏类型信息，这是通过将这些类型变为 internal 实现的。

微软解决方案架构 MVP 与 NServiceBus 之父 Udi Dahan 曾使用过 ILMerge 将 NServiceBus 1.9 版的所有依赖绑定到一个结果集中，但他没有隐藏任何类型信息，这导致了如下后果：

在开发者使用 NServiceBus 时，所有第三方的类型都公开出来了。对于那些碰巧使用同样版本程序库的开发者来说，这没什么问题，但遗憾的是，使用 Castle 等程序库的开发者们非常挑剔所用的版本——这导致了版本冲突，也就是众所周知的“版本地狱”问题。

在 NServiceBus 2.0 中，Dahan 开始使用 Internalize 特性，但他认为并非所有类型信息都应该隐藏起来：

比如说，NServiceBus 在内部使用了 NHibernate 来持久化长期运行的进程（叫做 sagas），我们希望这种实现细节不要与开发者在 NServiceBus 上所进行的工作发生冲突。要想让 NHibernate 正常工作，它需要向配置环境，尤其是 NHibernate.Cfg.MappingSchema 命名空间中的所有类型公开某些类型信息。

某些用户想要访问绑定程序库的 API，但如果他们都是 internal，那就没法访问了。因此，最好不要改变某些类型的信息。一种可能的解决方案就像 NServiceBus 所做的那样，发布两个版本：一个面向一般用户，他们仅仅使用框架而已；另一个包含了核心二进制文件，面向那些想要完全控制框架的用户。

ILMerge 需要使用.NET Framework 2.0+，它可以合并所有的.NET 程序集，包括使用.NET 1.0/1.1 生成的程序集。该工具只能用在 Windows 上，并不支持 Rotor 和 Mono。

查看英文原文： Using ILMerge Internalization with Caution