lywsvip/oops-plugin-framework
1
0
Fork 0
mirror of https://gitee.com/dgflash/oops-plugin-framework.git synced 2026-09-03 04:03:46 +08:00
Code Issues Packages Projects Releases Wiki Activity

Commit Graph

  • 0152111f7c 删除模板的废弃方法 优化对象池在剔除Spine库后的报错问题 develop dgflash 2026-07-04 16:52:51 +08:00
  • 0717fa481c 完善音乐模块的稳定性 dgflash 2026-07-04 11:30:07 +08:00
  • 0c47d793d6 去掉游戏配置中网络参数定义 dgflash 2026-07-03 09:34:32 +08:00
  • 09292618ad 跳过 Toggle 节点，避免与 Toggle 编辑器中配置的 checkEvents 冲突 dgflash 2026-07-01 22:39:56 +08:00
  • 3034bf944a 优化 dgflash 2026-06-29 18:29:29 +08:00
  • daa660f7be 优化 dgflash 2026-06-29 16:58:29 +08:00
  • 08f5ee4e20 优化 dgflash 2026-06-29 15:16:26 +08:00
  • 399e96127d 支持动态修改配置表的位置 dgflash 2026-06-29 12:58:35 +08:00
  • f9ed43cf14 优化 dgflash 2026-06-28 07:39:21 +08:00
  • 7686fa6169 添加本地存储key的约束 dgflash 2026-06-27 14:28:38 +08:00
  • a4702bce24 非ECS的界面也可以通过CCEntity.addUi添加 dgflash 2026-06-27 10:45:09 +08:00
  • 986042a870 动画状态机组件优化 dgflash 2026-06-25 10:19:54 +08:00
  • 55279464bd 修复ButtonSimple按钮音效不播放问题 dgflash 2026-06-22 08:24:18 +08:00
  • b08619eaf3 优化 dgflash 2026-06-21 23:02:14 +08:00
  • f497041f70 修复RtToModel警告 dgflash 2026-06-20 10:45:25 +08:00
  • ce9411a079 优化 dgflash 2026-06-19 19:48:06 +08:00
  • c91e4c8246 优化 dgflash 2026-06-19 19:47:20 +08:00
  • 6e8d53d6b4 废弃ButtonSimple的防连点功能 dgflash 2026-06-19 19:29:39 +08:00
  • 5f19367769 废弃UIButton使用 @debounce.click()处理防连点功能 dgflash 2026-06-19 19:25:40 +08:00
  • bbbb9b6835 解决ECS框架文件之间的相互依赖 dgflash 2026-06-19 14:00:22 +08:00
  • 2acc9bd7e8 修复提示系统加载与 RichText 兼容问题 dgflash 2026-06-19 13:26:40 +08:00
  • 6cdce6eeee fix:修复游戏切后台再切回时音效重复异常播放问题 dgflash 2026-06-18 22:43:52 +08:00
  • c88903eac0 refactor(gui): 提示资源配置外部化，修复弹窗遮罩加载失败 dgflash 2026-06-18 22:21:06 +08:00
  • ccd6688a64 fix: 增强调试信息提示，修复 CCView onLoad 访问修饰符 dgflash 2026-06-18 13:41:25 +08:00
  • 75df7296a2 修复extensions\oops-plugin-framework\assets\libs\ecs\pool\index.ts编译报错 3.1.0.20260504 dgflash 2026-06-16 19:45:56 +08:00
  • ba64e8d586 feat: 添加 @classname 装饰器，修复打包后类名混淆导致 addBusiness 属性绑定失败的问题 dgflash 2026-06-13 18:59:37 +08:00
  • 4fc6652dfd 修复发布模式下类名混淆导致addBusinesss属性绑定失败的问题 dgflash 2026-06-13 15:32:25 +08:00
  • 3a2db77647 1. 核心入口 — ECS.ts ecs 命名空间：统一导出所有 API，业务只需 import { ecs } from './ECS' 核心类型别名：ecs.Entity / ecs.Comp / ecs.RootSystem / ecs.ComblockSystem 接口再导出：ecs.IComp / ecs.IMatcher / ecs.IEntityEnterSystem / ecs.IEntityRemoveSystem / ecs.ISystemFirstUpdate / ecs.ISystemUpdate 实体工厂：ecs.getEntity(ctor, world?) — 创建或从对象池获取实体 动态查询：ecs.query(matcher, world?) — 按匹配器查询实体 过滤器工厂：ecs.allOf() / ecs.anyOf() / ecs.onlyOf() / ecs.excludeOf() — 组合匹配规则 单例组件：ecs.getSingleton() / ecs.addSingleton() — 全局唯一组件访问 子模块门面：ecs.world / ecs.pool / ecs.system / ecs.storage / ecs.network / ecs.serialize / ecs.entityRef 2. 驱动器 — ECSDriver.ts 封装默认世界的 init / execute / destroy 生命周期 add(system) — 向默认世界添加业务系统 init() — 初始化 ECS（并入 @ecs.register 注册的系统、拓扑排序、init） execute(dt) — 驱动默认世界一帧 destroy() — 清理所有子系统 3. 实体 — ECSEntity.ts 组件容器：位掩码 mask + 按 tid 索引的密集数组，get/has 为 O(1) 双重重载 add()： add(组件类) — 从对象池取实例或恢复软移除缓存 add(组件实例) — 挂载外部实例（如 cc.Component），设 canRecycle=false remove(ctor, isRecycle?)： isRecycle=true（默认）：reset + 回池/释放 SoA 槽位 isRecycle=false：软移除，数据暂存 compTid2Obj，下次 add 同 tid 恢复 父子层级：addChild / removeChild，带循环引用检测 destroy()：断开父子 → 移除全部组件 → 清理软移除缓存 → 回收实体 + 释放 eid forEachComponent(cb)：遍历当前挂载的所有组件 4. 组件 — ECSComp.ts 抽象基类，子类须实现 reset() 方法 canRecycle — 是否可回收（外部创建的组件设 false） ent — 拥有该组件的实体引用 变更检测：markDirty() / isChangedSince(sinceEpoch) / lastWriteEpoch — 基于 epoch 的帧级脏标记 5. 位掩码 — ECSMask.ts 基于 Uint32Array 的位运算，支持 set / has / delete / and / or / bitCount 对象池复用，clearPool() 清理 6. 注册系统 — ECSRegister.ts + ECSTypeRegistry.ts @ecs.register('Name') 类装饰器：自动识别注册类型 组件：分配 tid，写入 compCtors 表 实体：记录 ctor → name 映射 系统：注册到全局表或指定世界 ECSTypeRegistry：全局类型注册表（跨世界共享），记录组件/实体/系统元数据 7. 查询 — ECSMatcher.ts + ECSGroup.ts 四种规则：AllOf / AnyOf / OnlyOf / ExcludeOf，规则间为"与"关系 flyweight 缓存：相同组合共享同一 Matcher 实例 小规则优化：tid 数 ≤ 4 时直接 mask.has，否则分配 ECSMask ECSGroup：SparseSet 实现，O(1) 增删（swap-pop），稳定快照遍历 进入/离开追踪：watchEntityEnterAndRemove 供系统帧内查询变化 8. 系统 — ECSComblockSystem.ts + ECSRootSystem.ts ComblockSystem：业务系统基类 生命周期：init → entityEnter → firstUpdate → update → entityRemove → onDestroy filter() — 声明实体匹配规则 interval — 执行间隔（0=每帧，>0=固定间隔） 被动系统：isPassiveSystem() 返回 true 时不参与每帧 update 构造时探测子类钩子，选定 execute 变体（零开销分支） RootSystem：根系统，一世界一个 init() — 并入 @ecs.register 系统 + 拓扑排序 + 绑定世界 + init execute(dt) — 切换当前世界 → 递增 epoch → tick 各系统 → flush 命令缓冲 9. 系统调度 — SystemScheduler.ts 声明式执行顺序：@ecs.system.executeBefore / @ecs.system.executeAfter / @ecs.system.inSet 拓扑排序（Kahn 算法）：无约束系统保持原始顺序，循环依赖抛 CycleDependencyError 集合机制：inSet('名') 把系统加入虚拟分组，其他系统用 executeAfter('set:名') 批量依赖 10. 世界 — ECSWorld.ts + ECSWorldManager.ts ECSWorld：运行期数据容器 entities — 活动实体表（eid → 实体） groups — 响应式查询分组 singletons — 单例组件表 refs — @entityRef 引用追踪 commands — 延迟结构变更命令队列 epoch — 世代号（每帧递增，变更检测用） getEntity(ctor) — 创建/从池获取实体 assignEid(entity, eid) — 反序列化时保持 eid 一致 ECSWorldManager（ecs.world）：多世界管理 get(name?) / default() / current — 获取/切换世界 use(world) — 切换当前世界，返回切换前的世界 inWorld(world, fn) — 在指定世界中执行，自动还原 createSystems(world, ...ctors) — 批量装配系统并 init defer(fn) / flushCommands() — 延迟结构变更 11. 命令缓冲 — ECSCommandBuffer.ts 延迟结构变更队列，帧末由 RootSystem.execute 统一 flush push(fn) 入队，flush() 先快照再执行（避免本帧新入队命令在本帧执行） 12. 对象池 — ECSPoolManager.ts + ECSDynamicPool.ts ecs.pool：统一管理实体/组件动态对象池 getPool(name, factory) — 获取或创建池 clearAll() / clearPools() — 清空池缓存（不触碰存活数据） getAllMetrics() — 获取各池统计信息（命中/未命中/缓存/创建数） 13. 实体引用 — ECSEntityRef.ts + ECSReferenceTracker.ts @ecs.entityRef() 属性装饰器：标记组件属性为实体引用 目标实体销毁时自动置 null，避免悬空引用 组件回收时 clearComponentEntityRefs 清理所有引用 14. SoA 列存储 — StorageSoA.ts + StorageDecorators.ts @ecs.storage.enableSoA 类装饰器：为组件启用 SoA 列存储（默认 AoS，opt-in） 字段装饰器：float64 / float32 / int32 / uint32 / int16 / uint16 / int8 / uint8 数值字段按列存入 TypedArray，按 eid 分配槽位 acquire 返回 Proxy 视图：SoA 字段读写直接落到 TypedArray，非 SoA 字段走后备实例 槽位超出容量时 2 倍扩容，释放时入空闲栈 自注册机制：模块加载时注册到核心，删除 storage/ 目录后基础 ECS 仍可运行 15. 网络同步 — NetworkSync.ts + SyncDecorators.ts + SyncCodec.ts + ByteBuffer.ts @ecs.network.sync(类型) 字段装饰器：标记组件字段参与网络同步 ecs.network.net 门面： encodeWorld(op?) — 编码当前世界为紧凑二进制（Full 全量 / Delta 增量） applyToWorld(bytes, onMissing?) — 将二进制同步数据应用到世界 track(entity, markAll?) — 为实体初始化变更追踪器 clearDirty() — 清除所有脏标记 SyncCodec：实体/组件级编解码器 ByteWriter / ByteReader：二进制读写缓冲（变长整数等） ChangeTracker：字段级脏标记追踪 16. 序列化 — Serialization.ts + Incremental.ts @ecs.serialize() 字段装饰器：标记组件需要持久化的字段 全量序列化： ecs.serialize.serializeWorld(pretty?) — 序列化当前世界为 JSON ecs.serialize.deserializeWorld(json) — 从 JSON 反序列化到当前世界 增量序列化： ecs.serialize.snapshot() — 对当前世界拍快照（基线） ecs.serialize.computeDelta(base) — 计算相对基线的增量（added / removed / changed） ecs.serialize.applyDelta(delta) — 将增量应用到当前世界 保留实体层级（parentEid），两阶段重建（先建实体+组件，再重建父子） 17. 监控日志 — ECSMonitorLogger.ts 零入侵监控模块，通过控制台命令触发 注册全局命令： ecsLog() — 打印所有监控表格 ecsWorldSummary() — 各世界实体/系统/组件缓存统计 ecsSummary() — 总体统计（所有世界合计） ecsEntityPools() — 实体池明细（命中/未命中/缓存） ecsCompPools() — 组件池明细（按 M/B/V/VC 分类排序） ecsEntityCaches() — 实体软移除组件缓存明细 ecsHelp() — 显示帮助信息 dgflash 2026-06-12 21:52:47 +08:00
  • e8d42c140c 删除已废弃的按钮组件 ButtonEffect 和 ButtonTouchLong dgflash 2026-06-06 21:36:56 +08:00
  • 0b06fcb11e 优化 dgflash 2026-05-30 06:59:39 +08:00
  • 4b9b05fa9f 修复动画效果回收失败问题 dgflash 2026-05-30 06:50:57 +08:00
  • ddad261b38 优化 dgflash 2026-05-30 06:30:31 +08:00
  • d4f140077e feat (core): 完善框架核心功能模块 - 音频、对象池、资源加载与组件系统 新增与优化核心模块 🎯 GUI 交互增强 ButtonInterceptor：按钮点击事件劫持器 劫持 EventHandler.emitEvents / ButtonSimple.onClick 核心方法 支持多类型按钮音效配置注册，按按钮类型自动匹配音效 单例模式管理，支持全局动态激活 / 停用拦截功能 🧩 对象池管理系统 GameNodePool：通用游戏节点对象池管理器 基于预制体（Prefab）UUID 实现池化隔离管理 支持特效、UI 元素等高频对象预加载、复用与回收 全局单例访问，统一管控对象创建 / 销毁逻辑 🔊 音频管理系统 AudioManager：音频核心管理器 独立背景音乐（AudioMusic）+ 音效池（AudioEffectPool）双模块 支持全局音量控制、播放状态恢复与场景切换管理 AudioEffect：基础音效播放器 AudioEnum：音频类型、音效分类枚举定义 📦 资源加载系统 ResLoader：资源加载核心控制器 资源包（Bundle）统一管理 + 并发加载限流控制 远程资源本地缓存、自动释放与内存优化 完整加载进度回调 + 错误异常处理机制 ResTypes：资源类型规范定义 ResErrors：资源加载错误码与异常处理 ResUtils：资源路径、格式转换等工具方法 🧱 模块化组件系统 GameComponent：游戏显示对象组件基类 集成资源自动引用计数（RC）管理 模块化部件（GamePartRegistry）插拔式架构 内置音频、按钮、事件、键盘、节点、对象池、资源七大部件 部件封装： GamePartAudio：音频功能部件 GamePartButton：按钮交互部件 GamePartEvent：全局事件部件 GamePartKeyboard：键盘输入部件 GamePartNode：节点操作部件 GamePartNodePool：对象池调用部件 GamePartRes：资源加载部件 📝 类型定义完善 新增 IAudio 音频数据与播放参数接口 统一全模块 TS 类型定义与导出规范 优化接口注释与类型约束，提升开发体验 dgflash 2026-05-29 22:55:13 +08:00
  • 0484015e7a 优化 dgflash 2026-05-25 22:41:55 +08:00
  • 6a486bbbc6 优化 dgflash 2026-05-22 22:52:11 +08:00
  • 58d145b7dc 优化 dgflash 2026-05-22 22:22:33 +08:00
  • d33b668810 添加： 1. 自动管理资源引用计数 - 多组件共享资源时不会错误释放 2. 组件销毁时自动释放资源引用 - 开发者无需手动管理 3. 全局资源追踪 - 可查看任意资源的引用者和引用计数 dgflash 2026-05-17 20:11:06 +08:00
  • 7ae9b3506c !30 修复LayerPopUp关闭遮罩时把mask节点的uiSprite关闭了，但是打开遮罩时没有启用，导致只有第一个PopUp能显示mask dgflash 2026-05-17 11:05:37 +00:00
  • e58951632b 修复LayerPopUp关闭遮罩时把mask节点的uiSprite关闭了，但是打开遮罩时没有启用，导致只有第一个PopUp能显示mask dgflash 2026-05-17 18:58:28 +08:00
  • 508e5bb2d2 优化ECS dgflash 2026-05-10 21:53:03 +08:00
  • 3a61f0420f 优化ECS dgflash 2026-05-10 21:44:38 +08:00
  • a829dde974 优化ECS dgflash 2026-05-10 21:40:04 +08:00
  • c2f787e964 优化ECS dgflash 2026-05-10 21:25:36 +08:00
  • 1d8f4988a4 优化ECS dgflash 2026-05-10 21:01:29 +08:00
  • 2c0b5cfa6e 更新版本号 dgflash 2026-05-04 16:20:04 +08:00
  • 3c3b7f4f64 refactor(gui): 提取屏幕适配逻辑到独立 ScreenAdapter 类 dgflash 2026-05-03 21:18:01 +08:00
  • 12aedf1491 优化提示 dgflash 2026-04-29 22:44:22 +08:00
  • d333ff5371 feat(gui): 添加界面缓存查询方法 hasCache dgflash 2026-04-26 23:13:00 +08:00
  • 70930f8037 微信小游戏真机调试环境兼容 dgflash 2026-04-22 09:31:52 +08:00
  • b64c03ede8 强类型事件支持传空参数 dgflash 2026-04-21 12:20:00 +08:00
  • e274dbb062 修复 loading 转圈因 clearTimeout 提前执行导致无法关闭的 bug，完善状态管理与关闭逻辑 dgflash 2026-04-10 22:13:45 +08:00
  • 0746948455 fix(GameComponent): 修复资源加载相关的安全问题和内存泄漏 dgflash 2026-04-05 12:22:28 +08:00
  • 5a43c3d08e 优化强类型事件类型 dgflash 2026-04-05 11:15:01 +08:00
  • b32c550b15 1.规范化框架业务模板的提示信息 2.废弃GameCollision.ts dgflash 2026-04-05 11:05:58 +08:00
  • 9a4fd82dcf CCBusiness支持事件系统全部功能 dgflash 2026-04-05 10:52:32 +08:00
  • 0e569dc31e 统一框架中d.ts文件风格 dgflash 2026-04-05 10:26:24 +08:00
  • 4d9d2eac96 优化强类型事件类型 dgflash 2026-04-05 10:19:24 +08:00
  • 79d5ee8637 优化强类型事件类型 dgflash 2026-04-05 10:00:53 +08:00
  • 421c7db39e 优化聚焦强类型事件方法命名规范调整，核心改动为：废弃原有基于重载区分事件方法的实现方式，统一采用语义化、独立化的方法命名规则。适配 AI 自动生成代码的理解与解析逻辑 dgflash 2026-04-05 09:19:31 +08:00
  • da020de1ff 框架工具控制Cocos Creator 自动打开预制绑定脚本 dgflash 2026-04-04 22:37:24 +08:00
  • 0b85ccd193 !29 fix(gui): 修复 onBeforeRemove 回调不触发的问题 3.0.0.20260220 dgflash 2026-04-01 14:39:58 +00:00
  • d2c68fbab5 fix(gui): 修复 onBeforeRemove 回调不触发的问题 dgflash 2026-04-01 22:38:10 +08:00
  • 976a60aa3a update README.md. dgflash 2026-03-31 14:03:52 +00:00
  • 46bcb58828 update README.md. master dgflash 2026-03-31 14:03:29 +00:00
  • 9d10e89d47 update README.md. dgflash 2026-03-31 14:03:02 +00:00
  • 9ef16dd1e9 update README.md. dgflash 2026-03-31 14:02:41 +00:00
  • 21e40ac65c update README.md. dgflash 2026-03-31 01:15:35 +00:00
  • a922da32de update README.md. dgflash 2026-03-31 01:15:12 +00:00
  • 1672c6e1ea update README.md. dgflash 2026-03-29 15:10:47 +00:00
  • 09aaab7acf update README.md. dgflash 2026-03-29 15:10:24 +00:00
  • 99fd688924 倒计时标签（组合方式实现，不继承 Label），因为在模拟器中下会导致标签文本渲染不出来 dgflash 2026-03-24 09:14:31 +08:00
  • a2c24af485 update README.md. dgflash 2026-03-21 03:15:05 +00:00
  • e06697f4a8 1. 修复常驻 PopUp（如 Main）存在时，最后一个 mask:true 弹窗关闭后，共享 mask 不再残留 2.BlockInputEvents 与 mask 生命周期同步管理 3.代码可维护性提升，职责分离更清晰 dgflash 2026-03-21 09:35:02 +08:00
  • d43f1de76c ECS 对象池优化 dgflash 2026-03-08 17:27:27 +08:00
  • 0b808f6ab1 优化CCEntity的addPrefab、addUi异步操作时，对象被释放时空对象问题，提高框架稳定性 dgflash 2026-03-08 13:59:24 +08:00
  • 605e0b8d76 CCView 使用MVVM功能时性能优化 dgflash 2026-03-08 13:42:41 +08:00
  • b7aa3b6d2a Mvvm ViewModel 生命周期自动管理功能，彻底解决了临时tag的命名冲突和内存泄漏问题 dgflash 2026-03-08 13:27:48 +08:00
  • 5776b5b7b8 Mvvm VMBase组件路径解析的性能优化 dgflash 2026-03-08 13:16:41 +08:00
  • 2c95d13b9e 1. 明确文档说明isRecycle=false的使用场景 2. 提供清理缓存的API dgflash 2026-03-08 12:46:52 +08:00
  • 9d65c31016 MVVM里JsonOb深度监听的性能优化 1. 防止重复观察同一对象 2.优化数组操作（只监听新增元素） 3.支持冻结数据（不监听静态配置） 4.支持批量更新（减少回调次数） 5.支持自定义深度限制 6.更安全的内存管理 7.API 完全兼容原始版本，可零改动升级 dgflash 2026-03-08 12:09:10 +08:00
  • 2350b06c84 ECS 缓存管理优化 dgflash 2026-03-08 11:49:53 +08:00
  • f1b4efcabb !28 删除框架中老版工具代码，和没有用到的第三方库，避免编辑器提示没有第三方库报错 Merge pull request !28 from dgflash/develop dgflash 2026-03-02 14:39:24 +00:00
  • 47c4e935f9 删除框架中老版工具代码，和没有用到的第三方库，避免编辑器提示没有第三方库报错 dgflash 2026-03-02 22:38:30 +08:00
  • 3203f20e7c !27 修改MVCompsEdit类名为VMCompsEdit，统一风格 Merge pull request !27 from dgflash/develop dgflash 2026-03-02 14:23:05 +00:00
  • 59cc70ef6d 修改MVCompsEdit类名为VMCompsEdit，统一风格 dgflash 2026-03-02 12:58:15 +08:00
  • 648fbcbb1f 行为树框架添加数据配置功能的支持，为后续可视化界面开发做准备 dgflash 2026-03-01 12:06:19 +08:00
  • f928e4ca88 !26 优化 ECS 和 MVVM 相关代码的性能与可读性 Merge pull request !26 from dgflash/develop dgflash 2026-02-26 14:53:50 +00:00
  • 2efe3a1982 优化 ECS 和 MVVM 相关代码的性能与可读性 dgflash 2026-02-26 22:52:49 +08:00
  • 13cfa37bf3 框架配置数据支持强类型 dgflash 2026-02-24 21:50:47 +08:00
  • e82d48253c !25 . Merge pull request !25 from dgflash/develop dgflash 2026-02-23 12:38:00 +00:00
  • 500f7dcb1c . dgflash 2026-02-23 20:12:35 +08:00
  • c5ddb8c100 优化框架中自定义 type dgflash 2026-02-23 17:41:50 +08:00
  • aec1a6567f 1. 为 Gui.ts 添加完整类型注解 2.修复 CCBusiness 事件释放方法 3.提取 CCEntity 类型至统一模块，优化 addPrefab 方法 dgflash 2026-02-23 11:53:30 +08:00
  • 2da486bd77 废弃老版图片压缩工具，使用工具集插件中的代替 dgflash 2026-02-22 22:47:27 +08:00
  • fca918c47c CCEntity.addUi与CCEntity.removeUi支持CCView与GameComponent类型的界面打开与移除 dgflash 2026-02-22 21:24:44 +08:00
  • a226450564 业务层组件自动绑定到实体属性上，优化开发体验 dgflash 2026-02-22 18:37:27 +08:00
  • e206e43268 删除没用到的资源 dgflash 2026-02-21 22:17:01 +08:00
  • 1c3b4e6a83 !24 修改版本号信息 Merge pull request !24 from dgflash/develop dgflash 2026-02-21 05:09:05 +00:00
  • d9bf916225 修改版本号信息 dgflash 2026-02-21 13:06:46 +08:00
  • 01905f183e 优化显示对象模块的自动化内存管理逻辑 dgflash 2026-02-20 17:37:27 +08:00