@ives_xxz/packages 1.0.0

package//345/274/225/347/224/250/346/237/245/346/211/276/345/231/250/src/main/editor-api.js

@@ -0,0 +1,90 @@
+/**
+ * 编辑器 API（用于抹平不同版本编辑器之间的差异）
+ * @author 陈皮皮 (ifaswind)
+ * @version 20210830
+ */
+const EditorAPI = {
+
+    /**
+     * 当前语言
+     * @returns {string}
+     */
+    getLanguage() {
+        return Editor.lang || Editor.I18n.getLanguage();
+    },
+
+    /**
+     * 绝对路径转为编辑器资源路径
+     * @param {string} fspath 
+     */
+    fspathToUrl(fspath) {
+        return Editor.assetdb.fspathToUrl(fspath);
+    },
+
+    /**
+     * 编辑器资源路径转为绝对路径
+     * @param {string} url 
+     */
+    urlToFspath(url) {
+        return Editor.assetdb.urlToFspath(url);
+    },
+
+    /**
+     * 通过 uuid 获取资源信息
+     * @param {string} uuid 
+     */
+    assetInfoByUuid(uuid) {
+        return Editor.assetdb.assetInfoByUuid(uuid);
+    },
+
+    /**
+     * 通过 uuid 获取子资源信息
+     * @param {string} uuid 
+     */
+    subAssetInfosByUuid(uuid) {
+        return Editor.assetdb.subAssetInfosByUuid(uuid);
+    },
+
+    /**
+     * 获取当前选中的资源 uuid
+     * @returns {string[]}
+     */
+    getCurrentSelectedAssets() {
+        return Editor.Selection.curSelection('asset');
+    },
+
+    /**
+     * 获取当前选中的节点 uuid
+     * @returns {string[]}
+     */
+    getCurrentSelectedNodes() {
+        return Editor.Selection.curSelection('node');
+    },
+
+    /**
+     * 是否为 uuid
+     * @param {string} uuid 
+     */
+    isUuid(uuid) {
+        return Editor.Utils.UuidUtils.isUuid(uuid);
+    },
+
+    /**
+     * 压缩 uuid
+     * @param {string} uuid 
+     */
+    compressUuid(uuid) {
+        return Editor.Utils.UuidUtils.compressUuid(uuid);
+    },
+
+    /**
+     * 反压缩 uuid
+     * @param {string} uuid 
+     */
+    decompressUuid(uuid) {
+        return Editor.Utils.UuidUtils.decompressUuid(uuid);
+    },
+
+};
+
+module.exports = EditorAPI;

package//345/274/225/347/224/250/346/237/245/346/211/276/345/231/250/src/main/finder.js

@@ -0,0 +1,248 @@
+const { extname, basename } = require("path");
+const EditorAPI = require("./editor-api");
+const { print, translate } = require("../eazax/editor-main-util");
+const FileUtil = require("../eazax/file-util");
+const { containsValue } = require("./object-util");
+const Parser = require("./parser");
+
+/** 扩展名对应文件类型 */
+const ASSET_TYPE_MAP = {
+    // 场景
+    '.fire': 'scene',
+    '.scene': 'scene',
+    // 预制体
+    '.prefab': 'prefab',
+    // 动画
+    '.anim': 'animation',
+    // 材质
+    '.mtl': 'material',
+    // 字体
+    '.fnt.meta': 'font',
+};
+
+/**
+ * 查找器
+ */
+const Finder = {
+
+    /**
+     * 使用 uuid 进行查找
+     * @param {string} uuid 
+     */
+    async findByUuid(uuid) {
+        // 是否为有效 uuid
+        if (!EditorAPI.isUuid(uuid)) {
+            print('log', translate('invalid-uuid'), uuid);
+            return [];
+        }
+        // 获取资源信息
+        const assetInfo = EditorAPI.assetInfoByUuid(uuid);
+        if (assetInfo) {
+            // 记录子资源 uuid
+            const subAssetUuids = [];
+            // 资源类型检查
+            if (assetInfo.type === 'texture') {
+                // 纹理子资源
+                const subAssetInfos = EditorAPI.subAssetInfosByUuid(uuid);
+                if (subAssetInfos && subAssetInfos.length > 0) {
+                    for (let i = 0; i < subAssetInfos.length; i++) {
+                        subAssetUuids.push(subAssetInfos[i].uuid);
+                    }
+                }
+            } else if (assetInfo.type === 'typescript' || assetInfo.type === 'javascript') {
+                // 脚本资源
+                uuid = EditorAPI.compressUuid(uuid);
+            }
+            // 查找资源引用
+            const results = [],
+                selfResults = await Finder.findRefs(uuid);
+            for (let i = 0, l = selfResults.length; i < l; i++) {
+                results.push(selfResults[i]);
+            }
+            // 查找子资源的引用
+            if (subAssetUuids.length > 0) {
+                for (let i = 0, l = subAssetUuids.length; i < l; i++) {
+                    const subResults = await Finder.findRefs(subAssetUuids[i]);
+                    for (let j = 0, l = subResults.length; j < l; j++) {
+                        results.push(subResults[j]);
+                    }
+                }
+            }
+            return results;
+        } else {
+            // 不存在的资源，直接查找 uuid
+            print('log', translate('find-asset-refs'), uuid);
+            return (await Finder.findRefs(uuid));
+        }
+    },
+
+    /**
+     * 查找引用
+     * @param {string} uuid 
+     * @returns {Promise<{ type: string, url: string, refs?: object[]}[]>}
+     */
+    async findRefs(uuid) {
+        const result = [];
+        // 文件处理函数
+        const handler = async (path, stats) => {
+            const ext = extname(path);
+            if (ext === '.fire' || ext === '.scene' || ext === '.prefab') {
+                // 场景和预制体资源（转为节点树）
+                const tree = await Parser.getNodeTree(path);
+                if (!tree) {
+                    return;
+                }
+                // 遍历第一层节点查找引用
+                const refs = [];
+                for (let children = tree.children, i = 0, l = children.length; i < l; i++) {
+                    Finder.findRefsInNode(tree, children[i], uuid, refs);
+                }
+                // 保存当前文件引用结果
+                if (refs.length > 0) {
+                    result.push({
+                        type: ASSET_TYPE_MAP[ext],
+                        url: EditorAPI.fspathToUrl(path),
+                        refs: refs,
+                    });
+                }
+            } else if (ext === '.anim') {
+                // 动画资源
+                const data = JSON.parse(await FileUtil.readFile(path)),
+                    curveData = data['curveData'],
+                    contains = containsValue(curveData, uuid);
+                if (contains) {
+                    result.push({
+                        type: ASSET_TYPE_MAP[ext],
+                        url: EditorAPI.fspathToUrl(path),
+                    });
+                }
+            } else if (ext === '.mtl' || path.endsWith('.fnt.meta')) {
+                // 材质和字体资源
+                const data = JSON.parse(await FileUtil.readFile(path));
+                // 需排除自己
+                if ((data['uuid'] === uuid)) {
+                    return;
+                }
+                // 是否引用
+                const contains = containsValue(data, uuid);
+                if (contains) {
+                    const _ext = (ext === '.mtl') ? '.mtl' : '.fnt.meta';
+                    result.push({
+                        type: ASSET_TYPE_MAP[_ext],
+                        url: EditorAPI.fspathToUrl(path),
+                    });
+                }
+            }
+        };
+        // 遍历资源目录下的文件
+        const assetsPath = EditorAPI.urlToFspath('db://assets');
+        await FileUtil.map(assetsPath, handler);
+        return result;
+    },
+
+    /**
+     * 查找节点中的引用
+     * @param {object} tree 节点树
+     * @param {object} node 目标节点
+     * @param {string} uuid 查找的 uuid
+     * @param {object[]} result 结果
+     */
+    findRefsInNode(tree, node, uuid, result) {
+        // 检查节点上的组件是否有引用
+        const components = node.components;
+        if (components && components.length > 0) {
+            for (let i = 0, l = components.length; i < l; i++) {
+                const properties = Finder.getContainsUuidProperties(components[i], uuid);
+                if (properties.length === 0) {
+                    continue;
+                }
+                // 资源类型
+                let type = components[i]['__type__'];
+                // 是否为脚本资源
+                if (EditorAPI.isUuid(type)) {
+                    const scriptUuid = EditorAPI.decompressUuid(type),
+                        assetInfo = EditorAPI.assetInfoByUuid(scriptUuid);
+                    type = basename(assetInfo.url);
+                }
+                // 遍历相关属性名
+                for (let i = 0; i < properties.length; i++) {
+                    let property = properties[i];
+                    if (property === '__type__') {
+                        property = null;
+                    } else {
+                        // 处理属性名称（Label 组件需要特殊处理）
+                        if (type === 'cc.Label' && property === '_N$file') {
+                            property = 'font';
+                        }
+                        // 去除属性名的前缀
+                        if (property.startsWith('_N$')) {
+                            property = property.replace('_N$', '');
+                        } else if (property[0] === '_') {
+                            property = property.substring(1);
+                        }
+                    }
+                    // 保存结果
+                    result.push({
+                        node: node.path,
+                        component: type,
+                        property: property,
+                    });
+                }
+            }
+        }
+        // 检查预制体是否有引用
+        const prefab = node.prefab;
+        if (prefab) {
+            // 排除预制体自己
+            if (uuid !== tree.uuid) {
+                const contains = containsValue(prefab, uuid);
+                if (contains) {
+                    result.push({
+                        node: node.path,
+                    });
+                }
+            }
+        }
+        // 遍历子节点
+        const children = node.children;
+        if (children && children.length > 0) {
+            for (let i = 0, l = children.length; i < l; i++) {
+                Finder.findRefsInNode(tree, children[i], uuid, result);
+            }
+        }
+    },
+
+    /**
+     * 获取对象包含指定 uuid 的属性
+     * @param {object} object 对象
+     * @param {string} uuid 值
+     * @returns {string[]}
+     */
+    getContainsUuidProperties(object, uuid) {
+        const properties = [];
+        const search = (target, path) => {
+            if (Object.prototype.toString.call(target) === '[object Object]') {
+                for (const key in target) {
+                    const curPath = (path != null) ? `${path}.${key}` : key;
+                    if (target[key] === uuid) {
+                        properties.push(path || key);
+                    }
+                    search(target[key], curPath);
+                }
+            } else if (Array.isArray(target)) {
+                for (let i = 0, l = target.length; i < l; i++) {
+                    const curPath = (path != null) ? `${path}[${i}]` : `[${i}]`;
+                    if (target[i] === uuid) {
+                        properties.push(path || `[${i}]`);
+                    }
+                    search(target[i], curPath);
+                }
+            }
+        }
+        search(object, null);
+        return properties;
+    },
+
+};
+
+module.exports = Finder;

package//345/274/225/347/224/250/346/237/245/346/211/276/345/231/250/src/main/index.js

@@ -0,0 +1,155 @@
+const PanelManager = require('./panel-manager');
+const ConfigManager = require('../common/config-manager');
+const EditorMainKit = require('../eazax/editor-main-kit');
+const { checkUpdate, print, translate } = require('../eazax/editor-main-util');
+const { openRepository } = require('../eazax/package-util');
+const EditorAPI = require('./editor-api');
+const Parser = require('./parser');
+const Finder = require('./finder');
+const Printer = require('./printer');
+
+/**
+ * 生命周期：加载
+ */
+function load() {
+    // 监听事件
+    EditorMainKit.register();
+}
+
+/**
+ * 生命周期：卸载
+ */
+function unload() {
+    // 取消事件监听
+    EditorMainKit.unregister();
+}
+
+/**
+ * 查找当前选中资源
+ */
+async function findCurrentSelection() {
+    // 过滤选中的资源 uuid
+    const uuids = EditorAPI.getCurrentSelectedAssets();
+    for (let i = 0; i < uuids.length; i++) {
+        const assetInfo = EditorAPI.assetInfoByUuid(uuids[i]);
+        if (assetInfo.type === 'folder') {
+            uuids.splice(i--);
+        }
+    }
+    // 未选择资源
+    if (uuids.length === 0) {
+        print('log', translate('please-select-assets'));
+        return;
+    }
+    // 遍历查找
+    for (let i = 0; i < uuids.length; i++) {
+        const uuid = uuids[i],
+            assetInfo = EditorAPI.assetInfoByUuid(uuid),
+            shortUrl = assetInfo.url.replace('db://', '');
+        // 查找引用
+        print('log', '🔍', `${translate('find-asset-refs')} ${shortUrl}`);
+        const refs = await Finder.findByUuid(uuid);
+        if (refs.length === 0) {
+            print('log', '📂', `${translate('no-refs')} ${shortUrl}`);
+            continue;
+        }
+        // 打印结果
+        Printer.printResult({
+            type: assetInfo.type,
+            uuid: uuid,
+            url: assetInfo.url,
+            path: assetInfo.path,
+            refs: refs,
+        });
+    }
+}
+
+function getSelection() {
+
+}
+
+/**
+ * 资源变化回调
+ * @param {{ type: string, uuid: string }} info 
+ */
+function onAssetChanged(info) {
+    const { type, uuid } = info;
+    // 场景和预制体
+    if (type === 'scene' || type === 'prefab') {
+        const { url, path } = EditorAPI.assetInfoByUuid(uuid);
+        // 排除内置资源
+        if (url.indexOf('db://internal') !== -1) {
+            return;
+        }
+        // 更新节点树
+        Parser.updateCache(path);
+    }
+}
+
+module.exports = {
+
+    /**
+     * 扩展消息
+     */
+    messages: {
+
+        /**
+         * 查找当前选中资源
+         * @param {*} event 
+         */
+        'find-current-selection'(event) {
+            findCurrentSelection();
+        },
+
+        /**
+         * 打开设置面板
+         * @param {*} event 
+         */
+        'open-settings-panel'(event) {
+            PanelManager.openSettingsPanel();
+        },
+
+        /**
+         * 检查更新
+         * @param {*} event 
+         */
+        'menu-check-update'(event) {
+            checkUpdate(true);
+        },
+
+        /**
+         * 版本
+         * @param {*} event 
+         */
+        'menu-version'(event) {
+            openRepository();
+        },
+
+        /**
+         * 场景面板加载完成后
+         * @param {*} event 
+         */
+        'scene:ready'(event) {
+            // 自动检查更新
+            const config = ConfigManager.get();
+            if (config.autoCheckUpdate) {
+                checkUpdate(false);
+            }
+        },
+
+        /**
+         * 资源变化
+         * @param {*} event 
+         * @param {{ type: string, uuid: string }} info 
+         */
+        'asset-db:asset-changed'(event, info) {
+            onAssetChanged(info);
+        },
+
+    },
+
+    load,
+
+    unload,
+
+};

package//345/274/225/347/224/250/346/237/245/346/211/276/345/231/250/src/main/object-util.js

@@ -0,0 +1,70 @@
+/**
+ * 对象工具
+ * @author 陈皮皮 (ifaswind)
+ * @version 20210929
+ */
+const ObjectUtil = {
+
+    /**
+     * 判断指定值是否是一个对象
+     * @param {any} arg 参数
+     */
+    isObject(arg) {
+        return Object.prototype.toString.call(arg) === '[object Object]';
+    },
+
+    /**
+     * 对象中是否包含指定的属性
+     * @param {object} object 对象
+     * @param {string} name 属性名
+     */
+    containsProperty(object, name) {
+        let result = false;
+        const search = (_object) => {
+            if (ObjectUtil.isObject(_object)) {
+                for (const key in _object) {
+                    if (key == name) {
+                        result = true;
+                        return;
+                    }
+                    search(_object[key]);
+                }
+            } else if (Array.isArray(_object)) {
+                for (let i = 0, l = _object.length; i < l; i++) {
+                    search(_object[i]);
+                }
+            }
+        }
+        search(object);
+        return result;
+    },
+
+    /**
+     * 对象中是否包含指定的值
+     * @param {object} object 对象
+     * @param {any} value 值
+     */
+    containsValue(object, value) {
+        let result = false;
+        const search = (_object) => {
+            if (ObjectUtil.isObject(_object)) {
+                for (const key in _object) {
+                    if (_object[key] === value) {
+                        result = true;
+                        return;
+                    }
+                    search(_object[key]);
+                }
+            } else if (Array.isArray(_object)) {
+                for (let i = 0, l = _object.length; i < l; i++) {
+                    search(_object[i]);
+                }
+            }
+        }
+        search(object);
+        return result;
+    },
+
+};
+
+module.exports = ObjectUtil;

package//345/274/225/347/224/250/346/237/245/346/211/276/345/231/250/src/main/panel-manager.js

@@ -0,0 +1,86 @@
+const { BrowserWindow } = require('electron');
+const { join } = require('path');
+const { language, translate } = require('../eazax/editor-main-util');
+const { calcWindowPosition } = require('../eazax/window-util');
+
+/** 扩展名称 */
+const EXTENSION_NAME = translate('name');
+
+/**
+ * 面板管理器 (主进程)
+ */
+const PanelManager = {
+
+    /**
+     * 面板实例
+     * @type {BrowserWindow}
+     */
+    settings: null,
+
+    /**
+     * 打开设置面板
+     */
+    openSettingsPanel() {
+        // 已打开则直接展示
+        if (PanelManager.settings) {
+            PanelManager.settings.show();
+            return;
+        }
+        // 窗口尺寸和位置
+        const winSize = [500, 346],
+            winPos = calcWindowPosition(winSize, 'center');
+        // 创建窗口
+        const win = PanelManager.settings = new BrowserWindow({
+            width: winSize[0],
+            height: winSize[1],
+            minWidth: winSize[0],
+            minHeight: winSize[1],
+            x: winPos[0],
+            y: winPos[1] - 100,
+            useContentSize: true,
+            frame: true,
+            title: `${EXTENSION_NAME} | Cocos Creator`,
+            autoHideMenuBar: true,
+            resizable: true,
+            minimizable: false,
+            maximizable: false,
+            fullscreenable: false,
+            skipTaskbar: false,
+            alwaysOnTop: true,
+            hasShadow: true,
+            show: false,
+            webPreferences: {
+                nodeIntegration: true,
+                contextIsolation: false,
+            },
+        });
+        // 就绪后（展示，避免闪烁）
+        win.on('ready-to-show', () => win.show());
+        // 关闭后
+        win.on('closed', () => (PanelManager.settings = null));
+        // 监听按键
+        win.webContents.on('before-input-event', (event, input) => {
+            if (input.key === 'Escape') PanelManager.closeSettingsPanel();
+        });
+        // 调试用的 devtools
+        // win.webContents.openDevTools({ mode: 'detach' });
+        // 加载页面
+        const path = join(__dirname, '../renderer/settings/index.html');
+        win.loadURL(`file://${path}?lang=${language}`);
+    },
+
+    /**
+     * 关闭面板
+     */
+    closeSettingsPanel() {
+        if (!PanelManager.settings) {
+            return;
+        }
+        PanelManager.settings.hide();
+        PanelManager.settings.close();
+        PanelManager.settings = null;
+    },
+
+};
+
+module.exports = PanelManager;