@cc-component/cc-core 1.2.8

package/assets/core/interface/MainModule.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "2a625de7-3c1a-46f8-b2a9-4bcf30407cf6",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/assets/core/interface.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "b05086b8-fc86-4ae0-ac03-a2eba5a8f197",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/assets/core/lib/Logger.ts

@@ -0,0 +1,286 @@
+import { log } from "cc";
+
+/** 日志类型 */
+export enum LogType {
+    Close = 100,
+    /** 网络层日志 */
+    Net = 1,
+    /** 数据结构层日志 */
+    Model = 2,
+    /** 业务逻辑层日志 */
+    Business = 4,
+    /** 视图层日志 */
+    View = 8,
+    /** 配置日志 */
+    Config = 16,
+    /** 标准日志 */
+    Trace = 32,
+}
+
+var names = {
+    "1": "网络日志",
+    "2": "数据日志",
+    "4": "业务日志",
+    "8": "视图日志",
+    "16": "配置日志",
+    "32": "标准日志",
+}
+
+/** 
+ * 日志管理 
+ * @example
+oops.log.trace("默认标准日志");
+oops.log.logConfig("灰色配置日志");
+oops.log.logNet("橙色网络日志");
+oops.log.logModel("紫色数据日志");
+oops.log.logBusiness("蓝色业务日志");
+oops.log.logView("绿色视图日志");
+ */
+export class Logger {
+    private static tags: number = 0;
+
+    private static init(): void {
+        this.tags =
+            LogType.Net |
+            LogType.Model |
+            LogType.Business |
+            LogType.View |
+            LogType.Config |
+            LogType.Trace;
+
+    }
+
+    /** 
+     * 设置显示的日志类型，默认值为不显示任何类型日志
+     * @example
+oops.log.setTags(LogType.View|LogType.Business)
+     */
+    static setTags(tag: LogType = null!) {
+        if (tag) {
+            this.tags = tag;
+        }
+    }
+
+    /**
+     * 记录开始计时
+     * @param describe  标题描述
+     * @example
+oops.log.start();
+...
+省略N行代码
+...
+oops.log.end();
+     */
+    static start(describe: string = "Time"): void {
+        console.time(describe);
+    }
+
+    /**
+     * 打印范围内时间消耗
+     * @param describe  标题描述
+     * @example
+oops.log.start();
+...
+省略N行代码
+...
+oops.log.end();
+     */
+    static end(describe: string = "Time"): void {
+        console.timeEnd(describe);
+    }
+
+    /**
+     * 打印表格
+     * @param msg       日志消息
+     * @param describe  标题描述
+     * @example
+var object:any = {uid:1000, name:"oops"};
+oops.log.table(object);
+     */
+    static table(msg: any, describe?: string) {
+        if (!this.isOpen(LogType.Trace)) {
+            return;
+        }
+        console.table(msg);
+    }
+
+    /**
+     * 打印标准日志
+     * @param msg       日志消息
+     */
+    static trace(msg: any, color: string = "color:#000000;") {
+        // 标记没有打开，不打印该日志
+        if (!this.isOpen(LogType.Trace)) {
+            return;
+
+        }
+        var backLog = console.log || log;
+        backLog.call(null, "%c%s%s", color, this.getDateString(), msg);
+    }
+
+    /**
+     * 打印网络层日志
+     * @param msg       日志消息
+     * @param describe  标题描述
+     */
+    static logNet(msg: any, describe?: string) {
+        this.orange(LogType.Net, msg, describe);
+    }
+
+    /**
+     * 打印数据层日志
+     * @param msg       日志消息
+     * @param describe  标题描述
+     */
+    static logModel(msg: any, describe?: string) {
+        this.violet(LogType.Model, msg, describe);
+    }
+
+    /**
+     * 打印业务层日志
+     * @param msg       日志消息
+     * @param describe  标题描述
+     */
+    static logBusiness(msg: any, describe?: string) {
+        this.blue(LogType.Business, msg, describe);
+    }
+
+    /**
+     * 打印视图日志
+     * @param msg       日志消息
+     * @param describe  标题描述
+     */
+    static logView(msg: any, describe?: string) {
+        this.green(LogType.View, msg, describe);
+    }
+
+    /** 打印配置日志 */
+    static logConfig(msg: any, describe?: string) {
+        this.gray(LogType.Config, msg, describe);
+    }
+
+    // 橙色
+    private static orange(tag: LogType, msg: any, describe?: string) {
+        this.print(tag, msg, "color:#FFA442;", describe)
+    }
+
+    // 紫色
+    private static violet(tag: LogType, msg: any, describe?: string) {
+        this.print(tag, msg, "color:Violet;", describe)
+    }
+
+    // 蓝色
+    private static blue(tag: LogType, msg: any, describe?: string) {
+        this.print(tag, msg, "color:#3a5fcd;", describe)
+    }
+
+    // 绿色
+    private static green(tag: LogType, msg: any, describe?: string) {
+        this.print(tag, msg, "color:green;", describe)
+    }
+
+    // 灰色
+    private static gray(tag: LogType, msg: any, describe?: string) {
+        this.print(tag, msg, "color:gray;", describe)
+    }
+
+    private static isOpen(tag: LogType): boolean {
+        return (this.tags & tag) != 0;
+    }
+
+    /**
+     * 输出日志
+     * @param tag       日志类型
+     * @param msg       日志内容
+     * @param color     日志文本颜色
+     * @param describe  日志标题描述
+     */
+    private static print(tag: LogType, msg: any, color: string, describe?: string) {
+        // 标记没有打开，不打印该日志
+        if (!this.isOpen(tag)) {
+            return;
+
+        }
+        var backLog = console.log || log;
+        var type = names[tag];
+        if (describe) {
+            backLog.call(null, "%c%s%s%s:%s%o", color, this.getDateString(), '[' + type + ']', this.stack(5), describe, msg);
+        }
+        else {
+            backLog.call(null, "%c%s%s%s:%o", color, this.getDateString(), '[' + type + ']', this.stack(5), msg);
+        }
+    }
+
+    private static stack(index: number): string {
+        var e = new Error();
+        var lines = e.stack!.split("\n");
+        var result: Array<any> = [];
+        lines.forEach((line) => {
+            line = line.substring(7);
+            var lineBreak = line.split(" ");
+            if (lineBreak.length < 2) {
+                result.push(lineBreak[0]);
+            }
+            else {
+                result.push({ [lineBreak[0]]: lineBreak[1] });
+            }
+        });
+
+        var list: string[] = [];
+        var splitList: Array<string> = [];
+        if (index < result.length - 1) {
+            var value: string;
+            for (var a in result[index]) {
+                var splitList = a.split(".");
+
+                if (splitList.length == 2) {
+                    list = splitList.concat();
+                }
+                else {
+                    value = result[index][a];
+                    if (typeof value === "string") {
+                        var start = value!.lastIndexOf("/");
+                        var end = value!.lastIndexOf(".");
+                        if (start > -1 && end > -1) {
+                            var r = value!.substring(start + 1, end);
+                            list.push(r);
+                        }
+                        else {
+                            list.push(value);
+                        }
+                    }
+
+                }
+            }
+        }
+
+        if (list.length == 1) {
+            return "[" + list[0] + ".ts]";
+        }
+        else if (list.length == 2) {
+            return "[" + list[0] + ".ts->" + list[1] + "]";
+        }
+        return "";
+    }
+
+    private static getDateString(): string {
+        let d = new Date();
+        let str = d.getHours().toString();
+        let timeStr = "";
+        timeStr += (str.length == 1 ? "0" + str : str) + ":";
+        str = d.getMinutes().toString();
+        timeStr += (str.length == 1 ? "0" + str : str) + ":";
+        str = d.getSeconds().toString();
+        timeStr += (str.length == 1 ? "0" + str : str) + ":";
+        str = d.getMilliseconds().toString();
+        if (str.length == 1) str = "00" + str;
+        if (str.length == 2) str = "0" + str;
+        timeStr += str;
+
+        timeStr = "[" + timeStr + "]";
+        return timeStr;
+    }
+}
+
+// @ts-ignore
+Logger.init();

package/assets/core/lib/Logger.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "eeda0ce3-1afb-4898-9449-53181c6e4288",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

package/assets/core/lib/language/.language.md

@@ -0,0 +1 @@
+游戏多语言组件

package/assets/core/lib/language/Language.ts

@@ -0,0 +1,133 @@
+import { sys } from "cc";
+import { LanguageData } from "./LanguageData";
+import { LanguagePack } from "./LanguagePack";
+import { Logger } from "../Logger";
+import { LanguageLabel } from "./LanguageLabel";
+import { LanguageSprite } from "./LanguageSprite";
+import { EDITOR } from "cc/env";
+
+/** 多语言管理器 */
+export class LanguageManager {
+    private _languages: Array<string> = [sys.Language.CHINESE, sys.Language.ENGLISH];      // 支持的语言
+    private _languagePack: LanguagePack = new LanguagePack();                              // 语言包
+    private _defaultLanguage: string = sys.Language.CHINESE;                               // 默认语言
+
+    labelArr: Map<string, LanguageLabel> = new Map();
+    spriteArr: Map<string, LanguageSprite> = new Map();
+
+    /** 支持的多种语言列表 */
+    get languages(): string[] {
+        return this._languages;
+    }
+    set languages(languages: Array<string>) {
+        this._languages = languages;
+    }
+
+    /** 设置的当前语言列表中没有配置时，使用默认语言 */
+    set default(lang: string) {
+        this._defaultLanguage = lang || sys.Language.CHINESE;
+    }
+
+    /** 获取当前语种 */
+    get current(): string {
+        return LanguageData.current;
+    }
+
+    /** 语言包 */
+    get pack(): LanguagePack {
+        return this._languagePack;
+    }
+
+    /**
+     * 是否存在指定语言
+     * @param lang  语言名
+     * @returns 存在返回true,则否false
+     */
+    isExist(lang: string): boolean {
+        return this.languages.indexOf(lang) > -1;
+    }
+
+    /** 获取下一个语种 */
+    getNextLang(): string {
+        let supportLangs = this.languages;
+        let index = supportLangs.indexOf(LanguageData.current);
+        return supportLangs[(index + 1) % supportLangs.length];
+    }
+
+    /**
+     * 改变语种，会自动下载对应的语种
+     * @param language 语言名
+     * @param callback 多语言资源数据加载完成回调
+     */
+    setLanguage(bundleName: string, language: string, callback?: Function) {
+        if (language == null || language == "") {
+            language = this._defaultLanguage;
+        }
+        else {
+            language = language.toLowerCase();
+        }
+
+        let index = this.languages.indexOf(language);
+        if (index < 0) {
+            console.log(`当前不支持【${language}】语言，将自动切换到【${this._defaultLanguage}】语言`);
+            language = this._defaultLanguage;
+        }
+
+        if (language === LanguageData.current) {
+            console.log(`当前语言【${language}】语言,没有改变`)
+            callback && callback();
+            return;
+        }
+
+        this.loadLanguageAssets(bundleName, language, (lang: string) => {
+            Logger.logConfig(`当前语言为【${language}】`);
+            const oldLanguage = LanguageData.current;
+            LanguageData.current = language;
+            this._languagePack.updateLanguage(language);
+            this._languagePack.releaseLanguageAssets(oldLanguage);
+            callback && callback();
+        });
+    }
+
+    /**
+     * 根据data获取对应语种的字符
+     * @param labId 
+     * @param arr 
+     */
+    getLangByID(labId: string): string {
+        return LanguageData.getLangByID(labId);
+    }
+
+    /**
+     * 下载语言包素材资源
+     * 包括语言json配置和语言纹理包
+     * @param lang 
+     * @param callback 
+     */
+    loadLanguageAssets(bundleName: string, lang: string, callback: Function) {
+        lang = lang.toLowerCase();
+        return this._languagePack.loadLanguageAssets(bundleName, lang, callback);
+    }
+
+    /**
+     * 释放不需要的语言包资源
+     * @param lang 
+     */
+    releaseLanguageAssets(lang: string) {
+        lang = lang.toLowerCase();
+        this._languagePack.releaseLanguageAssets(lang);
+    }
+
+
+    async addEditorLabel(label: LanguageLabel) {
+        if (EDITOR) {
+            this.labelArr.set(label.uuid, label)
+        }
+
+    }
+    addEditorSprite(spr: LanguageSprite) {
+        if (EDITOR) {
+            this.spriteArr.set(spr.uuid, spr)
+        }
+    }
+}

package/assets/core/lib/language/Language.ts.meta

@@ -0,0 +1,13 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "3757cc59-a8b6-4e6c-876f-3ff810e98ba3",
+  "files": [],
+  "subMetas": {},
+  "userData": {
+    "moduleId": "project:///assets/script/core/gui/language/Language.js",
+    "importerSettings": 4,
+    "simulateGlobals": []
+  }
+}

package/assets/core/lib/language/LanguageData.ts

@@ -0,0 +1,114 @@
+import { assetManager, JsonAsset } from "cc";
+import { Label } from "cc";
+import { TTFFont, Node } from "cc";
+import { IConfig } from "../../config/IConfig";
+import { director } from "cc";
+
+/*
+ * @Author: dgflash
+ * @Date: 2022-02-11 09:31:52
+ * @LastEditors: dgflash
+ * @LastEditTime: 2023-08-22 16:37:40
+ */
+
+/** 框架支持的语言数据类型 */
+export enum LanguageDataType {
+    /** Json格式配置 */
+    Json = "Json",
+    /** Excel生成的Json配置 */
+    Excel = "Excel",
+}
+
+export class LanguageData {
+    /** JSON资源目录 */
+    static path_json: string = "language/json";
+    /** 纹理资源目录 */
+    static path_texture: string = "language/texture";
+    /** SPINE资源目录 */
+    static path_spine: string = "language/spine";
+
+    /** 当前语言 */
+    static current: string = "";
+    /** 语言数据 */
+    static language: Map<string, any> = new Map();
+    /** TTF字体 */
+    static font: TTFFont = null!;
+    static current_def: string = "zh";
+
+
+
+    /** 
+     * 通过多语言关键字获取语言文本 
+     * 
+     * 注：
+     * 
+     * 1、先获取language/json中的配置数据，如果没有者获取config/game/Language配置表中的多语言数据
+     * 
+     * 2、config/game/Language配置表可选使用，不用时不创建同名配置表即可
+     * 
+     * 3、config/game/Language配置表使用oops-plugin-excel-to-json插件生成，点击项目根目录下载update-oops-plugin-framework.bat或update-oops-plugin-framework.sh脚本下载插件
+     */
+    static getLangByID(labId: string): string {
+        if (this.current === "") { this.current = this.current_def }
+        let content: string = null!;
+        for (const [key, value] of this.language) {
+            if (key == LanguageDataType.Excel) {
+                let lang = value[labId];
+                if (lang) content = lang[this.current];
+            }
+            else {
+                content = value[labId];
+            }
+            if (content) return content;
+        }
+        return labId;
+    }
+
+    static async loadDBEditor(node: Node) {
+        if (this.current === "") { this.current = this.current_def }
+        //@ts-ignore
+        let prefabInfo = node._prefab ?? null;
+        let prefabUid: string = prefabInfo?.asset?.uuid;
+        if (!prefabUid) {
+            //@ts-ignore
+            prefabUid = director.getScene()._prefab.fileId
+        }
+        let dbUrl: string = "";
+        if (prefabUid) {
+            //@ts-ignore
+            let absoluteUrl = await Editor.Message.request("asset-db", "query-url", prefabUid);
+            let url = absoluteUrl.split("://");
+            let paths = url[1].split("/");
+            dbUrl = url[0] + "://" + paths[0] + "/" + paths[1];
+            //console.log("absoluteUrl112222:", absoluteUrl, dbUrl);
+            //label
+            return dbUrl
+
+        }
+    }
+    /**编辑器环境下改变多语言 */
+    public static async loadConfig() {
+        const db_json = `db://assets/resources/config.json`
+
+        let uuid = await Editor.Message.request("asset-db", "query-uuid", db_json);
+        await new Promise<void>((resolve) => {
+            assetManager.loadAny(uuid, (err, jsonAsset: JsonAsset) => {
+                // console.log("2加载表格", jsonAsset, err);
+                MainModule.gui.config = jsonAsset.json as IConfig;
+                //console.error(MainModule.gui.config)
+                resolve()
+            });
+        })
+    }
+
+    public static updateLanguage() {
+        if (this.current === "") { this.current = this.current_def }
+
+    }
+}
+
+export const LanguageType = [
+    'LanguageLabel',
+    'LanguageSprite',
+    'LanguageSpine'
+]

package/assets/core/lib/language/LanguageData.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "27fb3b23-0fcd-4994-83f6-2854d2594a78",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}