PluginFramework 使用教程

1. 项目介绍

PluginFramework 是一个为 .NET Core 应用程序设计的插件平台，支持包括 ASP.NET Core、Blazor、WPF、Windows Forms 和 Console 应用在内的多种应用类型。该框架的核心理念是“一切皆插件”，旨在通过插件机制轻松扩展应用程序功能。PluginFramework 支持多种插件目录，包括 .NET 程序集、Nuget 包和 Roslyn 脚本等。

2. 项目快速启动

2.1 安装 PluginFramework

首先，通过 Nuget 安装 PluginFramework 包：

Install-Package Weikio.PluginFramework

如果你使用的是 ASP.NET Core 应用，还可以安装特定的 ASP.NET Core 支持包：

Install-Package Weikio.PluginFramework.AspNetCore

2.2 配置插件目录

在 Startup.cs 文件的 ConfigureServices 方法中，添加插件目录配置：

public void ConfigureServices(IServiceCollection services)
{
    // 添加插件目录
    services.AddPluginFramework<IOperator>(@"\myplugins");
}

2.3 使用插件

在控制器中使用插件，可以通过构造函数注入的方式获取插件实例：

public class CalculatorController : Controller
{
    private readonly IEnumerable<IOperator> _operators;

    public CalculatorController(IEnumerable<IOperator> operators)
    {
        _operators = operators;
    }

    public IActionResult Index()
    {
        // 使用插件
        var result = _operators.First().Operate(1, 2);
        return Ok(result);
    }
}

3. 应用案例和最佳实践

3.1 动态扩展功能

PluginFramework 适用于需要在运行时动态扩展功能的场景。例如，一个日志系统可以通过插件机制支持多种日志存储方式（如文件、数据库、云存储等），而不需要修改核心代码。

3.2 模块化开发

在大型项目中，使用 PluginFramework 可以将不同功能模块化，每个模块作为一个插件独立开发和测试。这样可以提高代码的可维护性和可扩展性。

3.3 插件热更新

PluginFramework 支持插件的热更新，即在不重启应用的情况下更新插件。这对于需要高可用性的系统尤为重要。

4. 典型生态项目

4.1 ASP.NET Core 插件

PluginFramework 提供了对 ASP.NET Core 的专门支持，使得在 ASP.NET Core 应用中集成插件变得非常简单。你可以通过插件扩展控制器、中间件等功能。

4.2 Blazor 插件

Blazor 是一个基于 WebAssembly 的 .NET 前端框架，PluginFramework 可以用于扩展 Blazor 应用的功能，例如添加新的组件或服务。

4.3 WPF 和 Windows Forms 插件

对于桌面应用，PluginFramework 同样提供了支持。你可以通过插件机制为 WPF 或 Windows Forms 应用添加新的功能模块，如新的 UI 组件或后台服务。

通过以上步骤，你可以快速上手并使用 PluginFramework 来扩展你的 .NET Core 应用程序。