Arch/AutoHistory项目使用手册

1. 项目目录结构及介绍

Arch/AutoHistory是一个专为Microsoft Entity Framework Core设计的插件，旨在自动记录数据变更历史。下面简要介绍其主要目录结构：

• src: 此目录包含了核心的实现代码。
  • Microsoft.EntityFrameworkCore.AutoHistory: 实现自动数据变更跟踪的主体逻辑。
• test: 包含测试案例的目录。
  • Microsoft.EntityFrameworkCore.AutoHistory.Test: 用于确保插件功能正确性的单元测试和集成测试。
• samples: 示例应用程序目录，展示了如何在实际项目中应用该插件。
  • AspNetCore.MVC.EF.Blogs: 一个基于ASP.NET Core MVC，结合Entity Framework Core的应用示例，演示了AutoHistory的集成方式。
• .editorconfig, .gitattributes, .gitignore: 版本控制相关的配置文件，用来统一代码风格和管理忽略文件。
• AutoHistory.sln: 解决方案文件，便于管理和编译整个项目。
• LICENSE: 许可证文件，说明软件遵循MIT协议，允许免费使用、修改和分发。

2. 项目的启动文件介绍

虽然Arch/AutoHistory作为一个库，并没有直接运行的“启动文件”，但在使用它的应用程序（如位于samples/AspNetCore.MVC.EF.Blogs中的项目）中，通常会在Startup.cs文件内进行配置。在应用的ConfigureServices(IServiceCollection services)方法里，添加对AutoHistory服务的注册是关键步骤，例如：

services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"))
           .UseAutoHistory());

这里的.UseAutoHistory()就是激活插件的关键调用。

3. 项目的配置文件介绍

对于Arch/AutoHistory插件本身，配置主要是通过代码配置完成的。然而，在实际应用中，你可以通过应用程序的配置文件（如APPsettings.json或通过依赖注入的配置对象）来传递数据库连接字符串等信息。例如，在appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=MyDb;Trusted_Connection=True;MultipleActiveResultSets=true"
  },
  // 其他配置...
}

然后在应用初始化时，通过Configuration对象读取这些设置并传递给EF Core。若需特定配置插件的行为（比如自定义历史表名、字段映射等），这一般需要通过扩展方法或插件提供的配置接口在代码中明确指定，而非直接在配置文件中完成。

以上是关于Arch/AutoHistory项目的基本结构、启动配置和相关设置的简介，开发人员应参照具体文档和源码注释来深入了解细节。