更新0.6.0
This commit is contained in:
@@ -1,62 +1,121 @@
|
||||
<h1 align="center">Xeric Library</h1>
|
||||
|
||||
<a href="https://xeric.zicp.fun/LiRuochen_WorkFlow/XericLibrary-Publish">个人发布页面(最新)</a>
|
||||
<a href="https://gitee.com/none_9_0/xeric-library2">Gitee发布页面</a>
|
||||
<a href="https://xeric.zicp.fun/LiRuochen_WorkFlow/XericLibrary-Publish">个人发布页面(最新)</a>
|
||||
<a href="https://gitee.com/none_9_0/xeric-library2">Gitee发布页面</a>
|
||||
<a href="https://github.com/2128cz/XericLibrary">Github库</a>
|
||||
|
||||
更多内容请翻阅[百科](https://xeric.zicp.fun/LiRuochen_WorkFlow/XericLibrary-Publish/wiki)
|
||||
|
||||
---
|
||||
|
||||
| 版本 | SRP | URP | HDRP |
|
||||
## 兼容性
|
||||
|
||||
| 版本 | SRP | URP | HDRP |
|
||||
| --- | --- | --- | --- |
|
||||
| 2021.3.2f1 | ✔️ | ✔️ | ✔️ |
|
||||
| 2022.1.24f1 | ✔️ | ✔️ | ✔️ |
|
||||
| 6000.0.24f1 | ✔️ | ✔️ | ✔️ |
|
||||
|
||||
* 插件更名历史
|
||||
> Xeric Library
|
||||
> Aetherial Deconstructionism Paradigm (XericLibrary)
|
||||
>
|
||||
> 插件更名历史：Xeric Library → Aetherial Deconstructionism Paradigm (XericLibrary)
|
||||
|
||||
----
|
||||
---
|
||||
|
||||
欢迎使用Xeric Library, 这是一个专注代码的扩展库
|
||||
## 概述
|
||||
|
||||
* 专注Unity成员语法, 扩展多种基本类型的数据结构的Linq语法/语法糖, 提供： 函数平滑、 多项式计算、 权重拟合、 过程分级、 工业控制、 曲线绘制、 路径设置、 对象控制、 迭代扩展、 空间变换、 独特结构、 文本格式、 类型转换、 机器编码、 开发调试、 动态生成、 几何创建、 快速池化、 导航寻路、 隔离控制、 隔离输入、 语义化委托、 反射超驰、 数学常数、 单位换算、 排序算法、 程序调用、 网络连接、 windows窗口控制等快捷用法。
|
||||
Xeric Library 是一个专注代码的 Unity 扩展库。
|
||||
|
||||
* 扩展特殊类型, 包括且不限于: 多维布尔、 样条曲线、 超级单例、 多例系统、 邻居网络、 四叉树、 字典树、 软引用封装器等。
|
||||
**基础扩展**：针对 Unity 成员语法，扩展多种基本类型的 Linq 语法及语法糖，提供函数平滑、多项式计算、权重拟合、过程分级、工业控制、曲线绘制、路径设置、对象控制、迭代扩展、空间变换、独特结构、文本格式、类型转换、机器编码、开发调试、动态生成、几何创建、快速池化、导航寻路、隔离控制、隔离输入、语义化委托、反射超驰、数学常数、单位换算、排序算法、程序调用、网络连接、Windows 窗口控制等快捷用法。
|
||||
|
||||
* 扩展各种常用脚本: 游戏交互、 界面适配、 弱扩展、 绘制工厂、 SQL扩展。
|
||||
**特殊类型**：多维布尔、样条曲线、超级单例、多例系统、邻居网络、四叉树、八叉树、字典树、大顶堆、双生哈希表、比特图、软引用封装器、卡尔曼滤波器等。
|
||||
|
||||
* 兼容不规范程序: 针对不规范或毫无设计规则可言的代码, 提供了更多基于反射, CIL特性等底层语法的程序扩展, 以便快速实现目的:
|
||||
1. 脚本没有继承单例? "超级单例"不需要声名, 也不需要修改任何原来的脚本内容, 径直调用就是单例。
|
||||
2. 数据结构字段冗余重复? "软接口" (SoftInterface) 支持快速执行反射获取和设置，方法委托，字段属性一行调用。
|
||||
3. untiy对象要遵循生命周期池化太麻烦? "联合对象池" (MacroPool.UnionSet) 直接将设定项目开放到inspector上配置，代码中只需要get和release就可以!
|
||||
4. 程序UI框架和逻辑框架高度耦合无从下手? 有点麻烦, 不过菜单特性, 查找特性, 命名标记特性可以帮助你无视内容查找字段属性方法类型等内容, 直接将类传入就能程序化生成菜单界面。
|
||||
5. 驱动ui的数据量太大? 提供多种基于UI框架的数据结构虚拟化技术, 使用虚拟化拆分数据可以每次刷新的压力。 使用此功能需要安装XericUIActionVessel插件, 代码以脚本呈现，直接浏览，编写时遵循精细的工厂权能划分！
|
||||
6. 喜欢函数式变成和便捷的语法糖? 插件提供多种工具类: 枚举可以使用`MacroEnum`分类和`MacroEnum<T>`扩展; 数学, 向量, 几何, 数据结构扩展, 常见算法, 常用字符计算已经全部内嵌`MacroMath`分类;
|
||||
7. 需要使用高级数据结构? 大顶堆, 四叉树, 八叉树, 字典树, 时间戳, 多段线, 贝塞尔, 多维布尔(比特矢量), 比特图, 双生哈希表, 相邻网格等内容可以直接使用。
|
||||
8. 想要立刻能够在场景中移动角色? 第一人称, 第三人称, 上帝视角已经准备就绪!
|
||||
9. 厌烦复杂的按键检查逻辑? 按键宏 (MacroKey) 提供状态表处理更多按键, 可以识别短按, 长按, 双击, 连击, 拖拽, 以及它们的按下和释放状态! 且可以选择以时间, 坐标等共计4种模式触发, 支持新输入系统, 满足绝大部分场景的细分需求。
|
||||
10. 需要隐藏日志调用栈信息? XericLogger 可以减少日志输出内容。
|
||||
11. 需要更多调试信息? 提供可以和虚幻原生媲美的Gizmos调试显示功能。
|
||||
11. 担心兼容性吗? 程序主要基于2022版本开发, 向下兼容2021, 向上支持6000, 不涉及渲染管线API, 有针对webgl版本的单独构建版本, 且经过项目实战验证。
|
||||
**常用脚本**：游戏交互、界面适配、弱扩展、绘制工厂、SQL 扩展。
|
||||
|
||||
更多编辑器功能参考:
|
||||
* 安装Xeric Blueprint Graph以获取Unity上蓝图节点功能, 并支持Xeric函数库功能。
|
||||
* 安装Xeric UI Graph以获取蓝图化UI生成功能, 使用蓝图逻辑控制UI交互, 生成逻辑, 并支持Xeric函数库功能。
|
||||
* 安装Digital Twin Tool以获取常用调试工具集。
|
||||
* 安装Nexus Frame Flow以获取工作架构流处理功能。
|
||||
* 安装Xeric Editor辅助引擎大纲美化组件、 资源垃圾处理组件、 资源缓存组件、 快速截图功能, 以及更多快捷键功能
|
||||
**兼容不规范程序**：针对无设计规则的代码，提供基于反射、CIL 特性等底层语法的程序扩展：
|
||||
- **超级单例**：无需声明继承，径直调用即为单例。
|
||||
- **软接口 (SoftInterface)**：快速反射获取/设置，方法委托与字段属性一行调用。
|
||||
- **联合对象池 (MacroPool.UnionSet)**：Inspector 面板直接配置，代码中只需 Get 和 Release。
|
||||
- **菜单/查找/命名标记特性**：无视内容查找字段属性方法，类传入即可程序化生成菜单界面。
|
||||
- **按键宏 (MacroKey)**：状态表处理多按键，识别短按、长按、双击、连击、拖拽及其按下释放状态，支持新输入系统。
|
||||
- **XericLogger**：精简日志调用栈信息。
|
||||
- **Gizmos 调试**：媲美原生调试显示功能。
|
||||
|
||||
需要使用编译标记启用的功能:
|
||||
* XericLibrary: 通用的启用特殊功能。
|
||||
建议添加 Odin 插件，便于呈现更多界面功能。
|
||||
|
||||
当前插件提供编辑器功能: Deepseek AI对话。
|
||||
---
|
||||
|
||||
需要注意: 插件内如果涉及多平台切换, 可能会提供多种自动或手动的切换方案, 或默认使用windows平台, 请注意辨别。
|
||||
## 样式表 (XSSS)
|
||||
|
||||
建议添加ODin插件, 便于呈现更多界面功能。
|
||||
自研 Xeric Super Style Sheet (XSSS) 系统，使用 `.xsss` 自定义文本格式，类 CSS/USS 语法，专为 Unity 组件样式设计。基于字典树进行样式路径查找与匹配，支持命名空间隔离、动态监听热重载。提供完整的编辑器导入、Inspector 编辑及 PropertyDrawer 支持。
|
||||
|
||||
更多详细内容说明请翻阅README文档。
|
||||
如果发现任何问题, 包括版本兼容性, 计算错误, 调用错误, 使用问题, 都可以通过发布页Issues或其他联系方式找我获得帮助。
|
||||
---
|
||||
|
||||
## 扩展库结构
|
||||
|
||||
核心运行时位于 `Developer/XericLibrary/`，主要模块：
|
||||
|
||||
| 模块 | 说明 |
|
||||
| --- | --- |
|
||||
| `MacroLibrary/` | 核心工具集，含 ~60 个分类宏文件，覆盖数学、几何、天文、排序、编码等 |
|
||||
| `Type/` | 特殊数据类型：四叉树/八叉树、字典树、多维布尔、软引用、卡尔曼滤波器等 |
|
||||
| `AI/Chat/` | DeepSeek AI 聊天接口封装 |
|
||||
| `PlayerController/` | 第一/三人称及上帝视角控制器 |
|
||||
| `SuperStyleSheet/` | XSSS 样式表运行时 |
|
||||
| `Debugger/` | Gizmos 调试绘制 |
|
||||
| `Nav/` | A* 寻路 |
|
||||
| `Net/` | LAN 局域网通信 |
|
||||
| `Generation/` | 程序化生成（楼梯、平面开孔等） |
|
||||
| `Security/` | 程序流安全控制 |
|
||||
| `CollisionLOD/` | 碰撞体 LOD 系统 |
|
||||
| `XericComponent/` | 组件系统（样条曲线、网格布局、生命周期核心） |
|
||||
| `RegistrationActivation/` | 注册激活码校验 |
|
||||
| `MachineID/` | 机器码验证授权 |
|
||||
|
||||
---
|
||||
|
||||
## 编辑器界面
|
||||
|
||||
- **太阳系模拟界面**：注册激活窗口内嵌的日心说太阳系动画，在编辑器上也能看到漂亮的天体（地球、月球、大气等）。
|
||||
- **预编译宏管理**：`XericLibrary/Define Symbols/预设宏管理` 菜单入口，勾选框式增删编译标记。
|
||||
- **DeepSeek AI 对话**：编辑器内 AI 聊天窗口。
|
||||
- **生命周期性能分析**：`XLifeCycleProfile` 窗口，分析组件生命周期耗时。
|
||||
- **Hierarchy 面板定制**：增强的 Hierarchy 显示。
|
||||
- **颜色渐变编辑器**：线性颜色渐变编辑窗口。
|
||||
- **2D 纹理数组工具**：批量管理纹理数组。
|
||||
|
||||
---
|
||||
|
||||
## 示例文件
|
||||
|
||||
- **Roslyn 检查器**：位于 `Release/Samples~/XericUnityAnalyzer/`，包含编译后的分析器 DLL 及安装说明。提供组件搜索、命名规范、对象关系、富文本检测等代码分析规则，源码见 `Developer/XericUnityAnalyzer/`。
|
||||
- **配置界面 UI**：`Release/Samples~/ConfigUIElement/`，自动化配置界面的预制体与脚本示例。
|
||||
- **轨迹线路**：`Release/Samples~/HorizonLineOrbit/`，平面线路绘制与导航示例。
|
||||
|
||||
---
|
||||
|
||||
## 依赖此插件的扩展
|
||||
|
||||
| 插件 | 说明 |
|
||||
| --- | --- |
|
||||
| XericUIActionVessel | UI 动作容器插件，提供 UI 界面、UIToolkit 扩展及高性能表格实现 |
|
||||
| XericCICD | Unity CI/CD 工作流配置界面及 Git 界面 |
|
||||
| XericWebRequest | Unity WebRequest 封装，提供请求时间轴检查器及 AI 对话示例 |
|
||||
| DigitalTwinTool | Unity 数字孪生常用功能集合 |
|
||||
| Xeric_Editor | Unity 编辑器美化和功能集合扩展 |
|
||||
| ScreenDetectionLayerPicker | 高性能屏幕空间模型数据组提取，支持 WebGL |
|
||||
| XericMeshTool | 可视化蓝图连线处理模型及模型生成 |
|
||||
| MaterialLibrary | Shader 库及后处理库，包含 BIRP、URP、HDRP |
|
||||
|
||||
---
|
||||
|
||||
## 编译标记
|
||||
|
||||
使用编译标记启用的特殊功能：
|
||||
|
||||
- `XericLibrary`：通用启用特殊功能。
|
||||
|
||||
---
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 插件涉及多平台切换时，可能提供多种自动或手动切换方案，或默认使用 Windows 平台，请注意辨别。
|
||||
- 如发现版本兼容性、计算错误、调用错误、使用问题，可通过发布页 Issues 或其他联系方式获得帮助。
|
||||
|
||||
Reference in New Issue
Block a user