从0开始学Unity做SLG系列（1）：GameFramework框架搭建与首个加载场景实战

1. GameFramework框架初探与项目准备

第一次接触GameFramework时，我完全被它庞大的功能模块震撼到了。这个由Ellan开发的Unity游戏框架，几乎涵盖了游戏开发中的所有基础功能模块。就像搭积木一样，我们可以直接使用它提供的资源管理、场景切换、UI系统等模块，省去了重复造轮子的时间。

安装过程比想象中简单很多。直接从GitHub下载最新Release版本，导入Unity项目即可。不过这里有个小坑要注意：Unity版本最好使用2019.4 LTS或2020.3 LTS这些长期支持版，避免遇到奇怪的兼容性问题。我刚开始用2021版就踩过坑，某些API行为不一致导致资源加载异常。

框架的核心目录结构很有讲究：

• GameFramework：框架核心代码
• UnityGameFramework：Unity适配层
• Procedures：游戏流程控制
• Resources：资源加载管理

建议新手先通读官方文档的"快速开始"部分，了解框架的基本运作原理。我在第一次使用时直接跳过了文档，结果在流程控制那块卡了整整两天。后来才发现框架内置了详细的示例场景，从资源加载到场景切换都有完整实现，这些示例比文档更直观。

2. 搭建首个加载场景实战

2.1 场景基础配置

创建加载场景时，我习惯先设置好基础参数。在Unity中新建Scene命名为"Load"，把摄像机Background设为纯色（比如深蓝色），这样在加载时不会显得太突兀。分辨率设置很关键，我推荐使用1136×640这个移动端常见尺寸，既兼容iPhone的怪异分辨率，又在iPad上显示良好。

Canvas的设置有几个注意点：

1. Render Mode选Screen Space - Overlay
2. UI Scale Mode选Scale With Screen Size
3. Reference Resolution设为目标分辨率（如1136×640）
4. Match选Width，这样在不同宽高比屏幕上都能正确缩放

记得把Canvas改名为"LoadCanvas"，这是个好习惯。我见过不少项目因为随意命名，后期找UI元素时特别痛苦。给背景Image命名为"LoadBkg"，添加全屏拉伸的简单背景图，加载场景的骨架就搭好了。

2.2 进度条与动画实现

进度条是加载场景的灵魂。我通常会创建一个Slider控件，把背景设为半透明灰色，前景用亮色突出进度。但更专业的做法是用Image的Fill Amount属性控制，这样能实现各种创意进度条效果，比如飞船航行、能量填充等动画。

下面这段代码实现了带百分比显示的进度条：

csharp复制public Image progressBar;
public Text progressText;

void UpdateProgress(float value) {
    progressBar.fillAmount = value;
    progressText.text = (int)(value * 100) + "%";
    
    if(value >= 1f) {
        progressText.text = "准备就绪";
        OnLoadComplete();
    }
}

为了让等待过程更生动，我常添加一些细节动画。比如用Sprite序列帧实现旋转加载图标：

csharp复制public Image loadingIcon;
public Sprite[] frameSprites;
private int currentFrame = 0;

void Update() {
    if(Time.time - lastFrameTime > 0.1f) {
        currentFrame = (currentFrame + 1) % frameSprites.Length;
        loadingIcon.sprite = frameSprites[currentFrame];
        lastFrameTime = Time.time;
    }
}

2.3 按钮交互与场景跳转

加载完成后需要提供进入游戏的入口。我推荐使用框架自带的CommonButton组件，它内置了各种状态（Normal/Hover/Pressed/Disabled）的视觉效果和音效。创建登录按钮时要注意：

1. 按钮大小至少100×100像素，满足移动端点击区域要求
2. 添加合适的Padding让文字不会紧贴边缘
3. 设置Navigation确保键盘/手柄操作时能正确聚焦

按钮事件绑定有两种方式。传统方法是在Inspector面板拖拽，但我更推荐代码动态绑定：

csharp复制loginBtn.onClick.AddListener(() => {
    GameEntry.UI.OpenUIForm(UIFormId.LoginForm);
});

记得在ProcedureLoad流程中处理场景跳转逻辑：

csharp复制protected override void OnUpdate() {
    if(m_LoadScene.IsStartGame) {
        ChangeState<ProcedureMain>();
    }
}

3. 框架核心流程详解

3.1 Procedure流程状态机

GameFramework最强大的特性之一就是Procedure系统。它本质上是一个有限状态机，把游戏拆分成多个独立的状态流程。在我的SLG项目中，通常会设计这些流程：

1. ProcedureLaunch：框架初始化
2. ProcedureLoad：资源加载
3. ProcedureLogin：账号登录
4. ProcedureMain：主城场景
5. ProcedureBattle：战斗场景

每个流程都继承自ProcedureBase，只需实现OnEnter/OnUpdate/OnLeave三个关键方法。这种设计让代码结构非常清晰，我在后期加新功能时从未遇到过流程混乱的问题。

3.2 资源加载最佳实践

资源管理是新手最容易犯错的地方。GameFramework提供了完整的资源加载体系，但需要正确配置：

1. 在Editor模式下使用AssetDatabase加载，真机用AssetBundle
2. 大资源要用异步加载避免卡顿
3. 记得实现引用计数管理，防止内存泄漏

这里分享一个资源预加载的实用代码片段：

csharp复制IEnumerator PreloadResources() {
    string[] resList = {"UI/LoginForm", "Effects/Loading"};
    
    foreach(var res in resList) {
        yield return GameEntry.Resource.LoadAssetAsync(res, typeof(GameObject));
    }
}

3.3 UI系统的深度使用

框架的UI系统功能强大但有一定学习曲线。几个关键概念需要理解：

1. UIForm：每个界面都是一个Form
2. UIGroup：界面分组管理（如Popups、MainUI等）
3. UICamera：独立于场景相机的UI摄像机

创建新界面时，我通常会遵循这个流程：

1. 在Resources/UI下创建Prefab
2. 编写继承自UGuiForm的脚本
3. 在UIFormId枚举中添加新条目
4. 配置UI组和深度

一个常见的登录界面实现：

csharp复制public class LoginForm : UGuiForm {
    protected override void OnOpen(object userData) {
        // 初始化逻辑
    }
    
    public void OnLoginClick() {
        GameEntry.Event.Fire(this, new LoginEventArgs());
    }
}

4. 常见问题与性能优化

4.1 新手常踩的坑

在项目初期，我遇到过几个典型问题：

1. 流程未注册：在GameFramework配置面板的Available Procedures列表中添加所有流程类
2. 资源引用丢失：确保AssetBundle打包时包含所有依赖
3. UI层级混乱：正确设置UIGroup的Depth值
4. 事件未注销：在OnClose中取消注册所有事件监听

特别提醒：框架的日志系统非常完善，遇到问题时先查看Console输出，80%的问题都能从中找到线索。

4.2 移动端适配技巧

SLG游戏通常需要兼顾多种设备，这几个适配技巧很实用：

1. 使用多套分辨率资源，根据设备内存自动选择
2. 关键UI元素做安全边距处理
3. 字体大小使用相对单位（如vw/vh）
4. 触控反馈要即时明显

我常用的设备检测代码：

csharp复制void CheckDevicePerformance() {
    if(SystemInfo.systemMemorySize <= 2048) {
        QualitySettings.SetQualityLevel(0);
    } else {
        QualitySettings.SetQualityLevel(2);
    }
}

4.3 性能优化要点

经过多个项目实践，我总结出这些优化准则：

1. 资源方面：

   • 纹理压缩使用ASTC格式
   • 合并小图集减少DrawCall
   • 使用Addressables实现按需加载

2. 代码方面：

   • 避免每帧new对象
   • 使用对象池管理频繁创建销毁的对象
   • 复杂计算放到子线程

3. UI方面：

   • 禁用不可见UI的Update
   • 使用静态批处理
   • 避免嵌套过深的布局

这个对象池实现就很实用：

csharp复制public class GameObjectPool {
    private Queue<GameObject> pool = new Queue<GameObject>();
    
    public GameObject Get(GameObject prefab) {
        if(pool.Count > 0) {
            return pool.Dequeue();
        }
        return Instantiate(prefab);
    }
    
    public void Recycle(GameObject obj) {
        obj.SetActive(false);
        pool.Enqueue(obj);
    }
}

5. 项目架构与扩展思路

5.1 可扩展的代码结构

良好的项目结构能极大提升开发效率。我的典型目录结构如下：

code复制Assets/
├─ GameMain/
│  ├─ Data/        # 配置数据
│  ├─ Procedures/  # 游戏流程
│  ├─ Scripts/     # 游戏逻辑
│  └─ UI/          # 界面相关
├─ Resources/      # 静态资源
└─ ThirdParty/     # 第三方插件

对于大型SLG项目，我建议采用模块化设计。比如把武将系统、城建系统、战斗系统等拆分成独立程序集，用依赖注入管理模块间通信。

5.2 配置表驱动开发

SLG游戏通常有大量数值配置。我习惯用Excel设计配置表，然后通过工具自动生成代码和资源。这个工作流特别高效：

1. 策划在Excel中修改配置
2. 运行转换脚本生成JSON/Binary
3. 游戏运行时加载配置数据

分享一个简单的Excel转JSON的Python脚本：

python复制import pandas as pd

def convert_excel_to_json(excel_path, sheet_name):
    df = pd.read_excel(excel_path, sheet_name=sheet_name)
    return df.to_json(orient='records')

5.3 热更新方案设计

现代SLG必须支持热更新。基于GameFramework的实现方案：

1. 资源打包为AssetBundle
2. 服务端维护版本清单
3. 客户端启动时校验MD5
4. 差异下载更新资源

关键代码逻辑：

csharp复制void CheckUpdate() {
    var versionList = DownloadVersionList();
    if(NeedUpdate(versionList)) {
        StartUpdate(versionList);
    }
}

IEnumerator DownloadUpdate() {
    while(hasMoreToDownload) {
        var file = GetNextUpdateFile();
        yield return DownloadFile(file);
        UpdateProgress();
    }
}

6. 调试技巧与开发工具链

6.1 高效的调试方法

在GameFramework环境下调试有些特殊技巧：

1. 使用Debugger组件查看运行时信息
2. 开启Development模式获取详细日志
3. 自定义日志分类过滤无关信息
4. 用FrameDebugger分析渲染性能

我常用的调试代码片段：

csharp复制[Conditional("UNITY_EDITOR")]
void DebugDrawSomething() {
    // 只在Editor下执行的调试代码
}

6.2 必备的开发工具

这些工具能显著提升开发效率：

1. Memory Profiler：分析内存泄漏
2. AssetBundle Browser：查看打包结果
3. UI Builder：可视化编辑界面
4. 自定义编辑器工具：批量处理资源

比如这个自动设置Sprite属性的编辑器脚本：

csharp复制[MenuItem("Tools/Process Sprites")]
static void ProcessSprites() {
    foreach(var tex in Selection.objects) {
        var importer = AssetImporter.GetAtPath(tex) as TextureImporter;
        importer.textureType = TextureImporterType.Sprite;
        importer.SaveAndReimport();
    }
}

6.3 持续集成方案

对于团队项目，建议搭建CI/CD流水线：

1. 代码提交触发自动构建
2. 运行单元测试和静态检查
3. 打包AssetBundle并上传CDN
4. 生成版本报告和构建日志

典型的Jenkins配置步骤：

bash复制#!/bin/bash
unity -batchmode -projectPath . -executeMethod BuildPipeline.BuildAll -quit
aws s3 sync ./Build s3://your-bucket/$BUILD_NUMBER