一个.NET Core下的开源插件框架

    插件模式历史悠久，各类中大型软件基本上都会实现插件机制，以此支持功能扩展，从开发部署层面，插件机制也可实现功能解耦，对于并行开发、项目部署、功能定制等都有比较大的优点。

    在.NET Core下，通常咱们基于.NET Core扩展库进行开发，一般使用依赖注入、配置、设置（Options）等机制，若是将插件模式与依赖注入、配置、设置进行结合，将能够提供很是灵活的扩展机制。基于此，咱们实现了一个开源的插件框架，本文将进行简单的介绍。

目录

• 目录
  • 1、PluginFactory插件库
  • 2、主要概念
  • 3、使用向导
    • 1）安装
    • 2）在主程序中启用
      • 1. 经过IHostBuilder的UsePluginFactory方法启用插件库
      • 2. 经过IServiceCollection的AddPluginFactory方法启用插件库
    • 3）编写插件
    • 4）插件启动
    • 5）编写支持初始化的插件
    • 6）使用插件配置
    • 7）插件化 ASP.NET Core

1、PluginFactory插件库

• 项目地址：
  • Gitee
  • Github
• Nuget包：
  • Xfrogcn.PluginFactory 实现包，在主项目中引用
  • Xfrogcn.PluginFactory.Abstractions 抽象包，在插件项目中引用，或者你能够彻底从新实现本身的插件机制
• 主要功能：
  • 插件的自动载入
  • 经过插件的初始化接口可以让插件控制主应用的依赖注入
  • 插件的启动及中止，此机制可与.NET Core的Hosting扩展结合，在宿主启动时自动启动插件
  • 抽象分离，你能够经过实现Xfrogcn.PluginFactory.Abstractions中的相关接口来彻底实现本身的插件载入、启动等机制
  • 与.NET Core配置、设置、宿主等完美融合
  • 支持插件依赖程序集的多版本载入

2、主要概念

• 插件载入器：对应IPluginLoader接口，负责从指定位置加载插件程序集
• 插件工厂：对应IPluginFactory接口，负责插件的实例化及插件的启动和中止
• 插件：对应IPlugin接口，全部插件须要实现此接口，实现插件的启动及中止机制
• 可初始化插件：对应ISupportInitPlugin接口，经过此接口能够在依赖注入Provider构建以前向容器注入自定义的服务
• 可配置插件：对应ISupportConfigPlugin接口，经过此接口可将插件配置与.NET Core的配置（Configuration）及设置（Options）机制集合

3、使用向导

    示例项目可参考：Xfrogcn.PluginFactory.Example Gitee地址 Github地址

1）安装

    在主程序项目中添加Xfrogcn.PluginFactory包

```dotnet
dotnet add package Xfrogcn.PluginFactory
```

    在插件项目中添加Xfrogcn.PluginFactory.Abstractions包

```dotnet
dotnet add package Xfrogcn.PluginFactory.Abstractions
```

2）在主程序中启用

    可经过如下两种方式来启用插件库，一是经过在Host层级的Use机制以及在依赖注入IServiceCollection层级的Add机制，如下分别说明：

1. 经过IHostBuilder的UsePluginFactory方法启用插件库

```c#
var builder = Host.CreateDefaultBuilder(args);
builder.UsePluginFactory();
```

    UsePluginFactory具备多个重载版本，详细请查看API文档
默认配置下，将使用程序运行目录下的Plugins目录做为插件程序集目录, 使用宿主配置文件做为插件配置文件（一般为appsettings.json）
你也能够经过使用带有 Assembly 或 IEnumerable<Assembly> 参数的版本直接传入插件所在的程序集

2. 经过IServiceCollection的AddPluginFactory方法启用插件库

```c#
var builder = Host.CreateDefaultBuilder(args)
    .ConfigureServices((hostContext, services) =>
    {
        services.AddPluginFactory();
    });
```

    AddPluginFactory具备多个重载版本，详细请查看API文档
默认配置下，将使用程序运行目录下的Plugins目录做为插件程序集目录

    注意： AddPluginFactory方法不会使用默认的配置文件做为插件配置，你须要显式地传入IConfiguration, 若是是在 ASP.NET Core 环境中，你能够在Startup类中直接获取到

3）编写插件

    插件是实现了IPlugin接口的类，在插件库中也提供了PluginBase基类，通常今后类继承便可。标准插件具备启动和中止方法，经过IPluginFactory进行控制。

    要编写插件，通常遵循如下步骤：

1. 建立插件项目（.NET Core 类库），如TestPluginA

2. 添加Xfrogcn.PluginFactory.Abstractions包

   ```nuget
    dotnet add package Xfrogcn.PluginFactory.Abstractions
    ```

3. 建立插件类，如Plugin，从PluginBase继承

   ```c#
    public class Plugin : PluginBase
    {
        public override Task StartAsync(IPluginContext context)
        {
            Console.WriteLine("插件A已启动");
            return base.StartAsync(context);
        }
   
        public override Task StopAsync(IPluginContext context)
        {
            Console.WriteLine("插件A已中止");
            return base.StopAsync(context);
        }
    }
    ```

   启动或中止方法中可经过context中的ServiceProvider获取注入服务

4. 经过PluginAttribute特性设置插件的元数据

   ```c#
    [Plugin(Alias = "PluginA", Description = "测试插件")]
    public class Plugin : PluginBase
    {
    }
    ```

   插件元数据以及插件载入的插件列表信息能够经过IPluginLoader.PluginList获取

4）插件启动

    IPluginFactory自己实现了.NET Core扩展库的IHostedService机制，故若是你是在宿主环境下使用，如（ASP.NET Core）,插件的启动及中止将自动跟随宿主进行
若是未使用宿主，可经过获取IPluginFactory实例调用相应方法来完成

```c#
// 手动启动
var pluginFactory = provider.GetRequiredService<IPluginFactory>();
await pluginFactory.StartAsync(default);
await pluginFactory.StopAsync(default);
```

5）编写支持初始化的插件

    在不少场景，咱们须要在插件中控制宿主的依赖注入，如注入新的服务等，这时候咱们可经过实现支持初始化的插件（ISupportInitPlugin）来实现，该接口的Init方法将在依赖注入构建以前调用，经过方法参数IPluginInitContext中的ServiceCollection能够控制宿主注入容器。

```c#
[Plugin(Alias = "PluginA", Description = "测试插件")]
public class Plugin : PluginBase, ISupportInitPlugin
{
    public void Init(IPluginInitContext context)
    {
        // 注入服务
        //context.ServiceCollection.TryAddScoped<ICustomerService>();
    }
}
```

6）使用插件配置

    插件支持 .NET Core 扩展库中的Options及Configuration机制，你只须要从SupportConfigPluginBase<TOptions>类继承实现插件便可，其中TOptions泛型为插件的配置类型。插件配置自动从宿主配置或启用插件工厂时传入的配置中获取，插件配置位于配置下的Plugins节点，该节点下以插件类名称或插件别名（经过PluginAttribute特性指定）做为键名，此键之下为插件的配置，如如下配置文件：

```appsettings.json
{
    "Plugins": {
        "PluginA": {
            "TestConfig": "Hello World"
        },

    }
}
```

    扩展PluginA实现配置：

1. 定义配置类，如PluginOptions

   ```c#
    public class PluginOptions
    {
        public string TestConfig { get; set; }
    }
    ```

2. 实现插件

   ```c#
    [Plugin(Alias = "PluginA", Description = "测试插件")]
    public class Plugin : SupportConfigPluginBase<PluginOptions>, ISupportInitPlugin
    {
   
        public Plugin(IOptionsMonitor<PluginOptions> options) : base(options)
        {
        }
   
        public void Init(IPluginInitContext context)
        {
            // 注入服务
            //context.ServiceCollection.TryAddScoped<ICustomerService>();
            Console.WriteLine($"Init 插件配置：{Options.TestConfig}");
        }
   
        public override Task StartAsync(IPluginContext context)
        {
            Console.WriteLine("插件A已启动");
            Console.WriteLine($"StartAsync 插件配置：{Options.TestConfig}");
            return base.StartAsync(context);
        }
   
        public override Task StopAsync(IPluginContext context)
        {
            Console.WriteLine("插件A已中止");
            return base.StopAsync(context);
        }
    ```

   注意：在插件初始化方法中也可以使用注入的配置

3. 跨插件配置

   有些配置可能须要在多个插件中共享，此时你可经过Plugins下的_Share节点进行配置，此节点下配置将会被合并到插件配置中，可经过PluginOptions进行访问。

   ```appsettings.json
    {
        "Plugins": {
            "PluginA": {
            },
            "_Share": {
                "TestConfig": "Hello World"
            }
        }
    }
    ```

7）插件化 ASP.NET Core

    要让 ASP.NET Core 获取获得插件中的控制器，你只须要在插件的初始化方法Init中，向MVC注入插件程序集：

```c#
context.ServiceCollection.AddMvcCore()
    .AddApplicationPart(typeof(Plugin).Assembly);
```