55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Plugins
|
||
|
||
## 模块概述
|
||
|
||
`Plugins` 目录保存框架依赖的第三方程序集与源码生成插件，它们补充了框架运行时能力、兼容层与自动注册逻辑。
|
||
|
||
## 快速开始
|
||
|
||
通常不需要业务层主动初始化本模块。开发者需要做的是：
|
||
|
||
1. 确认 Unity 正常导入 DLL
|
||
2. 不随意删除或移动 `Plugins` 目录文件
|
||
3. 在 UI / Event 自动注册异常时优先检查生成器 DLL 是否生效
|
||
|
||
## 架构说明
|
||
|
||
```text
|
||
Plugins
|
||
├─ XLog.dll
|
||
├─ SharpZipLib
|
||
├─ System.Memory / Buffers / Unsafe
|
||
├─ EventSourceGenerator.dll
|
||
└─ UISourceGenerator.dll
|
||
```
|
||
|
||
## 主要内容
|
||
|
||
- `XLog.dll`：日志能力支持
|
||
- `ICSharpCode.SharpZipLib.dll`：压缩/解压相关能力
|
||
- `System.Buffers.dll`、`System.Memory.dll`、`System.Runtime.CompilerServices.Unsafe.dll`：底层兼容依赖
|
||
- `EventSourceGenerator.dll`：事件源码生成插件
|
||
- `UISourceGenerator.dll`：UI 源码生成插件
|
||
|
||
## API / 作用说明
|
||
|
||
### `EventSourceGenerator.dll`
|
||
|
||
- 作用：辅助事件相关代码生成
|
||
|
||
### `UISourceGenerator.dll`
|
||
|
||
- 作用：辅助 UI 元数据与资源绑定注册
|
||
|
||
## 完整使用示例
|
||
|
||
```csharp
|
||
// 本模块通常不直接由业务代码调用。
|
||
// 若出现 UI/Event 自动注册异常，请先检查对应 DLL 在 Unity 中是否正常导入。
|
||
```
|
||
|
||
## 最佳实践
|
||
|
||
- 锁定插件版本
|
||
- 升级 Unity 后优先验证生成器与 IL2CPP 打包链路
|