@ives_xxz/framework 1.0.0

package/entry/FWEntry.ts

@@ -0,0 +1,196 @@
+import FWUiManager from '../manager/FWUiManager';
+import Framework from '../Framework';
+import FWLog from '../log/FWLog';
+import FWAnimationManager from '../manager/FWAnimationManager';
+import FWAudioManager from '../manager/FWAudioManager';
+import FWComponentManager from '../manager/FWComponentManager';
+import FWEventManager from '../manager/FWEventManager';
+import FWLanguageManager from '../manager/FWLanguageManager';
+import { FWLayerManager } from '../manager/FWLayerManager';
+import FWObjectManager from '../manager/FWObjectManager';
+import { FWResManager } from '../manager/FWResManager';
+import FWSocketManager from '../manager/FWSocketManager';
+import { FWStateManager } from '../manager/FWStateManager';
+import { FWTimeManager } from '../manager/FWTimeManager';
+import FWScene from '../scene/FWScene';
+import { FWSocketAutoProcessPause } from '../expand/FWDecorator';
+import { FWEventDefine } from '../define/FWEventDefine';
+import FWTaskManager from '../manager/FWTaskManager';
+import FWEngineManager from '../manager/FWEngineManager';
+import FWHotUpdateManager from '../manager/FWHotUpdateManager';
+
+/**
+ * 入口脚本
+ */
+export default class FWEntry implements FW.Entry {
+  map: Map<string, FW.RegisterBundle>;
+  /**
+   * 事件管理器
+   */
+  timeMgr: FW.TimeManager;
+  /**
+   * 层级管理器
+   */
+  layerMgr: FW.LayerManager;
+  /**
+   * 资源管理器
+   */
+  resMgr: FW.ResManager;
+  /**
+   * 动画管理器
+   */
+  animationMgr: FW.AnimationManager;
+  /**
+   * 状态管理器
+   */
+  stateMgr: FW.StateManager;
+  /**
+   * 音效管理器
+   */
+  audioMgr: FW.AudioManager;
+  /**
+   * socket管理器
+   */
+  socketMgr: FW.SocketManager;
+  /**
+   * 对象管理器
+   */
+  objectMgr: FW.ObjectManager;
+  /**
+   * 事件管理器
+   */
+  evtMgr: FW.EventManager;
+  /**
+   * UI管理器
+   */
+  uiMgr: FW.UiManager;
+  /**
+   * 任务管理器
+   */
+  taskMgr: FW.TaskManager;
+  /**
+   * 组件管理器
+   */
+  componentMgr: FWComponentManager;
+  /**
+   * 多语言管理器
+   */
+  languageMgr: FW.LanguageManager;
+  /**
+   * 引擎管理器
+   */
+  engineMgr: FW.EngineManager;
+  /**
+   * 热更新管理器
+   */
+  hotUpdateMgr: FW.HotUpdateManager;
+  /**
+   * 当前Scene
+   */
+  scene: FWScene;
+  /**
+   * bundle名字
+   */
+  bundleName: string;
+
+  /**
+   * 初始化
+   * */
+  initialize() {
+    this.map = new Map<string, FW.RegisterBundle>();
+    this.engineMgr = new FWEngineManager();
+    this.taskMgr = new FWTaskManager();
+    this.evtMgr = new FWEventManager();
+    this.resMgr = new FWResManager();
+    this.layerMgr = new FWLayerManager();
+    this.timeMgr = new FWTimeManager();
+    this.uiMgr = new FWUiManager();
+    this.animationMgr = new FWAnimationManager();
+    this.stateMgr = new FWStateManager();
+    this.audioMgr = new FWAudioManager();
+    this.objectMgr = new FWObjectManager();
+    this.socketMgr = new FWSocketManager();
+    this.componentMgr = new FWComponentManager();
+    this.languageMgr = new FWLanguageManager();
+    this.hotUpdateMgr = new FWHotUpdateManager();
+
+    this.resMgr.initialize();
+    this.layerMgr.initialize();
+    this.timeMgr.initialize();
+    this.animationMgr.initialize();
+    this.stateMgr.initialize();
+  }
+
+  /**
+   * 启动场景
+   * @param bundleName bundle名字
+   * @param sceneName 场景名字
+   */
+  @FWSocketAutoProcessPause()
+  launchScene(name: string): void {
+    FW.Entry.layerMgr.clear();
+    if (!this.hasSceneName(name)) {
+      try {
+        cc.director.loadScene(name);
+        return;
+      } catch (e) {
+        FWLog.error('launchScene failed:', name);
+      }
+    }
+    if (this.bundleAutoRelease(this.bundleName)) {
+      this.releaseBundle(this.bundleName);
+    }
+    this.bundleName = name;
+    cc.director.loadScene(this.getSceneName());
+  }
+
+  releaseBundle(bundleName: string) {
+    this.resMgr.releaseBundle(bundleName);
+    this.evtMgr.dispatch(`${FWEventDefine.SystemEvent.BUNDLE_RELEASE}-${bundleName}`);
+  }
+
+  register(data: FW.RegisterBundle) {
+    this.map.set(data.bundleName, data);
+  }
+
+  bundleAutoRelease(bundleName: string) {
+    const autoRelease = this.map.get(bundleName)?.autoRelease;
+    return autoRelease === undefined ? true : autoRelease;
+  }
+
+  getDepend(bundleName: string) {
+    return this.map.get(bundleName)?.depend || [];
+  }
+
+  hasSceneName(sceneName: string) {
+    return this.map.has(sceneName);
+  }
+
+  getSceneName() {
+    return this.map.get(this.bundleName)?.sceneName || undefined;
+  }
+
+  getComponent: <T>(serviceIdentifier: FW.ServiceIdentifier<T>) => T = (serviceIdentifier) =>
+    Framework.getComponent(serviceIdentifier);
+
+  getComponents: <T>(serviceIdentifier?: FW.ServiceIdentifier<T>) => T[] = (serviceIdentifier) =>
+    Framework.getComponents(serviceIdentifier);
+
+  onDestroy() {
+    this.resMgr.onDestroy();
+    this.layerMgr.onDestroy();
+    this.timeMgr.onDestroy();
+    this.animationMgr.onDestroy();
+    this.stateMgr.onDestroy();
+
+    this.resMgr = null;
+    this.layerMgr = null;
+    this.timeMgr = null;
+    this.animationMgr = null;
+    this.stateMgr = null;
+  }
+
+  update(dt: number) {
+    this.timeMgr?.onUpdate(dt);
+  }
+}

package/entry/FWEntry.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "8848bb37-a1fc-43cf-967d-63e757e5d663",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}

package/entry.meta

@@ -0,0 +1,13 @@
+{
+  "ver": "1.1.3",
+  "uuid": "0886dc2c-004b-4b93-9c5e-eae8ac86edee",
+  "importer": "folder",
+  "isBundle": false,
+  "bundleName": "",
+  "priority": 1,
+  "compressionType": {},
+  "optimizeHotUpdate": {},
+  "inlineSpriteFrames": {},
+  "isRemoteBundle": {},
+  "subMetas": {}
+}

package/expand/FWCocosExpand.ts

@@ -0,0 +1,73 @@
+/**
+ * 游戏整体速率修改
+ */
+if (CC_DEBUG) {
+  let timeScaler = 1;
+
+  const originCalculateDeltaTime = cc.Director.prototype['calculateDeltaTime'];
+  cc.director['calculateDeltaTime'] = function (now) {
+    originCalculateDeltaTime.call(this, now);
+    this._deltaTime *= timeScaler;
+  };
+
+  /**
+   *  修改时间倍率
+   *
+   * @param {number} scaler 倍率值
+   */
+  FW.timeScale = function (scaler = 1) {
+    timeScaler = scaler;
+    return `当前帧率缩放比=${timeScaler}`;
+  };
+}
+
+/**
+ * 编辑器模式下预览spine动画
+ */
+if (CC_DEBUG && CC_EDITOR) {
+  cc.game.once(cc.game.EVENT_ENGINE_INITED, function () {
+    cc.js.mixin(sp.Skeleton.prototype, {
+      update(dt) {
+        // if (CC_EDITOR) return;
+
+        if (CC_EDITOR) {
+          cc['engine']._animatingInEditMode = 1;
+          cc['engine'].animatingInEditMode = 1;
+        }
+
+        if (this.paused) return;
+
+        dt *= this.timeScale * sp['timeScale'];
+
+        if (this.isAnimationCached()) {
+          // Cache mode and has animation queue.
+          if (this._isAniComplete) {
+            if (this._animationQueue.length === 0 && !this._headAniInfo) {
+              let frameCache = this._frameCache;
+              if (frameCache && frameCache.isInvalid()) {
+                frameCache.updateToFrame();
+                let frames = frameCache.frames;
+                this._curFrame = frames[frames.length - 1];
+              }
+              return;
+            }
+            if (!this._headAniInfo) {
+              this._headAniInfo = this._animationQueue.shift();
+            }
+            this._accTime += dt;
+            if (this._accTime > this._headAniInfo.delay) {
+              let aniInfo = this._headAniInfo;
+              this._headAniInfo = null;
+              this.setAnimation(0, aniInfo.animationName, aniInfo.loop);
+            }
+            return;
+          }
+
+          this._updateCache(dt);
+        } else {
+          this._updateRealtime(dt);
+        }
+      },
+    });
+  });
+}

package/expand/FWCocosExpand.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "a17028d0-eb34-48e2-846a-ce7bbd25a8f4",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}

package/expand/FWDecorator.ts

@@ -0,0 +1,256 @@
+import 'reflect-metadata';
+import FWLog from '../log/FWLog';
+
+type PropertyDecorator = (
+  $class: Record<string, any>,
+  $propertyKey: string | symbol,
+  $descriptorOrInitializer?: any,
+) => void;
+
+const searchChild = function (node: cc.Node, name: string) {
+  let ret = node.getChildByName(name);
+  if (ret) return ret;
+  for (let i = 0; i < node.children.length; i++) {
+    let child = node.children[i];
+    if (!child.isValid) continue;
+    ret = searchChild(child, name);
+    if (ret) return ret;
+  }
+  return null;
+};
+
+const CookDecoratorKey = ($desc: string) => `__ccc_decorator_${$desc}__`;
+
+const KeyChild = CookDecoratorKey('child_cache');
+
+type ParamType = {
+  path?: string;
+};
+
+export function FWPropertyNode($opt?: ParamType): PropertyDecorator {
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  return ($target, $propertyKey: string, $descriptorOrInitializer) => {
+    const cache: { propertyKey: string; childName: string }[] = ($target[KeyChild] ??= []);
+    if (!cache.some(($vo) => $vo.propertyKey === $propertyKey)) {
+      cache.push({
+        propertyKey: $propertyKey,
+        childName: $opt?.path || $propertyKey,
+      });
+    } else {
+      throw new Error(`child 装饰器重复绑定属性：${$propertyKey},class：${$target?.name}`);
+    }
+    if (cache.length === 1) {
+      const oldOnLoad: () => void = $target.onLoad || undefined;
+      $target.onLoad = function () {
+        cache.forEach(($vo) => (this[$vo.propertyKey] = searchChild(this.node, $vo.childName)));
+        oldOnLoad && oldOnLoad.apply(this);
+      };
+    }
+  };
+}
+
+const KeyChildMulti = CookDecoratorKey('child_cache_multi'); // 重新定义 Key，避免冲突
+
+/** 查找多个节点，并存储为数组 */
+export function FWPropertyNodes(...paths: string[]): PropertyDecorator {
+  return ($target: any, $propertyKey: string) => {
+    // 确保 $target[KeyChild] 是数组
+    if (!$target[KeyChildMulti]) {
+      $target[KeyChildMulti] = [];
+    }
+
+    const cache: { propertyKey: string; childNames: string[] }[] = $target[KeyChildMulti];
+
+    // 查找是否已经存在该属性的绑定
+    const existingEntry = cache.find(($vo) => $vo.propertyKey === $propertyKey);
+
+    // 如果没有找到绑定，则添加
+    if (!existingEntry) {
+      cache.push({
+        propertyKey: $propertyKey,
+        childNames: paths,
+      });
+    } else {
+      throw new Error(
+        `child 装饰器重复绑定属性：${$propertyKey}, class：${$target.constructor.name}`,
+      );
+    }
+
+    // 确保只绑定一次 onLoad，防止重复调用
+    if (cache.length === 1) {
+      const oldOnLoad = $target.onLoad;
+
+      $target.onLoad = function () {
+        if (!this.node) {
+          console.error(`this.node 为空，无法查找子节点`, this);
+          return;
+        }
+        cache.forEach(($vo) => {
+          const nodes: cc.Node[] = [];
+
+          // 将所有路径对应的节点存入数组
+          $vo.childNames.forEach((childName) => {
+            const childNode = searchChild(this.node, childName);
+            if (!childNode) {
+              console.warn(`未找到子节点：${childName}`);
+            } else {
+              nodes.push(childNode);
+            }
+          });
+
+          // 将结果赋值为数组，保证拿到所有节点
+          this[$vo.propertyKey] = nodes;
+        });
+
+        // 调用父类 onLoad 方法
+        if (oldOnLoad) {
+          oldOnLoad.apply(this);
+        }
+      };
+    }
+  };
+}
+
+interface INewable<T = any> extends Function {
+  new (...args: any[]): T;
+}
+
+const KeyComp = CookDecoratorKey('comp_cache');
+
+export function FWPropertyComponent(
+  $componentClass: INewable<cc.Component>,
+  $childName?: string,
+  $mute = false,
+): PropertyDecorator {
+  return ($target, $propertyKey: string, $descriptorOrInitializer) => {
+    const cache: {
+      propertyKey: string;
+      compClass: INewable<cc.Component>;
+      childName: string;
+    }[] = ($target[KeyComp] ??= []);
+    if (!cache.some(($vo) => $vo.propertyKey === $propertyKey)) {
+      cache.push({
+        propertyKey: $propertyKey,
+        compClass: $componentClass,
+        childName: $childName || $propertyKey,
+      });
+    } else {
+      if (!$mute) {
+        throw new Error(`component装饰器重复绑定属性：${$propertyKey},class：${$target.name}`);
+      }
+      return;
+    }
+    if (cache.length === 1) {
+      const oldOnLoad: () => void = $target.onLoad || undefined; //$target.onLoad也可以拿到父类的实现
+      $target.onLoad = function () {
+        cache.forEach(($vo) => {
+          const node = $vo.childName ? searchChild(this.node, $vo.childName) : this.node;
+          if (!node) {
+            if (!$mute) {
+              throw new Error(
+                `component装饰器没有找到适合的node节点:class：${$target?.name}，组件：${$componentClass?.name}，childName：${$childName}`,
+              );
+            } else {
+              return;
+            }
+          }
+          this[$vo.propertyKey] =
+            node.getComponent($vo.compClass) || node.addComponent($vo.compClass);
+        });
+        oldOnLoad && oldOnLoad.apply(this);
+      };
+    }
+  };
+}
+
+export function FWPropertyComponents(
+  $componentClass: INewable<cc.Component>,
+  $childName?: string,
+): PropertyDecorator {
+  return ($target, $propertyKey: string, $descriptorOrInitializer) => {
+    const componentName = $childName || $propertyKey;
+    const oldOnLoad: () => void = $target.onLoad || undefined; //$target.onLoad也可以拿到父类的实现
+    $target.onLoad = function () {
+      const components = this.node.getComponentsInChildren($componentClass);
+      if (components.length == 0) return;
+      this[$propertyKey] = components.filter((v) => {
+        return v.node.name == componentName;
+      });
+      oldOnLoad && oldOnLoad.apply(this);
+    };
+  };
+}
+
+/** 判断是否为空 */
+export function isNull(message?: string) {
+  return function (target: any, propertyKey: string) {
+    let value: any;
+
+    const getter = function () {
+      return value;
+    };
+
+    const setter = function (newVal: any) {
+      if (newVal === null || newVal === undefined) {
+        const errorMsg = message || `${propertyKey} 不能为 null 或 undefined`;
+        console.error(errorMsg);
+        throw new Error(errorMsg);
+      }
+      value = newVal;
+    };
+
+    // 使用 defineProperty 来替换原来的属性
+    Object.defineProperty(target, propertyKey, {
+      get: getter,
+      set: setter,
+      enumerable: true,
+      configurable: true,
+    });
+  };
+}
+
+export function FWSocketAutoProcessPause() {
+  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+    const originalMethod = descriptor.value;
+
+    descriptor.value = async function (...args: any[]) {
+      try {
+        const result = await originalMethod.apply(this, args);
+        return result;
+      } finally {
+        FWLog.debug('暂停socket消息处理');
+        FW.Entry.socketMgr.resumeMessageHandle();
+      }
+    };
+
+    return descriptor;
+  };
+}
+
+export function FWDeprecated(description?: string) {
+  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function (...args: any[]) {
+      FWLog.warn(`${propertyKey}方法已弃用!${description || ''}`);
+      originalMethod.apply(this, args);
+    };
+    return descriptor;
+  };
+}
+export function FWSocketAutoProcessResume() {
+  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+    const originalMethod = descriptor.value;
+
+    descriptor.value = async function (...args: any[]) {
+      try {
+        const result = await originalMethod.apply(this, args);
+        return result;
+      } finally {
+        FWLog.debug('恢复socket消息处理');
+        FW.Entry.socketMgr.resumeMessageHandle();
+      }
+    };
+
+    return descriptor;
+  };
+}

package/expand/FWDecorator.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "96d84c32-0f47-4743-bf8f-9a72adda6f7f",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}