mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-06 16:16:44 +08:00
121479835a
- 修复抽象层入口页与生命周期文档中的语义化导航和初始化入口说明 - 更新教程与排障文档中过时的架构级 Init() 示例，区分 OnInitialize()、InstallModules() 与 OnInit() - 归档 active tracking 的详细验证历史并补充 RP-048 trace
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
---
|
|
title: 抽象接口
|
|
description: GFramework 各抽象层模块的阅读入口与使用边界。
|
|
---
|
|
|
|
# 抽象接口
|
|
|
|
`GFramework.*.Abstractions` 用来承载跨模块协作所需的契约，而不是运行时实现。
|
|
|
|
适合阅读这部分内容的场景：
|
|
|
|
- 你要做模块拆分，只想依赖接口，不想直接引用完整运行时
|
|
- 你要为测试、编辑器工具或插件提供替身实现
|
|
- 你在维护生成器、适配层或二次封装，需要先理解契约边界
|
|
|
|
## 阅读顺序
|
|
|
|
- Core 抽象层：[Core 抽象层说明](./core-abstractions.md)
|
|
- Game 抽象层：[Game 抽象层说明](./game-abstractions.md)
|
|
- Ecs.Arch 抽象层：[Ecs.Arch 抽象层说明](./ecs-arch-abstractions.md)
|
|
|
|
## 使用建议
|
|
|
|
- 如果你只是想直接使用框架功能，优先从对应运行时模块说明和栏目页开始。
|
|
- 只有在明确需要“契约层而非实现层”时，才单独依赖 `*.Abstractions` 包。
|
|
- 抽象层页面会解释接口分组与职责；实际安装与接入路径，仍应以对应运行时模块说明和[快速开始](../getting-started/)为主。
|
|
|
|
## 当前边界
|
|
|
|
- `GFramework.Core.SourceGenerators.Abstractions`
|
|
- `GFramework.Godot.SourceGenerators.Abstractions`
|
|
- `GFramework.SourceGenerators.Common`
|
|
|
|
这些目录当前不作为独立抽象接口栏目维护，而是作为源码生成器家族的内部支撑模块，分别跟随所属模块 README 和
|
|
`source-generators` 栏目维护。
|