GeWuYou.GFramework
0.0.207
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package GeWuYou.GFramework --version 0.0.207
NuGet\Install-Package GeWuYou.GFramework -Version 0.0.207
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GeWuYou.GFramework" Version="0.0.207" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="GeWuYou.GFramework" Version="0.0.207" />
<PackageReference Include="GeWuYou.GFramework" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add GeWuYou.GFramework --version 0.0.207
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: GeWuYou.GFramework, 0.0.207"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package GeWuYou.GFramework@0.0.207
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=GeWuYou.GFramework&version=0.0.207
#tool nuget:?package=GeWuYou.GFramework&version=0.0.207
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
GFramework
面向游戏开发场景的模块化 C# 框架,核心能力与具体引擎解耦,可按需组合 Core / Game / Godot / Source Generators。
项目简介
GFramework 采用清晰分层与模块化设计,强调:
- 架构分层(Architecture / Model / System / Utility)
- 命令与查询分离(CQRS)
- 类型安全事件机制
- 可绑定属性与响应式数据流
- 可扩展的 IOC/生命周期管理
- 基于 Roslyn 的源码生成能力
项目灵感参考自 QFramework,并在模块边界、工程组织和可扩展性方面进行了持续重构。
功能模块
| 模块 | 说明 | 文档 |
|---|---|---|
GFramework.Core |
平台无关的核心架构能力(架构、命令、查询、事件、属性、IOC、日志等) | 查看 |
GFramework.Core.Abstractions |
Core 对应的抽象接口定义 | 查看 |
GFramework.Game |
游戏业务侧扩展(状态、配置、存储、UI 等) | 查看 |
GFramework.Game.Abstractions |
Game 模块抽象接口定义 | 查看 |
GFramework.Godot |
Godot 集成层(节点扩展、场景/设置/存储适配等) | 查看 |
GFramework.SourceGenerators |
通用源码生成器(日志、枚举扩展、规则等) | 查看 |
GFramework.Godot.SourceGenerators |
Godot 场景下的源码生成器扩展 | 查看 |
文档导航
- 入门教程:
docs/zh-CN/tutorials/getting-started.md - Godot 集成:
docs/zh-CN/godot/index.md - 进阶模式:
docs/zh-CN/core/index.md - 最佳实践:
docs/zh-CN/best-practices/architecture-patterns.md - API 参考:
docs/zh-CN/api-reference/
如果你更偏好按模块阅读,建议从各子项目
README.md开始,再回到docs/查阅专题文档。
包选择说明(避免混淆)
GeWuYou.GFramework:聚合元包(Meta Package),用于一键引入常用能力集合,适合快速试用或原型阶段。GeWuYou.GFramework.Core:核心起步包,适合希望按模块精细控制依赖的项目(推荐生产项目从此起步)。
如果你已明确技术栈,建议优先按模块安装(Core / Game / Godot / SourceGenerators),避免不必要依赖。
快速安装
按实际需求选择依赖:
# 核心能力(推荐最小起步)
dotnet add package GeWuYou.GFramework.Core
dotnet add package GeWuYou.GFramework.Core.Abstractions
# 游戏扩展
dotnet add package GeWuYou.GFramework.Game
dotnet add package GeWuYou.GFramework.Game.Abstractions
# Godot 集成(仅 Godot 项目需要)
dotnet add package GeWuYou.GFramework.Godot
# 源码生成器(可选,但推荐)
dotnet add package GeWuYou.GFramework.SourceGenerators
仓库结构
GFramework.sln
├─ GFramework.Core/
├─ GFramework.Core.Abstractions/
├─ GFramework.Game/
├─ GFramework.Game.Abstractions/
├─ GFramework.Godot/
├─ GFramework.SourceGenerators/
├─ GFramework.Godot.SourceGenerators/
├─ docs/
└─ docfx/
兼容性
- 运行时/工具链:基于 .NET 生态,具体以各项目
*.csproj的TargetFramework为准。 - 引擎集成:当前提供 Godot 集成模块,Core 层可迁移至其他 .NET 场景。
贡献
欢迎提交 Issue 与 Pull Request:
- Fork 本仓库并创建特性分支
- 补充必要的测试或文档更新
- 提交 PR,描述变更背景、方案与验证结果
许可证
本项目采用 Apache License 2.0。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- GeWuYou.GFramework.Core (>= 0.0.207)
- GeWuYou.GFramework.Game (>= 0.0.207)
-
net8.0
- GeWuYou.GFramework.Core (>= 0.0.207)
- GeWuYou.GFramework.Game (>= 0.0.207)
-
net9.0
- GeWuYou.GFramework.Core (>= 0.0.207)
- GeWuYou.GFramework.Game (>= 0.0.207)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.0.220 | 100 | 4/13/2026 |
| 0.0.219 | 83 | 4/13/2026 |
| 0.0.218 | 88 | 4/12/2026 |
| 0.0.217 | 84 | 4/11/2026 |
| 0.0.216 | 84 | 4/7/2026 |
| 0.0.215 | 93 | 4/6/2026 |
| 0.0.214 | 94 | 4/5/2026 |
| 0.0.213 | 98 | 4/1/2026 |
| 0.0.212 | 95 | 3/31/2026 |
| 0.0.211 | 104 | 3/30/2026 |
| 0.0.210 | 155 | 3/28/2026 |
| 0.0.209 | 156 | 3/28/2026 |
| 0.0.208 | 228 | 3/24/2026 |
| 0.0.207 | 171 | 3/22/2026 |
| 0.0.206 | 122 | 3/21/2026 |
| 0.0.205 | 175 | 3/21/2026 |
| 0.0.204 | 236 | 3/14/2026 |
| 0.0.203 | 138 | 3/13/2026 |
| 0.0.202 | 110 | 3/8/2026 |
| 0.0.201 | 122 | 3/8/2026 |
Loading failed