做Agile.NET资源保护时，最容易忽略的不是开关在哪，而是资源到底属于主程序集、卫星程序集，还是依赖字符串名称和反射去取值。Agile.NET官方文档明确说明，资源加密针对的是程序集里的托管资源，运行时会按需解密并把资源数据流返回给调用方；同时它也提醒，若项目里有卫星程序集，做重命名时最好一并加入工程，让资源名同步更新。

　　一、Agile.NET资源保护怎么做

　　做资源保护时，不建议一上来把所有保护全开。更稳的做法是先把资源来源和加载方式理清，再决定是只开资源加密，还是要和重命名、合并一起配。

　　1、先把主程序集和资源相关程序集收齐

　　如果项目里除了主程序，还有本地化语言包或其他卫星程序集，先一起加入Agile.NET工程。官方说明里专门提到，卫星程序集最好一并纳入项目，这样资源名称在重命名过程中才能同步更新。

　　2、在Resource Encryption页开启资源加密

　　Agile.NET对这项能力的定义很直接，就是加密托管资源，调用时再解密并以流的形式返回给调用方。实际配置时，先勾选隐藏嵌入式敏感数据，再进入【Resource Encryption】页处理。

　　3、如果还要合并程序集先确定主次关系

　　Agile.NET官方写明，程序集合并发生在其他保护动作之前，而且次级程序集的保护设置会被忽略，最终以主程序集的设置为准。所以资源保护和合并一起用时，先把主程序集选对，再看资源是否仍按预期打进最终文件。

　　4、涉及反射或字符串取资源名时先做排除

　　官方在重命名文档里提醒，运行时异常很多都和反射有关，无法自动识别时应手工做排除，或者用ObfuscationAttribute指定哪些类型和成员不要混淆。资源若靠字符串名称、类型名或反射定位，这一步尤其要先做。

　　二、Agile.NET资源加载失败如何排查

　　资源加载失败时，不要先怀疑资源一定丢了。更常见的原因其实是资源名变了、卫星程序集没跟着保护包一起发布，或者合并后主次程序集关系设错了。

　　1、先分清是主程序集资源还是卫星程序集资源

　　微软文档说明，ResourceManager既可以从主程序集里的嵌入式.resources读取，也会按文化信息去找卫星程序集。先把资源来源分清，后面才知道该查主程序还是语言包目录。

　　2、多语言资源先查文化目录和卫星程序集命名

　　微软对卫星程序集的加载规则写得很明确，资源要放在对应文化名称的子目录里，卫星程序集名称和位置也要符合规则，否则运行时就会回退到默认文化，或者直接找不到目标资源。

　　3、做过重命名时先补查卫星程序集是否一起进工程

　　Agile.NET官方已经点明，重命名过程可能需要更新资源名称，尤其是资源名和类名、对象名存在绑定关系时更明显。若只保护主程序集，没有把卫星程序集一起带进去，资源加载失败就很常见。

　　4、做过合并时回头核主程序集和次级程序集设置

　　因为合并发生在其他保护动作之前，而且最终保护设置以主程序集为准，所以一旦主次顺序选错，或者把关键资源程序集当成普通次级程序集处理，发布后的资源解析路径就可能和原工程不一样。

　　5、字符串取资源和反射取资源要优先看排除规则

　　如果资源是通过字符串拼名称、反射找类型，或者和公开成员名绑定，重命名后最容易出错。官方建议这类场景要依赖排除规则或ObfuscationAttribute来约束混淆范围，排查时这一步要放前面。

　　三、Agile.NET资源发布流程怎么收口

　　资源问题反复出现，很多时候不是功能本身不支持，而是保护、合并、发布这几步口径没统一。把流程收紧以后，后面换版本和补丁时会稳很多。

　　1、先固定保护顺序

　　要合并就先合并，再做后续保护，不要反过来处理。因为Agile.NET官方已经说明，合并天然发生在其他保护动作之前。

　　2、固定资源清单

　　每次发版前都核主程序集、卫星程序集和语言目录是否齐全，不要只看主程序能不能启动。微软的资源加载规则决定了这一步不能省。

　　3、固定排除策略

　　凡是依赖反射、公开成员名或字符串资源名的模块，统一提前列入排除或属性控制，别等到加载失败后再临时补。

　　4、先做受保护版本回归再发布

　　真正要验证的不是原始版本能不能取到资源，而是受保护、合并后的最终发布物还能不能在目标语言和目标路径下正常加载资源。这个顺序更符合Agile.NET和.NET运行时的实际加载链路。

　　总结

　　Agile.NET资源保护怎么做Agile.NET资源加载失败如何排查，关键不是单独开一个资源加密选项，而是把主程序集、卫星程序集、重命名、合并和反射加载这几层关系一起理顺。先把资源来源分清，再把相关程序集一起纳入工程，最后用排除策略兜住字符串和反射场景，资源保护和加载链路才更容易跑稳。