Obfuscar项目中的PCL库混淆后引用mscorlib 4.0问题解析

问题背景

在使用Obfuscar混淆工具处理可移植类库(PCL)时，开发者可能会遇到一个棘手的问题：混淆后的PCL库会意外添加对mscorlib 4.0的引用，导致该库无法在目标PCL项目中正常使用。本文将深入分析这一问题的成因，并提供详细的解决方案。

问题现象

当开发者使用Obfuscar混淆一个简单的PCL库后，尝试在另一个PCL项目中引用该混淆后的库时，会出现编译错误。错误信息明确指出混淆后的库间接依赖了mscorlib 4.0，而目标PCL项目无法解析这个依赖关系。

根本原因

经过分析，这个问题主要由两个因素导致：

1. 字符串隐藏功能：当启用HideStrings选项时，Obfuscar会引入对mscorlib 4.0的依赖。

2. ILDASM抑制属性：Obfuscar默认会为混淆后的程序集添加SuppressIldasmAttribute属性，这个操作也会意外引入对mscorlib 4.0的引用。

解决方案

临时解决方案

对于无法立即升级Obfuscar版本的用户，可以采用以下临时解决方案：

1. 禁用字符串隐藏：在配置文件中将HideStrings选项设置为false

   <HideStrings>false</HideStrings>
   

2. 禁用ILDASM抑制：在配置文件中将SupressIldasm选项设置为false

   <SupressIldasm>false</SupressIldasm>
   

永久解决方案

建议升级到Obfuscar 2.0 RTW(rc7)或更高版本，这些版本已经修复了相关问题：

1. 修复了字符串隐藏功能导致的mscorlib引用问题
2. 修复了ILDASM抑制属性导致的mscorlib引用问题

技术细节

PCL库设计用于跨平台使用，它们对引用的程序集版本有严格要求。当混淆工具无意中引入对特定版本mscorlib的依赖时，就会破坏PCL的可移植性。Obfuscar团队通过以下方式解决了这个问题：

1. 改进了字符串隐藏功能的实现方式，避免引入不必要的依赖
2. 优化了ILDASM抑制属性的添加逻辑，确保不会影响PCL的兼容性

最佳实践

对于PCL库的混淆，建议：

1. 始终使用最新版本的Obfuscar
2. 在混淆前备份原始程序集
3. 测试混淆后的库在所有目标平台上的兼容性
4. 优先使用Obfuscar的默认配置，除非有特殊需求

通过遵循这些建议，开发者可以确保PCL库在混淆后仍能保持其可移植性，同时获得必要的代码保护。