@ives_xxz/packages 1.0.0

package/Quick Finder/src/main/finder.js

@@ -0,0 +1,101 @@
+const Path = require('path');
+const { map } = require('../eazax/file-util');
+
+/**
+ * 查找器
+ */
+const Finder = {
+
+    /**
+     * 数据缓存
+     * @type {{ name: string, path: string, extname: string }[]}
+     */
+    caches: null,
+
+    /**
+     * 清除缓存
+     */
+    clearCaches() {
+        Finder.caches = null;
+    },
+
+    /**
+     * 收集项目中的文件信息
+     */
+    async collectFiles() {
+        const caches = Finder.caches = [];
+        // 文件处理函数
+        const handler = (path, stat) => {
+            // 过滤
+            if (Finder.filter(path)) {
+                const name = Path.basename(path),
+                    extname = Path.extname(path);
+                caches.push({ name, path, extname });
+            }
+        }
+        // 遍历项目文件
+        const assetsPath = Path.join(Editor.Project.path, 'assets');
+        await map(assetsPath, handler);
+    },
+
+    /**
+     * 过滤文件
+     * @param {string} path 路径
+     * @returns {boolean}
+     */
+    filter(path) {
+        // 扩展名
+        const extname = Path.extname(path);
+        // 排除 meta 文件和没有扩展名的文件
+        if (extname === '.meta' || extname === '') {
+            return false;
+        }
+        // 可用
+        return true;
+    },
+
+    /**
+     * 获取项目中匹配关键词的文件
+     * @param {string} keyword 关键词
+     * @returns {{ name: string, path: string, extname: string, similarity: number }[]}
+     */
+    getMatchedFiles(keyword) {
+        // 处理正则公式符号
+        const components = keyword.split('');
+        for (let i = 0, l = components.length; i < l; i++) {
+            if (/[*.?+$^()\[\]{}|\\\/]/.test(components[i])) {
+                components[i] = '\\' + components[i];
+            }
+        }
+        // 正则匹配
+        // - (.*)：每个关键字之间可以有任意个字符；
+        // - (?)：懒惰模式，匹配尽可能少的字符；
+        // - (i)：不区分大小写；
+        const pattern = components.join('.*?'),
+            regExp = new RegExp(pattern, 'i');
+        // 下面这行正则插入很炫酷，但是性能不好，耗时接近 split + join 的 10 倍
+        // const pattern = keyword.replace(/(?<=.)(.)/g, '.*$1');
+        // 查找并匹配
+        const caches = Finder.caches,
+            results = [];
+        if (caches) {
+            // 从缓存中查找
+            for (let i = 0, l = caches.length; i < l; i++) {
+                const { name, path, extname } = caches[i];
+                // 匹配
+                const match = name.match(regExp);
+                if (match) {
+                    // 相似度
+                    const similarity = match[0].length;
+                    results.push({ name, path, extname, similarity });
+                }
+            }
+            // 排序（similarity 越小，匹配的长度越短，匹配度越高）
+            results.sort((a, b) => a.similarity - b.similarity);
+        }
+        return results;
+    },
+
+};
+
+module.exports = Finder;

package/Quick Finder/src/main/index.js

@@ -0,0 +1,155 @@
+const MainEvent = require('../eazax/main-event');
+const EditorMainKit = require('../eazax/editor-main-kit');
+const { checkUpdate } = require('../eazax/editor-main-util');
+const { openRepository } = require('../eazax/package-util');
+const ConfigManager = require('../common/config-manager');
+const Finder = require('./finder');
+const Opener = require('./opener');
+const PanelManager = require('./panel-manager');
+
+/**
+ * 生命周期：加载
+ */
+function load() {
+    // 监听事件
+    EditorMainKit.register();
+    MainEvent.on('match', onMatchEvent);
+    MainEvent.on('open', onOpenEvent);
+    MainEvent.on('focus', onFocusEvent);
+}
+
+/**
+ * 生命周期：卸载
+ */
+function unload() {
+    // 关闭搜索栏
+    PanelManager.closeSearchBar();
+    // 取消事件监听
+    EditorMainKit.unregister();
+    MainEvent.removeAllListeners('match');
+    MainEvent.removeAllListeners('open');
+    MainEvent.removeAllListeners('focus');
+}
+
+/**
+ * （渲染进程）关键词匹配事件回调
+ * @param {Electron.IpcMainEvent} event 
+ * @param {string} keyword 关键词
+ */
+function onMatchEvent(event, keyword) {
+    // 匹配结果
+    const results = Finder.getMatchedFiles(keyword);
+    // 返回结果给渲染进程
+    if (event.reply) {
+        MainEvent.reply(event, 'match-reply', results);
+    } else {
+        // 兼容 Electron 4.x 及以下版本
+        MainEvent.send(event.sender, 'match-reply', results);
+    }
+}
+
+/**
+ * （渲染进程）打开文件事件回调
+ * @param {Electron.IpcMainEvent} event 
+ * @param {string} path 路径
+ */
+function onOpenEvent(event, path) {
+    // 打开文件
+    Opener.tryOpen(path);
+    // 关闭搜索栏
+    PanelManager.closeSearchBar();
+}
+
+/**
+ * （渲染进程）聚焦文件事件回调
+ * @param {Electron.IpcMainEvent} event 
+ * @param {string} path 路径
+ */
+function onFocusEvent(event, path) {
+    // 在资源管理器中显示并选中文件
+    const uuid = Opener.fspathToUuid(path);
+    Opener.focusOnFile(uuid);
+}
+
+/**
+ * 打开搜索栏
+ */
+function openSearchBar() {
+    const options = {
+        /** 打开前 */
+        onBeforeOpen: async () => {
+            // 收集项目中的文件信息
+            await Finder.collectFiles();
+            // 发消息通知渲染进程（搜索栏）
+            if (PanelManager.search) {
+                const webContents = PanelManager.search.webContents;
+                MainEvent.send(webContents, 'data-update');
+            }
+        },
+        /** 关闭后 */
+        onClosed: () => {
+            // 清除缓存
+            Finder.clearCaches();
+        },
+    };
+    PanelManager.openSearchBar(options);
+}
+
+module.exports = {
+
+    /**
+     * 扩展消息
+     */
+    messages: {
+
+        /**
+         * 打开搜索栏
+         * @param {*} event 
+         */
+        'open-search-bar'(event) {
+            openSearchBar();
+        },
+
+        /**
+         * 打开设置面板
+         * @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);
+            }
+        },
+
+    },
+
+    load,
+
+    unload,
+
+};

package/Quick Finder/src/main/opener.js

@@ -0,0 +1,95 @@
+const Path = require('path');
+const ConfigManager = require('../common/config-manager');
+
+/**
+ * 文件打开器
+ */
+const Opener = {
+
+    /**
+     * 尝试打开文件
+     * @param {string} path 路径
+     */
+    tryOpen(path) {
+        const extname = Path.extname(path),
+            uuid = Opener.fspathToUuid(path);
+        // 是否配置了快速打开
+        const { openable } = ConfigManager.cache;
+        if (openable.indexOf(extname) !== -1) {
+            Opener.open(extname, uuid);
+        }
+        // 聚焦到文件（不延迟的话打开预制体会报错）
+        setTimeout(() => Opener.focusOnFile(uuid));
+    },
+
+    /**
+     * 打开文件
+     * @param {string} extname 扩展名
+     * @param {string} uuid Uuid
+     */
+    open(extname, uuid) {
+        switch (extname) {
+            case '.fire': {
+                Opener.openScene(uuid);
+                break;
+            }
+            case '.prefab': {
+                Opener.openPrefab(uuid);
+                break;
+            }
+            case '.ts':
+            case '.js':
+            case '.json':
+            case '.txt':
+            case '.md': {
+                Opener.openText(uuid);
+                break;
+            }
+        }
+    },
+
+    /**
+     * 打开场景
+     * @param {string} uuid Uuid
+     */
+    openScene(uuid) {
+        Editor.Panel.open('scene', { uuid });
+    },
+
+    /**
+     * 打开预制体
+     * @param {string} uuid Uuid
+     */
+    openPrefab(uuid) {
+        Editor.Ipc.sendToAll('scene:enter-prefab-edit-mode', uuid);
+    },
+
+    /**
+     * 打开文本文件
+     * @param {string} uuid Uuid
+     */
+    openText(uuid) {
+        Editor.Ipc.sendToMain('assets:open-text-file', uuid);
+    },
+
+    /**
+     * 聚焦到文件（在资源管理器中显示并选中文件）
+     * @param {string} uuid Uuid
+     */
+    focusOnFile(uuid) {
+        Editor.Ipc.sendToAll('assets:hint', uuid);
+        Editor.Selection.select('asset', uuid);
+    },
+
+    /**
+     * 通过绝对路径获取 uuid
+     * @param {string} path 路径
+     * @returns {string}
+     */
+    fspathToUuid(path) {
+        return Editor.assetdb.fspathToUuid(path);
+    },
+
+};
+
+module.exports = Opener;

package/Quick Finder/src/main/panel-manager.js

@@ -0,0 +1,159 @@
+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}
+     */
+    search: null,
+
+    /**
+     * 打开搜索栏
+     * @param {{ onBeforeOpen: () => void, onClosed: () => void }} options 
+     */
+    openSearchBar(options) {
+        // 已打开则关闭
+        if (PanelManager.search) {
+            PanelManager.closeSearchBar();
+            return;
+        }
+        // 收集项目中的文件信息
+        options.onBeforeOpen();
+        // 窗口尺寸和位置（macOS 标题栏高 28px）
+        const winSize = [550, 550],
+            winPos = calcWindowPosition(winSize, 'top');
+        // 创建窗口
+        const win = PanelManager.search = new BrowserWindow({
+            width: winSize[0],
+            height: winSize[1],
+            x: winPos[0],
+            y: winPos[1] + 200,
+            frame: false,
+            resizable: false,
+            fullscreenable: false,
+            skipTaskbar: true,
+            alwaysOnTop: true,
+            transparent: true,
+            opacity: 0.95,
+            backgroundColor: '#00000000',
+            hasShadow: false,
+            show: false,
+            webPreferences: {
+                nodeIntegration: true,
+                contextIsolation: false,
+            },
+        });
+        // 就绪后展示（避免闪烁）
+        win.on('ready-to-show', () => win.show());
+        // 失焦后
+        win.on('blur', () => PanelManager.closeSearchBar());
+        // 关闭后
+        win.on('closed', () => {
+            PanelManager.search = null;
+            options.onClosed();
+        });
+        // 监听按键
+        win.webContents.on('before-input-event', (event, input) => {
+            if (input.key === 'Escape') PanelManager.closeSearchBar();
+        });
+        // 调试用的 devtools
+        // win.webContents.openDevTools({ mode: 'detach' });
+        // 加载页面
+        const path = join(__dirname, '../renderer/search/index.html');
+        win.loadURL(`file://${path}?lang=${language}`);
+    },
+
+    /**
+     * 关闭搜索栏
+     */
+    closeSearchBar() {
+        if (!PanelManager.search) {
+            return;
+        }
+        PanelManager.search.hide();
+        PanelManager.search.close();
+        PanelManager.search = null;
+    },
+
+    /**
+     * 面板实例
+     * @type {BrowserWindow}
+     */
+    settings: null,
+
+    /**
+     * 打开设置面板
+     */
+    openSettingsPanel() {
+        // 已打开则直接展示
+        if (PanelManager.settings) {
+            PanelManager.settings.show();
+            return;
+        }
+        // 窗口尺寸和位置（macOS 标题栏高 28px）
+        const winSize = [500, 450],
+            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,
+            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;