mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
12ce31f82a
- 实现基于 YAML 的配置文件加载功能 - 集成 JSON Schema 结构验证和类型检查 - 提供一对象一文件的目录组织方式 - 支持运行时只读查询和类型安全访问 - 实现 Source Generator 生成配置类型和表包装 - 添加 VS Code 插件提供配置浏览和编辑功能 - 支持跨表引用校验和依赖关系管理 - 实现开发期热重载功能，支持配置变更自动刷新 - 提供完整的配置加载、验证、注册和访问接口
23 lines
1.1 KiB
C#
23 lines
1.1 KiB
C#
using GFramework.Core.Abstractions.Utility;
|
|
|
|
namespace GFramework.Game.Abstractions.Config;
|
|
|
|
/// <summary>
|
|
/// 定义配置加载器契约。
|
|
/// 具体实现负责从文件系统、资源包或其他配置源加载文本配置，并将解析结果注册到配置注册表。
|
|
/// </summary>
|
|
public interface IConfigLoader : IUtility
|
|
{
|
|
/// <summary>
|
|
/// 执行配置加载并将结果写入注册表。
|
|
/// 实现应在同一次加载过程中保证注册结果的一致性，避免只加载部分配置后就暴露给运行时消费。
|
|
/// </summary>
|
|
/// <param name="registry">用于接收配置表的注册表。</param>
|
|
/// <param name="cancellationToken">取消令牌。</param>
|
|
/// <returns>表示异步加载流程的任务。</returns>
|
|
/// <exception cref="ConfigLoadException">
|
|
/// 当配置文件、schema、反序列化或跨表引用校验失败时抛出。
|
|
/// 调用方可以通过 <see cref="ConfigLoadException.Diagnostic" /> 读取稳定的结构化字段。
|
|
/// </exception>
|
|
Task LoadAsync(IConfigRegistry registry, CancellationToken cancellationToken = default);
|
|
} |