InlineIL.Fody 开源项目教程

1. 项目的目录结构及介绍

InlineIL.Fody 项目的目录结构如下：

InlineIL.Fody/
├── InlineIL.Fody/
│   ├── Properties/
│   │   └── AssemblyInfo.cs
│   ├── FodyWeavers.xml
│   ├── ILWeaver.cs
│   ├── InlineIL.cs
│   ├── ModuleWeaver.cs
│   └── README.md
├── InlineIL.Tests/
│   ├── Properties/
│   │   └── AssemblyInfo.cs
│   ├── TestClass.cs
│   └── TestRunner.cs
├── InlineIL.sln
└── README.md

目录结构介绍

• InlineIL.Fody/: 包含项目的主要代码文件。

  • Properties/: 包含项目的属性文件，如 AssemblyInfo.cs。
  • FodyWeavers.xml: 项目的配置文件，用于指定 Fody 插件。
  • ILWeaver.cs: 包含 IL 编织器的实现。
  • InlineIL.cs: 包含内联 IL 的辅助类。
  • ModuleWeaver.cs: 包含模块编织器的实现。
  • README.md: 项目的说明文档。

• InlineIL.Tests/: 包含项目的测试代码。

  • Properties/: 包含测试项目的属性文件，如 AssemblyInfo.cs。
  • TestClass.cs: 包含测试类的实现。
  • TestRunner.cs: 包含测试运行器的实现。

• InlineIL.sln: 项目的解决方案文件。

• README.md: 项目的根目录下的说明文档。

2. 项目的启动文件介绍

项目的启动文件主要是 ModuleWeaver.cs，它负责在编译过程中对代码进行 IL 编织。以下是 ModuleWeaver.cs 的主要内容：

public class ModuleWeaver : BaseModuleWeaver
{
    public override void Execute()
    {
        // 执行 IL 编织的逻辑
    }

    public override IEnumerable<string> GetAssembliesForScanning()
    {
        // 返回需要扫描的程序集
        yield return "mscorlib";
        yield return "System";
        yield return "System.Core";
    }

    public override bool ShouldCleanReference => true;
}

启动文件介绍

• ModuleWeaver.cs: 这个文件定义了 ModuleWeaver 类，继承自 BaseModuleWeaver。它重写了 Execute 方法来执行具体的 IL 编织逻辑，并重写了 GetAssembliesForScanning 方法来指定需要扫描的程序集。

3. 项目的配置文件介绍

项目的配置文件是 FodyWeavers.xml，它用于指定 Fody 插件的配置。以下是 FodyWeavers.xml 的内容：

<?xml version="1.0" encoding="utf-8"?>
<Weavers>
  <InlineIL.Fody />
</Weavers>

配置文件介绍

• FodyWeavers.xml: 这个文件指定了使用 InlineIL.Fody 插件。在 <Weavers> 节点下，通过 <InlineIL.Fody /> 标签来启用该插件。

通过以上配置，Fody 在编译过程中会调用 InlineIL.Fody 插件对代码进行 IL 编织。