@ives_xxz/framework 1.6.5 → 2.0.0

package/manager/FWAudioManager.ts

@@ -1,6 +1,4 @@
-import { FWManager } from "./FWManager";
-import FWLog from "../log/FWLog";
-import { FWSystemDefine } from "../define/FWSystemDefine";
+import { FWManager } from './FWManager';
 
 class FWAudioData {
   clip: cc.AudioClip;
@@ -11,17 +9,10 @@ class FWAudioData {
 }
 
 class FWAudioPoolItem {
-  constructor(
-    public audioId: number,
-    public startTime: number,
-    public tag?: string
-  ) {}
+  constructor(public audioId: number, public startTime: number, public tag?: string) {}
 }
 
-export default class FWAudioManager
-  extends FWManager
-  implements FW.AudioManager
-{
+export default class FWAudioManager extends FWManager implements FW.AudioManager {
   musicVolume: number = 1;
   effectsVolume: number = 1;
   soundVolume: number = 1;
@@ -38,21 +29,13 @@ export default class FWAudioManager
    * 播放背景音乐
    */
   async playMusic(path: string, volume?: number, loop?: boolean): Promise<void>;
-  async playMusic(
-    music: cc.AudioClip,
-    volume?: number,
-    loop?: boolean
-  ): Promise<void>;
-  async playMusic(
-    assetProperty: FW.AssetProperty,
-    volume?: number,
-    loop?: boolean
-  ): Promise<void>;
+  async playMusic(music: cc.AudioClip, volume?: number, loop?: boolean): Promise<void>;
+  async playMusic(assetProperty: FW.AssetProperty, volume?: number, loop?: boolean): Promise<void>;
   async playMusic(): Promise<void> {
     try {
       const audioData = await this.processAudioArguments(
         arguments,
-        FWSystemDefine.FWAudioType.MUSIC
+        FW.SystemDefine.FWAudioType.MUSIC,
       );
       if (!audioData.clip) return;
 
@@ -63,9 +46,9 @@ export default class FWAudioManager
       const id = cc.audioEngine.playMusic(audioData.clip, loop);
       cc.audioEngine.setVolume(id, volume);
 
-      FWLog.debug(`播放背景音乐: ${this.getAudioName(audioData.clip)}`);
+      FW.Log.debug(`播放背景音乐: ${this.getAudioName(audioData.clip)}`);
     } catch (e) {
-      FWLog.error("播放音乐失败:", e);
+      FW.Log.error('播放音乐失败:', e);
     }
   }
 
@@ -95,40 +78,39 @@ export default class FWAudioManager
     cb?: (id: number) => void,
     volume?: number,
     loop?: boolean,
-    tag?: string
+    tag?: string,
   ): Promise<number>;
   async play(
     audio: cc.AudioClip,
     cb?: (id: number) => void,
     volume?: number,
     loop?: boolean,
-    tag?: string
+    tag?: string,
   ): Promise<number>;
   async play(
     assetProperty: FW.AssetProperty,
     cb?: (id: number) => void,
     volume?: number,
     loop?: boolean,
-    tag?: string
+    tag?: string,
   ): Promise<number>;
   async play(): Promise<number> {
     try {
       if (this.audioPool.size >= this.maxConcurrentAudio) {
         this.clearFinishedAudio();
         if (this.audioPool.size >= this.maxConcurrentAudio) {
-          FWLog.warn("音频池已满，无法播放新音频");
+          FW.Log.warn('音频池已满，无法播放新音频');
           return -1;
         }
       }
 
       const audioData = await this.processAudioArguments(
         arguments,
-        FWSystemDefine.FWAudioType.SOUND
+        FW.SystemDefine.FWAudioType.SOUND,
       );
       if (!audioData.clip) return -1;
 
-      const volume =
-        (audioData.volume ?? this.soundVolume) * this.effectsVolume;
+      const volume = (audioData.volume ?? this.soundVolume) * this.effectsVolume;
       const loop = audioData.loop ?? false;
       const tag = audioData.tag;
 
@@ -143,7 +125,7 @@ export default class FWAudioManager
 
       return id;
     } catch (e) {
-      FWLog.error("播放音效失败:", e);
+      FW.Log.error('播放音效失败:', e);
       return -1;
     }
   }
@@ -155,30 +137,30 @@ export default class FWAudioManager
     if (this.audioPool.has(id)) {
       cc.audioEngine.stop(id);
       this.audioPool.delete(id);
-      FWLog.debug(`停止音效: ID ${id}`);
+      FW.Log.debug(`停止音效: ID ${id}`);
     }
   }
 
   pauseAll(): void {
     cc.audioEngine.pauseAll();
-    FWLog.debug("暂停所有音效");
+    FW.Log.debug('暂停所有音效');
   }
 
   resumeAll(): void {
     cc.audioEngine.resumeAll();
-    FWLog.debug("恢复所有音效");
+    FW.Log.debug('恢复所有音效');
   }
 
   stopAll(): void {
     cc.audioEngine.stopAll();
     this.audioPool.clear();
-    FWLog.debug("停止所有音效");
+    FW.Log.debug('停止所有音效');
   }
 
   /** 设置播放音效是否静音 */
   setSoundMute(mute: boolean): void {
     this.soundVolume = mute ? 0 : 1;
-    FWLog.debug(`音效${mute ? "静音" : "取消静音"}`);
+    FW.Log.debug(`音效${mute ? '静音' : '取消静音'}`);
   }
 
   /**
@@ -188,7 +170,7 @@ export default class FWAudioManager
     try {
       let clip: cc.AudioClip;
 
-      if (typeof assetProperty === "string") {
+      if (typeof assetProperty === 'string') {
         clip = await FW.Entry.resMgr.loadAsset<cc.AudioClip>({
           path: assetProperty,
           bundle: FW.Entry.bundleName,
@@ -249,7 +231,7 @@ export default class FWAudioManager
    */
   private async processAudioArguments(
     args: IArguments,
-    type: FWSystemDefine.FWAudioType
+    type: FW.SystemDefine.FWAudioType,
   ): Promise<FWAudioData> {
     const audioData = new FWAudioData();
     const argsArray = Array.from(args);
@@ -261,7 +243,7 @@ export default class FWAudioManager
       audioData.clip = await this.loadAudioClip(assetProperty);
     }
 
-    if (type === FWSystemDefine.FWAudioType.MUSIC) {
+    if (type === FW.SystemDefine.FWAudioType.MUSIC) {
       audioData.volume = argsArray[1];
       audioData.loop = argsArray[2];
     } else {
@@ -278,7 +260,7 @@ export default class FWAudioManager
    * 标准化资源属性
    */
   private normalizeAssetProperty(input: any): FW.AssetProperty {
-    if (typeof input === "string") {
+    if (typeof input === 'string') {
       return {
         path: input,
         bundle: FW.Entry.bundleName,
@@ -290,9 +272,7 @@ export default class FWAudioManager
   /**
    * 加载音频片段
    */
-  private async loadAudioClip(
-    assetProperty: FW.AssetProperty
-  ): Promise<cc.AudioClip> {
+  private async loadAudioClip(assetProperty: FW.AssetProperty): Promise<cc.AudioClip> {
     try {
       return await FW.Entry.resMgr.loadAsset<cc.AudioClip>(assetProperty);
     } catch (e) {
@@ -304,19 +284,17 @@ export default class FWAudioManager
    * 生成缓存键
    */
   private getCacheKey(assetProperty: FW.AssetProperty): string {
-    if (typeof assetProperty === "string") {
+    if (typeof assetProperty === 'string') {
       return `${FW.Entry.bundleName}_${assetProperty}`;
     }
-    return `${assetProperty.bundle || FW.Entry.bundleName}_${
-      assetProperty.path
-    }`;
+    return `${assetProperty.bundle || FW.Entry.bundleName}_${assetProperty.path}`;
   }
 
   /**
    * 获取音频名称
    */
   private getAudioName(clip: cc.AudioClip): string {
-    return clip.name || "未知音频";
+    return clip.name || '未知音频';
   }
 
   /**
@@ -330,7 +308,7 @@ export default class FWAudioManager
       if (!cc.audioEngine.getState(id)) {
         this.audioPool.delete(id);
       } else if (currentTime - item.startTime > maxAge) {
-        FWLog.warn(`强制停止超时音频: ID ${id}`);
+        FW.Log.warn(`强制停止超时音频: ID ${id}`);
         this.stop(id);
       }
     });
@@ -344,7 +322,7 @@ export default class FWAudioManager
       this.clearFinishedAudio,
       this.cleanupInterval,
       cc.macro.REPEAT_FOREVER,
-      this
+      this,
     );
   }
 

package/manager/FWBundleManager.ts

@@ -1,7 +1,5 @@
 import { FWManager } from './FWManager';
-import FWLog from '../log/FWLog';
 import { FWSystemConfig } from '../config/FWSystemConfig';
-import { FWLodash } from '../utils/FWLodash';
 
 export class FWBundleManager extends FWManager implements FW.BundleManager {
   bundleMap: Map<string, cc.AssetManager.Bundle>;
@@ -44,7 +42,7 @@ export class FWBundleManager extends FWManager implements FW.BundleManager {
           },
           async (err: Error, bundle: cc.AssetManager.Bundle) => {
             if (err || !bundle) {
-              FWLog.error(`"加载bundle失败:"${bundleName}!`);
+              FW.Log.error(`"加载bundle失败:"${bundleName}!`);
               reject(err);
             }
 
@@ -67,7 +65,7 @@ export class FWBundleManager extends FWManager implements FW.BundleManager {
    */
   get(bundleName: string): cc.AssetManager.Bundle {
     if (!this.has(bundleName)) {
-      FWLog.error('获取bundle失败,请先加载!');
+      FW.Log.error('获取bundle失败,请先加载!');
       return undefined;
     }
     return this.bundleMap.get(bundleName);

package/manager/FWComponentManager.ts

@@ -1,4 +1,3 @@
-import FWVirtualViewComponent from '../component/FWVirtualViewComponent';
 import { FWManager } from './FWManager';
 
 export default class FWComponentManager extends FWManager implements FW.ComponentManager {

package/manager/FWEngineManager.ts

@@ -1,7 +1,3 @@
-import { FWEventDefine } from '../define/FWEventDefine';
-import { FWSystemDefine } from '../define/FWSystemDefine';
-import Framework from '../Framework';
-import FWLog from '../log/FWLog';
 import { FWManager } from './FWManager';
 
 export default class FWEngineManager extends FWManager implements FW.EngineManager {
@@ -17,29 +13,29 @@ export default class FWEngineManager extends FWManager implements FW.EngineManag
   }
 
   restart() {
-    FW.Entry.evtMgr.dispatch(FWEventDefine.SystemEvent.SYSTEM_RESTART);
+    FW.Entry.evtMgr.dispatch(FW.EventDefine.SystemEvent.SYSTEM_RESTART);
     FW.Entry.initialize();
-    Framework.restart();
+    FW.Framework.restart();
     cc.game.restart();
   }
 
   getMemory() {
     if (!this.debug) return;
     if (window.performance && window.performance['memory']) {
-      FWLog.debug(
+      FW.Log.debug(
         '浏览器允许的最大内存:',
         this.formatBytes(window.performance['memory'].jsHeapSizeLimit),
       );
-      FWLog.debug(
+      FW.Log.debug(
         '浏览器已分配内存:',
         this.formatBytes(window.performance['memory'].totalJSHeapSize),
       );
-      FWLog.debug(
+      FW.Log.debug(
         '浏览器已使用内存:',
         this.formatBytes(window.performance['memory'].usedJSHeapSize),
       );
     } else {
-      FWLog.debug('当前浏览器不支持 performance.memory');
+      FW.Log.debug('当前浏览器不支持 performance.memory');
     }
   }
   /**
@@ -51,14 +47,14 @@ export default class FWEngineManager extends FWManager implements FW.EngineManag
   }
   /** 应用切换到前台 */
   private onAppShow() {
-    FWLog.debug('game on show!');
-    FW.Entry.evtMgr?.dispatch(FWSystemDefine.CCEventType.ON_SHOW);
+    FW.Log.debug('game on show!');
+    FW.Entry.evtMgr?.dispatch(FW.EventDefine.CCEvent.ON_SHOW);
   }
 
   /** 应用切换到后台 */
   private onAppHide() {
-    FWLog.debug('game on hide!');
-    FW.Entry.evtMgr?.dispatch(FWSystemDefine.CCEventType.ON_HIDE);
+    FW.Log.debug('game on hide!');
+    FW.Entry.evtMgr?.dispatch(FW.EventDefine.CCEvent.ON_HIDE);
   }
 
   private formatBytes(bytes: number) {

package/manager/FWEventManager.ts

@@ -1,6 +1,3 @@
-import { FWSystemDefine } from '../define/FWSystemDefine';
-import FWLog from '../log/FWLog';
-
 /**
  * 观察者
  */
@@ -166,13 +163,13 @@ export default class FWEventManager implements FW.EventManager {
     ) => void,
     target: FW.TargetType,
     options?: {
-      priority?: FWSystemDefine.FWPriorityOrder;
+      priority?: number;
       intercept?: boolean;
       once?: boolean;
     },
   ) {
     const observers = this.listeners[eventName];
-    const define = FWSystemDefine.FWPriorityOrder;
+    const define = FW.SystemDefine.FWPriorityOrder;
     const priority = options?.priority === undefined ? define.NORMAL : options.priority;
     const intercept = options?.intercept === undefined ? false : options.intercept;
     const once = options?.once === undefined ? false : options.once;
@@ -218,13 +215,13 @@ export default class FWEventManager implements FW.EventManager {
     ) => void,
     target: FW.TargetType,
     options?: {
-      priority?: FWSystemDefine.FWPriorityOrder;
+      priority?: number;
       intercept?: boolean;
     },
   ) {
     this.register(eventName, cb, target, {
       ...options,
-      once: true, // 强制设置为一次性事件
+      once: true,
     });
   }
 

package/manager/FWHotUpdateManager.ts

@@ -1,4 +1,3 @@
-import FWLog from '../log/FWLog';
 import { FWManager } from './FWManager';
 
 const TEMOTE_ASSET = 'remote-asset';
@@ -15,16 +14,16 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
 
   setListener(listener: FW.HotUpdateListener): FW.HotUpdateManager {
     this.listener = listener;
-    FWLog.debug('热更新监听设置');
+    FW.Log.debug('热更新监听设置');
     return this;
   }
 
   public update(localManifest: cc.Asset) {
     if (!localManifest) {
-      FWLog.error('没有找到本地Manifest文件!');
+      FW.Log.error('没有找到本地Manifest文件!');
       return;
     }
-    FWLog.debug('开始热更新流程');
+    FW.Log.debug('开始热更新流程');
     this.localManifest = localManifest;
     this.storePath = `${jsb.fileUtils ? jsb.fileUtils.getWritablePath() : '/'}${TEMOTE_ASSET}`;
     this.assetMgr = new jsb.AssetsManager('', this.storePath, this.versionCompareHandle.bind(this));
@@ -43,7 +42,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
   }
 
   private versionCompareHandle(currentVersion: string, newVersion: string): number {
-    FWLog.debug('版本比较', currentVersion, newVersion);
+    FW.Log.debug('版本比较', currentVersion, newVersion);
     this.currentVersion = currentVersion;
     this.newVersion = newVersion;
     this.listener.versionCompareHandle(this.currentVersion, this.newVersion);
@@ -74,7 +73,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
   }
 
   private checkHotUpdate() {
-    FWLog.debug('checkHotUpdate1', this.isUpdate);
+    FW.Log.debug('checkHotUpdate1', this.isUpdate);
     if (this.isUpdate) {
       return;
     }
@@ -82,17 +81,17 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
       this.assetMgr.loadLocalManifest(this.localManifest.nativeUrl);
     }
 
-    FWLog.debug('checkHotUpdate3', this.assetMgr.getLocalManifest());
+    FW.Log.debug('checkHotUpdate3', this.assetMgr.getLocalManifest());
 
-    FWLog.debug('checkHotUpdate4', this.assetMgr.getLocalManifest().isLoaded());
+    FW.Log.debug('checkHotUpdate4', this.assetMgr.getLocalManifest().isLoaded());
 
     if (!this.assetMgr.getLocalManifest() || !this.assetMgr.getLocalManifest().isLoaded()) {
-      FWLog.debug('本地manifest未加载，尝试重新加载');
+      FW.Log.debug('本地manifest未加载，尝试重新加载');
       this.reloadLocalManifest();
 
       // 如果仍然无法加载，则返回
       if (!this.assetMgr.getLocalManifest() || !this.assetMgr.getLocalManifest().isLoaded()) {
-        FWLog.error('无法加载本地manifest文件');
+        FW.Log.error('无法加载本地manifest文件');
         return;
       }
     }
@@ -109,37 +108,37 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
         this.assetMgr.loadLocalManifest(updatedManifestPath);
 
         if (this.assetMgr.getLocalManifest() && this.assetMgr.getLocalManifest().isLoaded()) {
-          FWLog.debug('本地manifest重新加载成功');
+          FW.Log.debug('本地manifest重新加载成功');
           this.localManifest = this.assetMgr.getLocalManifest();
         } else {
-          FWLog.error('本地manifest重新加载失败');
+          FW.Log.error('本地manifest重新加载失败');
         }
       } else {
-        FWLog.error('更新后的manifest文件不存在:', updatedManifestPath);
+        FW.Log.error('更新后的manifest文件不存在:', updatedManifestPath);
       }
     } catch (error) {
-      FWLog.error('重新加载本地manifest时出错:', error);
+      FW.Log.error('重新加载本地manifest时出错:', error);
     }
   }
 
   private checkEventHandle(event: any) {
     const code = event.getEventCode();
-    FWLog.debug('checkEvent getEventCode -> ', code);
+    FW.Log.debug('checkEvent getEventCode -> ', code);
     switch (code) {
       case jsb.EventAssetsManager.ERROR_NO_LOCAL_MANIFEST:
-        FWLog.debug('checkEvent getEventCode -> ', 'ERROR_NO_LOCAL_MANIFEST');
+        FW.Log.debug('checkEvent getEventCode -> ', 'ERROR_NO_LOCAL_MANIFEST');
         break;
       case jsb.EventAssetsManager.ERROR_DOWNLOAD_MANIFEST:
-        FWLog.debug('checkEvent getEventCode -> ', 'ERROR_DOWNLOAD_MANIFEST');
+        FW.Log.debug('checkEvent getEventCode -> ', 'ERROR_DOWNLOAD_MANIFEST');
         break;
       case jsb.EventAssetsManager.ERROR_PARSE_MANIFEST:
-        FWLog.debug('checkEvent getEventCode -> ', 'ERROR_PARSE_MANIFEST');
+        FW.Log.debug('checkEvent getEventCode -> ', 'ERROR_PARSE_MANIFEST');
         break;
       case jsb.EventAssetsManager.ALREADY_UP_TO_DATE:
-        FWLog.debug('checkEvent getEventCode -> ', 'ALREADY_UP_TO_DATE');
+        FW.Log.debug('checkEvent getEventCode -> ', 'ALREADY_UP_TO_DATE');
         break;
       case jsb.EventAssetsManager.NEW_VERSION_FOUND:
-        FWLog.debug('checkEvent getEventCode -> ', 'NEW_VERSION_FOUND');
+        FW.Log.debug('checkEvent getEventCode -> ', 'NEW_VERSION_FOUND');
         break;
       default:
         return;
@@ -148,7 +147,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
     this.listener.checkHotUpdateHandle?.(code);
     this.assetMgr.setEventCallback(null!);
     this.isUpdate = false;
-    FWLog.debug(
+    FW.Log.debug(
       'isFind New Version -> ',
       event.getEventCode() == jsb.EventAssetsManager.NEW_VERSION_FOUND,
     );
@@ -158,10 +157,10 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
   }
 
   private hotUpdate() {
-    FWLog.debug('start hotUpdate ->', this.assetMgr, this.isUpdate);
+    FW.Log.debug('start hotUpdate ->', this.assetMgr, this.isUpdate);
     if (this.assetMgr && !this.isUpdate) {
       this.assetMgr.setEventCallback(this.updateEventHandle.bind(this));
-      FWLog.debug(
+      FW.Log.debug(
         'assetMgr state ->',
         this.assetMgr.getState() === jsb.AssetsManager.State.UNINITED,
       );
@@ -185,7 +184,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
     let convertTotalBytes: string = '';
     const code = event.getEventCode();
     const msg = event.getMessage();
-    FWLog.debug('updateEvent getEventCode -> ', code);
+    FW.Log.debug('updateEvent getEventCode -> ', code);
     let str = '';
     switch (code) {
       case jsb.EventAssetsManager.ERROR_NO_LOCAL_MANIFEST:
@@ -194,7 +193,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
         break;
       case jsb.EventAssetsManager.UPDATE_PROGRESSION:
         str = 'UPDATE_PROGRESSION';
-        FWLog.debug('updateEvent percent -> ', event.getPercent());
+        FW.Log.debug('updateEvent percent -> ', event.getPercent());
         if (event.getPercent() > 0) {
           downloadedFiles = event.getDownloadedFiles();
           totalFiles = event.getTotalFiles();
@@ -203,7 +202,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
           convertDownloadedBytes = this.convertBytes(downloadedBytes);
           convertTotalBytes = this.convertBytes(totalBytes);
           percent = event.getPercent();
-          FWLog.debug(
+          FW.Log.debug(
             '正在更新中 -> ',
             '下载文件数量:',
             downloadedFiles,
@@ -236,7 +235,7 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
           convertDownloadedBytes = this.convertBytes(downloadedBytes);
           convertTotalBytes = this.convertBytes(totalBytes);
           percent = event.getPercent();
-          FWLog.debug(
+          FW.Log.debug(
             '正在更新完成 -> ',
             '下载文件数量:',
             downloadedFiles,
@@ -266,8 +265,8 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
         break;
     }
 
-    FWLog.debug('热更新中->', str);
-    FWLog.debug('热更新msg ->', msg);
+    FW.Log.debug('热更新中->', str);
+    FW.Log.debug('热更新msg ->', msg);
     this.listener.hotUpdatingHandle?.(code, {
       percent: percent,
       downloadedFiles: downloadedFiles,
@@ -278,15 +277,15 @@ export default class FWHotUpdateManager extends FWManager implements FW.HotUpdat
       convertTotalBytes: convertTotalBytes,
     });
     if (failed) {
-      FWLog.debug('热更新中结果 failed -> ', failed);
-      FWLog.debug('下载失败');
+      FW.Log.debug('热更新中结果 failed -> ', failed);
+      FW.Log.debug('下载失败');
       this.assetMgr.setEventCallback(null!);
       this.isUpdate = false;
       this.retry();
     }
     if (needRestart) {
-      FWLog.debug('热更新中结果 needRestart -> ', needRestart);
-      FWLog.debug('下载完成');
+      FW.Log.debug('热更新中结果 needRestart -> ', needRestart);
+      FW.Log.debug('下载完成');
       const searchPaths = jsb.fileUtils.getSearchPaths();
       const newPaths = this.assetMgr.getLocalManifest().getSearchPaths();
       Array.prototype.unshift.apply(searchPaths, newPaths);

package/manager/FWLanguageManager.ts

@@ -1,4 +1,3 @@
-import { FWEventDefine } from '../define/FWEventDefine';
 import { FWManager } from './FWManager';
 
 export default class FWLanguageManager extends FWManager implements FW.LanguageManager {
@@ -91,7 +90,7 @@ export default class FWLanguageManager extends FWManager implements FW.LanguageM
   async initializeLanguage(language: string) {
     if (this.language == language) return;
     this.language = language;
-    FW.Entry.evtMgr.dispatch(FWEventDefine.LanguageEvent.LANGUAGE_CHANGE);
+    FW.Entry.evtMgr.dispatch(FW.EventDefine.LanguageEvent.LANGUAGE_CHANGE);
   }
 
   getLanguageIndex() {