首页
/ Harmony 2.3.6版本发布:修复兼容性问题与功能增强

Harmony 2.3.6版本发布:修复兼容性问题与功能增强

2025-06-10 14:21:45作者:温玫谨Lighthearted

Harmony项目简介

Harmony是一个强大的.NET库,主要用于在运行时对现有方法进行修改和扩展,实现方法拦截和补丁功能。它广泛应用于游戏模组开发、企业应用扩展等场景,为开发者提供了在不修改原始代码的情况下改变程序行为的能力。

2.3.6版本核心改进

关键修复:二进制兼容性问题

2.3.5版本中存在的二进制兼容性问题在此版本中得到了彻底修复。这个问题可能导致在某些情况下方法调用出现异常,特别是在处理特定类型转换时。开发团队对此表示歉意,并建议所有使用2.3.5版本的用户尽快升级到2.3.6版本。

方法委托增强

MethodDelegate功能得到了显著增强,现在支持:

  • 值类型与对象类型之间的互换
  • 在值类型上允许对第一个参数使用ref关键字

这一改进使得方法委托在处理不同类型参数时更加灵活,特别是在处理值类型和引用类型转换的场景下。

代码匹配器改进

CodeMatcher类新增了InsertAfter方法,为代码注入提供了更多控制选项。同时,异常处理机制得到了优化,使得在代码注入过程中出现问题时能够提供更清晰的错误信息。

类型处理优化

对于TypeCode.DateTimeTypeCode.Decimal类型,现在使用更合适的指令进行处理,提高了类型转换的准确性和效率。

性能提升

AccessTools.TypeByName()方法的性能得到了显著提升,通过优化类型查找算法减少了查找时间。同时新增了AccessTools.TypeSearch()方法,为类型搜索提供了更多选择。

参数处理修复

修复了在处理__args参数与out bool参数组合时的bug,确保了参数传递的正确性。这一修复特别影响那些使用动态参数传递的高级补丁场景。

开发者注意事项

  1. 从2.3.5升级时,需要注意二进制兼容性问题的修复可能会影响某些特定场景下的方法调用行为。

  2. 新增的InsertAfter方法为代码注入提供了新的可能性,开发者可以更灵活地控制注入位置。

  3. 在处理DateTime和Decimal类型时,新的指令处理方式可能会影响现有补丁的行为,需要进行测试验证。

  4. 性能优化后的类型查找方法可以显著提升大型项目中的补丁加载速度。

总结

Harmony 2.3.6版本虽然是一个修复版本,但带来了多项重要改进和功能增强。从二进制兼容性修复到性能优化,再到新功能的添加,这个版本为开发者提供了更稳定、更高效的补丁开发体验。建议所有使用Harmony的开发者评估升级的必要性,特别是那些遇到2.3.5版本兼容性问题的项目。

登录后查看全文
热门项目推荐
相关项目推荐