mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
docs(tutorials): 添加教程概览页面并调整导航链接
- 创建了新的教程概览页面 docs/zh-CN/tutorials/index.md - 添加了完整的教程目录结构和学习路径介绍 - 在侧边栏中增加了教程概览链接 - 修正了教程导航链接指向正确的根目录 - 包含了基础教程、Godot集成教程和高级模式教程的详细介绍 - 提供了三种不同的学习路径建议和前置知识要求
This commit is contained in:
parent
f2a15a8302
commit
aa0a9f7ab6
@ -50,7 +50,7 @@ export default defineConfig({
|
||||
{ text: 'Game', link: '/zh-CN/game/' },
|
||||
{ text: 'Godot', link: '/zh-CN/godot/' },
|
||||
{ text: '源码生成器', link: '/zh-CN/source-generators' },
|
||||
{ text: '教程', link: '/zh-CN/tutorials/basic' },
|
||||
{ text: '教程', link: '/zh-CN/tutorials/' },
|
||||
],
|
||||
|
||||
sidebar: {
|
||||
@ -139,6 +139,7 @@ export default defineConfig({
|
||||
{
|
||||
text: '教程',
|
||||
items: [
|
||||
{ text: '教程概览', link: '/zh-CN/tutorials/' },
|
||||
{
|
||||
text: '基础教程',
|
||||
link: '/zh-CN/tutorials/basic/',
|
||||
|
||||
204
docs/zh-CN/tutorials/index.md
Normal file
204
docs/zh-CN/tutorials/index.md
Normal file
@ -0,0 +1,204 @@
|
||||
# 教程
|
||||
|
||||
欢迎来到 GFramework 教程中心!这里提供从入门到精进的完整学习路径,帮助你掌握这个面向游戏开发的模块化 C# 框架。
|
||||
|
||||
## 📚 可用教程
|
||||
|
||||
### [基础教程](./basic/)
|
||||
|
||||
> 从零开始学习 GFramework,通过构建一个完整的计数器应用,逐步掌握框架的核心概念。
|
||||
|
||||
**适合人群**:
|
||||
|
||||
- C# 和面向对象编程初学者
|
||||
- 希望了解 GFramework 基础架构的开发者
|
||||
- 准备使用 Godot + GFramework 进行开发的团队
|
||||
|
||||
**学习内容**:
|
||||
|
||||
- 开发环境搭建(.NET SDK + Godot)
|
||||
- 项目初始化与架构配置
|
||||
- Model、Command、System、Utility 核心概念
|
||||
- 事件驱动架构实践
|
||||
- MVC 模式在游戏开发中的应用
|
||||
|
||||
**预计时间**:2-3 小时
|
||||
|
||||
---
|
||||
|
||||
### [Godot 集成教程](./godot-integration.md)
|
||||
|
||||
> 深入学习 GFramework 与 Godot 引擎的深度集成,掌握高级开发技巧。
|
||||
|
||||
**适合人群**:
|
||||
|
||||
- 已完成基础教程的开发者
|
||||
- 需要优化 Godot 项目性能的开发者
|
||||
- 希望实现复杂游戏系统的架构师
|
||||
|
||||
**学习内容**:
|
||||
|
||||
- 节点生命周期管理
|
||||
- 信号系统集成与桥接
|
||||
- 资源管理优化策略
|
||||
- 对象池化系统实现
|
||||
- 性能优化最佳实践
|
||||
- 调试与测试方法
|
||||
|
||||
**预计时间**:3-4 小时
|
||||
|
||||
---
|
||||
|
||||
### [高级模式教程](./advanced-patterns.md)
|
||||
|
||||
> 探索 GFramework 的高级特性和企业级设计模式。
|
||||
|
||||
**适合人群**:
|
||||
|
||||
- 有 GFramework 实战经验的开发者
|
||||
- 需要构建大型复杂游戏系统的团队
|
||||
- 对架构设计有深入追求的开发者
|
||||
|
||||
**学习内容**:
|
||||
|
||||
- CQRS(命令查询职责分离)模式
|
||||
- 领域驱动设计(DDD)
|
||||
- 事件溯源与事件总线
|
||||
- 插件系统架构
|
||||
- 多人游戏网络集成
|
||||
|
||||
**预计时间**:4-6 小时
|
||||
|
||||
---
|
||||
|
||||
## 🎯 学习路径建议
|
||||
|
||||
### 路径一:快速上手(推荐新手)
|
||||
|
||||
```
|
||||
基础教程(全章节) → Godot 集成教程(选择性阅读) → 开始你的项目
|
||||
```
|
||||
|
||||
**时间**:2-3 天
|
||||
**目标**:掌握 GFramework 核心,能够独立开发简单游戏
|
||||
|
||||
---
|
||||
|
||||
### 路径二:系统学习(推荐完整掌握)
|
||||
|
||||
```
|
||||
基础教程 → Godot 集成教程 → 小项目实践 → 高级模式教程
|
||||
```
|
||||
|
||||
**时间**:1-2 周
|
||||
**目标**:深入理解框架设计思想,能够优化和扩展框架
|
||||
|
||||
---
|
||||
|
||||
### 路径三:架构师之路(推荐团队负责人)
|
||||
|
||||
```
|
||||
高级模式教程(预览) → 基础教程 → Godot 集成教程 → 高级模式教程(深入) → 架构设计实践
|
||||
```
|
||||
|
||||
**时间**:2-4 周
|
||||
**目标**:能够设计可扩展、可维护的大型游戏架构
|
||||
|
||||
---
|
||||
|
||||
## 💡 学习建议
|
||||
|
||||
### 实践为王
|
||||
|
||||
- **跟随编码**:不要只看,要动手跟着教程敲代码
|
||||
- **修改实验**:在示例代码基础上进行修改,观察变化
|
||||
- **独立实现**:学完后尝试用学到的东西实现一个小功能
|
||||
|
||||
### 理解原理
|
||||
|
||||
- **思考设计意图**:每个架构决策背后都有原因
|
||||
- **对比传统方式**:理解为什么使用框架会带来好处
|
||||
- **举一反三**:将模式应用到其他类似场景
|
||||
|
||||
### 善用资源
|
||||
|
||||
- **查阅文档**:结合 [Core 核心框架](../core/) 和 [Godot 集成](../godot/) 文档
|
||||
- **查看示例**:参考框架附带的示例项目
|
||||
- **社区交流**:遇到问题时查看 GitHub Issues 或参与讨论
|
||||
|
||||
---
|
||||
|
||||
## 📖 前置知识要求
|
||||
|
||||
### 必需
|
||||
|
||||
- **C# 基础语法**:类、接口、泛型、Lambda 表达式
|
||||
- **面向对象编程**:封装、继承、多态
|
||||
- **命令行基础**:能够使用终端/命令提示符
|
||||
|
||||
### 推荐
|
||||
|
||||
- **Godot 引擎基础**:了解节点系统和场景概念
|
||||
- **MVC/MVVM 架构**:了解分层架构的基本思想
|
||||
- **依赖注入**:了解 IoC 容器的基本概念
|
||||
|
||||
---
|
||||
|
||||
## 🔗 相关资源
|
||||
|
||||
- [入门指南](../getting-started/) - 快速了解框架和安装配置
|
||||
- [Core 核心框架](../core/) - 深入学习核心概念
|
||||
- [Game 模块](../game/) - 游戏特定功能文档
|
||||
- [Godot 集成](../godot/) - Godot 特定功能参考
|
||||
- [源码生成器](../source-generators/) - 自动化代码生成工具
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题
|
||||
|
||||
**Q: 我没有 Godot 经验,能学习 GFramework 吗?**
|
||||
|
||||
A: 建议先花 1-2 小时了解 Godot 基础概念(节点、场景、信号),这样可以更好地理解教程内容。
|
||||
|
||||
**Q: 教程中的代码可以直接用于生产环境吗?**
|
||||
|
||||
A: 教程代码主要用于教学目的,生产环境建议参考 [最佳实践](./basic/07-summary.md#最佳实践总结) 章节进行优化。
|
||||
|
||||
**Q: 学习过程中遇到问题怎么办?**
|
||||
|
||||
A: 可以:
|
||||
|
||||
1. 仔细查看错误信息和文档
|
||||
2. 对照教程中的完整代码检查自己的实现
|
||||
3. 查看 [GitHub Issues](https://github.com/GeWuYou/GFramework/issues)
|
||||
4. 提交新的 Issue 寻求帮助
|
||||
|
||||
**Q: 完成所有教程需要多长时间?**
|
||||
|
||||
A: 根据学习深度不同:
|
||||
|
||||
- 快速浏览(了解概念):4-6 小时
|
||||
- 完整实践(动手编码):10-15 小时
|
||||
- 深入理解(举一反三):20+ 小时
|
||||
|
||||
---
|
||||
|
||||
## 🚀 准备好了吗?
|
||||
|
||||
选择适合你的学习路径,开始 GFramework 之旅吧!
|
||||
|
||||
<div style="text-align: center; margin: 2rem 0;">
|
||||
|
||||
[开始基础教程 →](./basic/)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
::: tip 提示
|
||||
本教程文档使用 VitePress 构建,支持全文搜索。使用快捷键 `Ctrl+K`(Windows/Linux)或 `Cmd+K`(macOS)可以快速查找内容。
|
||||
:::
|
||||
|
||||
::: warning 版本说明
|
||||
教程基于 GFramework v1.0+ 编写。如果你使用的是更早的版本,某些 API 可能会有差异。
|
||||
:::
|
||||
Loading…
x
Reference in New Issue
Block a user