129 lines
3.9 KiB
Markdown
129 lines
3.9 KiB
Markdown
---
|
||
name: ui-prefab-dev
|
||
description: Unity UI Prefab 开发：结构分析、组件修改、代码生成。涉及 UI Prefab 层级查看、组件属性读取、UI 控制器代码编写。触发关键词：UI界面 UI开发、Prefab 预制体、UIBaseController、AutoGen、UGUI、RectTransform、Image Button Text、ScrollRect 列表、extract_ui_prefab、ExtractedPrefabs、UI控制器。
|
||
version: "1.0"
|
||
updated: "2026-05-08"
|
||
---
|
||
|
||
# UI Prefab 开发
|
||
|
||
分析、修改和生成 Unity UI Prefab 及相关 C# 控制器代码。
|
||
|
||
## 前置知识
|
||
|
||
- **UI Prefab 位置**: `Assets/` 下的各 UI 模块目录
|
||
- **UI 控制器代码**: `Assets/Code/Scripts/GamePlay/UI/`（60+ 控制器）
|
||
- **生成代码标记**: `*Controller.AutoGen.cs` 文件（自动生成，勿手动修改）
|
||
- **ExtractedPrefabs**: `ExtractedPrefabs/` 目录存放导出的 Prefab JSON 结构
|
||
- **JSON 格式说明**: `ExtractedPrefabs/README.md`
|
||
|
||
## 工作流
|
||
|
||
### 1. 获取 UI Prefab 结构
|
||
|
||
通过 Unity MCP 提取 Prefab 结构信息：
|
||
|
||
```
|
||
execute_custom_tool: {
|
||
tool_name: "extract_ui_prefab",
|
||
parameters: { prefab_path: "Assets/xxx/xxx.prefab" }
|
||
}
|
||
```
|
||
|
||
读取返回的 JSON 文件，参考 `ExtractedPrefabs/README.md` 理解 JSON 格式。
|
||
|
||
> **重要**: 每次分析前都需重新提取（避免读取旧数据）。
|
||
|
||
### 2. 理解 UI 层级结构
|
||
|
||
JSON 格式和属性格式定义见 `ExtractedPrefabs/README.md`。
|
||
|
||
常见组件类型：
|
||
- **RectTransform**: 锚点、位置、尺寸
|
||
- **Image**: Sprite 引用、Color、ImageType、RaycastTarget
|
||
- **Text/TMP_Text**: 文本内容、字体、字号、颜色
|
||
- **Button**: Transition 类型、颜色状态
|
||
- **CanvasRenderer**: 渲染参数
|
||
|
||
### 3. 分析 UI 控制逻辑
|
||
|
||
UI 控制器代码模式：
|
||
|
||
```
|
||
// 手动编写的控制器（可修改）
|
||
public class UI_XXXController : UIBaseController
|
||
{
|
||
// 绑定 UI 组件引用
|
||
// 业务逻辑方法
|
||
}
|
||
|
||
// 自动生成的控制器（不可手动修改）
|
||
public class UI_XXXController.AutoGen : ...
|
||
{
|
||
// 自动生成的组件绑定代码
|
||
}
|
||
```
|
||
|
||
### 4. 修改或创建 UI
|
||
|
||
修改已有 UI：
|
||
1. 提取 Prefab JSON 了解当前结构
|
||
2. 查看对应的 `*Controller.cs` 了解代码逻辑
|
||
3. 修改 Prefab（通过 Unity Editor）或代码
|
||
4. 确保 AutoGen 和手动代码分工明确
|
||
|
||
创建新 UI：
|
||
1. 在 Unity 中创建 Prefab
|
||
2. 编写对应的 Controller 类（继承 UIBaseController）
|
||
3. 如需自动绑定，编写 AutoGen 辅助类
|
||
4. 注册到 UI 管理系统中
|
||
|
||
## 不适用场景
|
||
|
||
- 纯逻辑 UI 改动（不涉及 Prefab 结构变化）→ 直接改 Controller 代码即可
|
||
- 简单的位置/颜色微调 → 无需走完整提取流程，直接描述修改即可
|
||
|
||
## 属性格式参考
|
||
|
||
| 类型 | 格式示例 |
|
||
|------|----------|
|
||
| Vector2 | `AnchoredPosition:0,0` |
|
||
| Vector3 | `LocalPosition:0,0,0` |
|
||
| Color | `Color:#RRGGBBAA` |
|
||
| Bool | `RaycastTarget:true` |
|
||
| Enum | `ImageType:Sliced` |
|
||
| 引用 | `Sprite:icon_name` |
|
||
|
||
## UI 模块索引
|
||
|
||
```
|
||
GamePlay/UI/
|
||
├── Activity/ # 活动界面
|
||
├── BattlePass/ # 战令
|
||
├── Camp/ # 营地
|
||
├── Character/ # 角色界面
|
||
├── Dispatch/ # 派遣
|
||
├── Draw/ # 抽卡
|
||
├── Legion/ # 军团
|
||
├── LegionBattle/ # 军团战
|
||
├── LegionPve/ # 军团PVE
|
||
├── LevelFight/ # 关卡战斗
|
||
├── Loading/ # 加载界面
|
||
├── Login/ # 登录
|
||
├── Mail/ # 邮件
|
||
├── Package/ # 背包
|
||
├── PVP/ # PVP
|
||
├── Raffle/ # 抽奖
|
||
├── Shop/ # 商店
|
||
├── Story/ # 剧情
|
||
├── Task/ # 任务
|
||
└── Team/ # 编队
|
||
```
|
||
|
||
## 安全规则
|
||
|
||
- AutoGen 文件（`*Controller.AutoGen.cs`）不可手动修改
|
||
- Prefab 修改后需要在 Unity 中保存，.meta 文件由 Unity 自动生成
|
||
- 图片资源引用确保路径正确，避免丢失引用
|
||
- UI 变更可能影响多个界面，修改前确认影响范围
|