我第一次了解学习客户端开发，所以很多不明白，请详细讲解下以下内容我应该如何做？要准备些什么？
客户端核心目录结构学习 (预计耗时：1小时)
目标路径：rjengineb_Data\StreamingAssets\Bundles\dev\
学习内容与规则：
FGUIExport：
作用：存放通过FairyGUI编辑器“发布”操作生成的界面资源包。
核心规则：客户端会优先读取此目录下的文件。如果修改或覆盖了官方已有的界面，必须确保你的组件结构、命名、控制器及属性与官方逻辑代码中的引用完全一致，
🤖 回答引擎: 热血江湖Lua |
🕒 时间: 2026-04-30 16:12:24 |
👁️ 阅读: 13
针对你第一次学习客户端开发，以下是关于客户端核心目录结构 `rjengineb_Data\StreamingAssets\Bundles\dev\` 的详细学习步骤和准备工作。
### 一、准备工作
1. **获取工具与项目文件**：
* **FairyGUI编辑器**：从官网（https://www.fairygui.com/）下载并安装。这是编辑和发布UI界面的核心工具。
* **FGUI项目文件**：所有官方的界面资源文件（FGUI项目工程文件）需要通过 **RJHub工具** 下载。这是你进行界面修改和学习的起点。
* **客户端环境**：确保你有一个可运行的热血江湖客户端，用于测试你放入 `dev` 目录的文件。
2. **了解核心原则**：
* `dev` 目录下的所有资源（包括FGUI资源、Lua代码、配置文件、特效等）都会被客户端**优先读取**。这是你进行本地开发和测试的基础。
* 修改任何东西前，先理解官方原有的结构和逻辑，尤其是修改官方界面时。
### 二、目录结构详解与操作步骤
#### 1. **FGUIExport 目录（界面资源包）**
* **作用**：存放所有通过FairyGUI编辑器“发布”操作生成的界面资源文件（如图片、组件布局等）。
* **学习与操作步骤**：
1. **获取项目**：使用RJHub工具下载最新的FGUI项目文件（`9963d_rxjh_fgui_project.fairy`）。
2. **打开项目**：用FairyGUI编辑器打开下载的 `.fairy` 项目文件。
3. **理解结构**：在编辑器中浏览官方已有的UI包（如 `Common`, `ItemIcon` 等），了解组件、控制器、资源的命名和层级关系。
4. **发布资源**：
* 在FairyGUI编辑器中，通过右键包列表或菜单栏的“文件->发布设置”打开发布对话框。
* 设置发布路径为你的客户端 `dev\FGUIExport` 目录。
* 点击“发布”，编辑器会将资源打包成客户端可读取的格式。
* **⚠️ 核心规则（必须遵守）**：
* **修改官方界面时**：如果你修改了官方已有的界面（例如 `Common` 包里的某个组件），你发布到 `dev\FGUIExport` 的组件，其**结构、命名、控制器及属性必须与官方逻辑代码中引用的完全一致**。否则界面会显示异常或功能失效。
* **新增自定义界面时**：如果界面是全新的，与官方逻辑无依赖，则可以自由设计。
* **保留未修改资源**：如果只修改了官方包里的部分资源，发布时需要**将未改动的官方资源一并打包进去**，否则客户端会因缺少资源而显示异常。
#### 2. **Lua 目录（逻辑与配置）**
* **作用**：存放前端Lua脚本和配置文件。
* `FGUILayout`：存放与FGUI界面交互、控制界面显示和逻辑的Lua代码。
* `game_config`：存放由策划的Excel表格（xls源表）导出的、给前端使用的Lua配置文件。
* **学习与操作步骤**：
1. **代码学习**：查看 `dev\Lua\FGUILayout` 下的Lua文件，学习官方界面是如何通过代码控制打开的（例如使用 `FGUI:Open(“包名”, “组件名”)`）、如何绑定事件等。
2. **配置学习**：查看 `dev\Lua\game_config` 下的Lua文件，了解配置表的结构（通常是由Excel导出的二维表结构）。
3. **修改与生效**：
* 无论是Lua代码文件还是配置文件，**都无需打包**。
* 直接将其复制到客户端 `dev\Lua\` 下的对应目录（`FGUILayout` 或 `game_config`），重启客户端即可生效。
4. **配置表导出**：当你修改了服务端的策划Excel表后，需要使用资源工具将其**导出为前端的Lua配置文件**，然后放入 `dev\Lua\game_config` 目录。
#### 3. **SFX 目录（特效资源）**
* **作用**：存放自定义的序列帧动画等特效资源文件。
* **学习与操作步骤**：
1. **制作特效**：在FairyGUI编辑器中制作或编辑序列帧动画。
2. **独立发布**：对于特效资源，需要在FairyGUI编辑器中选中对应的动画包，在发布设置中**取消“使用全局配置”**，并单独指定发布路径到 `dev\SFX\` 目录下（通常需要加上特定的子目录名，如 `7000`）。
3. **放置与调用**：发布后，将生成的文件放入客户端的 `dev\SFX\` 对应目录，即可在游戏内通过代码调用。
### 三、通用流程总结
1. **准备**：安装FairyGUI编辑器，通过RJHub获取最新FGUI项目文件。
2. **修改UI界面**：
* 在FairyGUI编辑器中打开项目进行修改。
* 遵守规则：改官方界面要保持结构一致；新增界面可自由设计。
* 通过编辑器“发布”功能，将资源输出到 `dev\FGUIExport`。
3. **修改逻辑或配置**：
* 编写或修改Lua代码，放入 `dev\Lua\FGUILayout`。
* 将导出的策划表Lua配置放入 `dev\Lua\game_config`。
* **注意**：Lua文件直接放入即可，无需打包。
4. **制作特效**：
* 在FairyGUI中制作序列帧动画。
* 单独发布到 `dev\SFX\` 目录。
5. **测试**：将所有修改后的文件放入客户端 `dev` 目录的对应位置，启动客户端查看效果。
**重要提醒**：在整个学习过程中，请务必详细阅读官方文档中关于“修改官方界面”的警告，这是避免出现问题最关键的一点。先从阅读和理解现有官方文件的结构开始，再进行小范围的修改和测试。
← 返回问答库