mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-06 16:16:44 +08:00
- 新增 documentation-full-coverage-governance active topic 与首轮 inventory、trace 入口 - 补充 GFramework.Ecs.Arch.Abstractions README、抽象接口页面与导航映射 - 更新 API 参考页与根 README,明确内部支撑模块 owner 和阅读链路
1.4 KiB
1.4 KiB
title, description
| title | description |
|---|---|
| 抽象接口 | GFramework 各抽象层模块的阅读入口与使用边界。 |
抽象接口
GFramework.*.Abstractions 用来承载跨模块协作所需的契约,而不是运行时实现。
适合阅读这部分内容的场景:
- 你要做模块拆分,只想依赖接口,不想直接引用完整运行时
- 你要为测试、编辑器工具或插件提供替身实现
- 你在维护生成器、适配层或二次封装,需要先理解契约边界
阅读顺序
- Core 抽象层:
core-abstractions.md - Game 抽象层:
game-abstractions.md - Ecs.Arch 抽象层:
ecs-arch-abstractions.md
使用建议
- 如果你只是想直接使用框架功能,优先从对应运行时模块的
README.md和栏目页开始。 - 只有在明确需要“契约层而非实现层”时,才单独依赖
*.Abstractions包。 - 抽象层页面会解释接口分组与职责;实际安装与接入路径,仍应以运行时模块 README 与
getting-started为主。
当前边界
GFramework.Core.SourceGenerators.AbstractionsGFramework.Godot.SourceGenerators.AbstractionsGFramework.SourceGenerators.Common
这些目录当前不作为独立抽象接口栏目维护,而是作为源码生成器家族的内部支撑模块,分别跟随所属模块 README 和
source-generators 栏目维护。