GFramework/docs/zh-CN/getting-started/quick-start.md

title, description

title	description
快速开始	通过只依赖 Core 的最小示例快速跑通 GFramework 基础架构。

快速开始

本页给出一个只依赖 Core 的最小路径，用来确认你已经成功接入 Architecture、Model、System 与旧版命令执行器。

说明：当前仓库同时存在旧版 Command / Query 执行器与新版 CQRS runtime。本页先用最短路径说明基础架构如何跑起来；新功能优先采用 CQRS 运行时。

1. 安装最小依赖

dotnet add package GeWuYou.GFramework.Core
dotnet add package GeWuYou.GFramework.Core.Abstractions

2. 定义一个最小架构

using GFramework.Core.Architectures;

public sealed class CounterArchitecture : Architecture
{
    protected override void OnInitialize()
    {
        RegisterModel(new CounterModel());
        RegisterSystem(new CounterSystem());
    }
}

这里要点只有两个：

• 架构入口是 Architecture
• 当前版本使用 protected override void OnInitialize() 注册模型、系统和工具

3. 定义一个模型

using GFramework.Core.Model;
using GFramework.Core.Property;

public sealed class CounterModel : AbstractModel
{
    public BindableProperty<int> Count { get; } = new(0);

    protected override void OnInit()
    {
    }
}

BindableProperty<T> 适合承载可观察状态；如果你只需要一个最小例子，保持 OnInit() 为空即可。

4. 定义一个系统

using GFramework.Core.Systems;

public sealed class CounterSystem : AbstractSystem
{
    protected override void OnInit()
    {
    }
}

5. 定义一个命令

using GFramework.Core.Command;

public sealed class IncreaseCountCommand : AbstractCommand
{
    protected override void OnExecute()
    {
        var model = GetModel<CounterModel>();
        model.Count.Value += 1;
    }
}

AbstractCommand 继承自 ContextAwareBase，所以命令内部可以直接访问 GetModel<T>()、GetSystem<T>() 等上下文方法。

6. 初始化并执行

var architecture = new CounterArchitecture();
architecture.Initialize();

architecture.Context.SendCommand(new IncreaseCountCommand());

var count = architecture.Context.GetModel<CounterModel>().Count.Value;
Console.WriteLine(count); // 1

如果你能走通这一步，说明以下链路已经成立：

• 架构初始化
• 模型 / 系统注册
• 上下文访问
• 旧版命令执行

下一步

• 新功能的请求 / 通知处理：看 CQRS 运行时
• 游戏层能力与接入顺序：看 Game 模块总览
• 包目录与最小安装组合：看 安装配置