DotNetCorePlugins 开源项目安装与使用指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01099/article/details/141080013

DotNetCorePlugins 开源项目安装与使用指南

DotNetCorePlugins.NET Core library for dynamically loading code项目地址:https://gitcode.com/gh_mirrors/do/DotNetCorePlugins

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

项目根目录

在克隆完成后,项目根目录大致应有以下文件和目录:

.git: Git仓库的信息。
README.md: 项目的简介和说明文件。
LICENSE: 项目授权许可协议的文本文件。
src: 包含项目源码的主要目录。
- DotNetCorePlugins: 此目录内包含了核心的库代码。
samples: 示例项目目录,展示了如何使用这个库。
tests: 单元测试相关的目录。

src/DotNetCorePlugins 目录

这是核心库的源码所在位置,包含以下几个关键部分:

public API: 包括各种接口和类型,如PluginLoader,用于加载插件。
内部实现: 对AssemblyLoadContext的封装和利用,处理类型解析等复杂逻辑。

samples 目录

这里会有多个示例项目,展示不同场景下的插件化实践。比如一个简单的ConsoleApp,或者更复杂的WebApi项目。

2. 项目的启动文件介绍

对于每个独立的应用项目而言,都会有各自的Program.cs文件(如果是Console App),或者是Startup.cs(如果是ASP.NET Core Web项目)。这些文件通常是项目的入口点,负责初始化环境和引导运行流程。

Program.cs 文件

在简单的控制台应用中,这里是整个应用的起点。通常你会看到类似这样的代码:

class Program {
   static async Task Main(string[] args) {
       // 初始化插件系统...
       using (var loader = await PluginLoader.CreateFromAssemblyFile(...))
       {
           // 使用插件系统...
       }
   }
}

Startup.cs 文件

而在ASP.NET Core web应用中,这是配置服务和中间件的关键地方:

public void ConfigureServices(IServiceCollection services)
{
    // 添加 MVC 支持
    services.AddControllers();
    
    // 加载插件
    var pluginPath = Path.Combine(AppContext.BaseDirectory, "plugins");
    foreach (var file in Directory.GetFiles(pluginPath, "*.dll"))
    {
        services.AddPluginFromAssemblyFile(file);
    }
}

public void Configure(IApplicationBuilder app)
{
    // 添加其他中间件...
    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

以上代码示意了如何在启动期间注册插件到DI容器,以便后续请求可以轻松获取和调用。

3. 项目的配置文件介绍

配置文件通常在.NET应用中扮演着传递外部参数的角色,它帮助运行中的应用决定连接字符串、服务端点和其他动态参数。这种文件通常命名为appsettings.json或appsettings.Development.json/appsettings.Production.json的形式存在,位于项目的根目录或是特定的配置文件夹。

当涉及到插件化时,插件本身可能也有配置需求,这就意味着除了主应用之外,还需要考虑如何为这些插件提供访问配置数据的方式。一般有两种常见策略: