详细讲解一下客户端的三端打包流程：使用什么工具？含哪些目录？有什么需要注意的地方等详细的细节以及步骤？
🤖 回答引擎: 热血江湖Lua |
🕒 时间: 2026-05-10 16:00:32 |
👁️ 阅读: 6
**客户端三端打包流程详解**
**一、概述**
客户端三端打包（PC、安卓、iOS）是指将开发过程中的自定义资源（如FGUI界面、序列帧特效、Lua配置文件等）通过特定工具处理，生成可在对应平台客户端中加载的资源包的过程。开发资源需放置在客户端的`dev`目录下，客户端会优先读取此目录内容。
**二、核心工具**
1. **FairyGUI编辑器**：用于编辑和发布FGUI界面资源。项目文件需从**RJHub工具**中下载。
2. **官方资源打包工具**：用于将`dev`目录下的原生资源（图片、模型等）打包成Unity引擎可识别的格式，以及生成线上开区所需的资源更新包。
**三、打包流程与目录结构**
**A. FGUI资源打包（针对界面UI）**
1. **工具**：FairyGUI编辑器。
2. **步骤**：
* 从RJHub工具下载最新的FGUI项目文件。
* 使用FairyGUI编辑器打开项目文件（如`9963d_rxjh_fgui_project.fairy`）。
* 在编辑器中修改或创建界面组件。
* 通过“发布设置”对话框，设置发布路径为客户端`dev`目录下的`FGUIExport`文件夹，或根据需要发布到自定义子目录（如特效需发布到`SFX`目录下的具体文件夹）。
* 执行发布操作。
3. **目标目录**：
* `rjengineb_Data\StreamingAssets\Bundles\dev\FGUIExport` - 存放发布的FGUI资源包。
* `rjengineb_Data\StreamingAssets\Bundles\dev\SFX\` - 存放发布的序列帧特效资源（需在发布路径中指定具体特效文件夹名，如`..\SFX\7000`）。
* `rjengineb_Data\StreamingAssets\Bundles\dev\Lua\FGUILayout` - 存放FGUI相关的Lua代码（无需打包，直接放置）。
4. **注意**：
* **修改官方界面**：若修改官方已有界面，必须确保组件结构、命名、控制器及属性与官方逻辑代码完全一致。发布时，需连同未改动的官方资源一起打包，否则可能导致界面异常或资源缺失。
* **新增自定义界面**：可自由设计。
* **资源覆盖规则**：若自定义资源目录与官方目录同名（如`ItemIcon`），客户端将优先使用`dev`目录下打包好的版本。
**B. 自定义资源本地打包（针对图片、模型等）**
1. **工具**：官方资源打包工具，选择 **“dev本地”** 模式。
2. **步骤**：
* 打开工具，选择“dev本地”。
* 在“导入目录”中选择包含原生资源的`dev`目录（或改动部分资源）。
* 在“导出目录”中填写PC客户端的`dev`目录路径（例如：`Client_Win64\xxengine_Data\StreamingAssets\Bundles\dev`），PC打包后资源会自动拷贝至此。安卓和iOS平台无需填写此目录。
* 选择 **“本地全量”**（首次或需要完整打包时）或 **“本地增量”**（仅打包改动部分并与原资源合并）。
* 执行打包。
* 若资源编译后不生效，可尝试勾选“Rebuild Resources”后重新生成。
3. **生成目录**：打包后资源默认生成在工具根目录的“打包缓存”中，或指定的“导出目录”。
4. **注意**：
* Unity编辑器版本必须为 **2022.3.14f1**。
* **Lua文件无需打包**：`dev\Lua`目录下的所有Lua脚本和配置文件（包括`game_config`下的表导出的Lua文件）均无需打包，直接放入对应目录即可。
* **路径禁止带空格**，否则可能导致打包失败。
* 导入模型等资源时，需按照规范放置文件，Unity会自动生成Prefab等文件。
**C. 线上资源打包（用于开区、更新）**
1. **工具**：官方资源打包工具，选择 **“dev更新包”** 模式。
2. **步骤**：
* 打开工具，选择“dev更新包”。
* “dev目录”选择完整的`rjengineb_Data\StreamingAssets\Bundles\dev`资源目录。
* 设置“导出目录”（用于存放生成的更新包）。
* 填写“版本号”（纯数字，需比上次版本大）。
* 选择 **“全量包”**（生成完整的zip资源包）或 **“增量包”**（与上次打包对比生成差异包）。
* 执行打包。生成的zip包需上传至服务器后台，全量包选择“全量更新”，增量包选择“增量更新”。
3. **注意**：
* 打包安卓和iOS资源前，Unity需安装对应平台的支持模块。
* 工具服资源地址可通过RJHub工具进行配置，方便协同工作。
**四、关键目录总结**
客户端`dev`目录核心结构如下，所有自定义资源最终都需放置或生成在此目录树中：
```
rjengineb_Data\StreamingAssets\Bundles\dev\
├─ FGUIExport\ # FGUI编辑器发布的资源包
├─ Lua\
│ ├─ FGUILayout\ # FGUI相关Lua代码（直接放置）
│ └─ game_config\ # 策划xls表导出的前端Lua配置文件（直接放置）
├─ SFX\ # 序列帧特效资源（FGUI发布或工具打包）
└─ ... (其他由资源工具打包生成的资源目录，如模型、地图等)
```
**五、通用注意事项**
1. **资源一致性**：修改任何与官方逻辑有依赖的资源（尤其是FGUI组件）时，必须保持接口和结构的一致性。
2. **工具与文件版本**：务必使用RJHub工具发布的最新FGUI项目文件和代码文件进行操作。
3. **平台适配**：为三端打包时，需确保资源工具中的Unity已正确安装PC、安卓、iOS平台支持。
4. **问题排查**：若资源不生效，优先检查是否放置在正确的`dev`子目录，以及是否按要求完成了打包发布操作。
← 返回问答库