fm453/hi-sass-frame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
hi-sass-frame/CHANGELOG.md
fm453 e91ff65c22 基础框架完成
2024-09-08 23:46:15 +08:00

7.4 KiB
Raw Blame History

2024.09.07

  • 新增已知问题：
    • preload预加载，不能直接传导出process，会导致程序假死、主界面无显；
    • 渲染进程中，要使用通过预加载传导的变量，最好还是用window.*的方式

2024.09.06

  • 修复增加了系统托盘按钮功能，主要涉及的文件
  • src/renderer/public/tray.html (这个是用于定制化的托盘，我因为没有精力搞，简化了，所以直接无视了它)
  • src/main/中，添加了trayHook、修改了trayManager

2024.09.05

  • 关于新增自定义主题，需要调用nodejs模块的API时，不应直接调用（在electron中会失效），而是参考 src/utils/ipcRender的进程通信方式。大部分情况下，这是不需要的，因为我已经写好了很多来适配。在* /views/demo中可以找到主|子进程之间通信的示例。
  • 需要新增主|子 进程间通信的，已知要进行以下操作：
    • 强烈建议任何文件修改前，请在其所在目录直接完整复制保存一份！！！
    • 任何时候，不要破坏这几个文件的结构，只按照以下说明添加具体功能即可！！！
      • src/ipc.ts中，添加类型声明，在enum(枚举)channel中，参照添加即可。
      • src/main/services/ipcMain.ts中，添加需要增加的通信功能。

2024.09.04

  • 修复了几个开发依赖，至此，要求必须使用yarn为包管理工具
  • 修复了preload.js调用，修复主进程与渲染进程的通信；尝试将主进程脚本与渲染进程脚本完全分离
    • 主要涉及文件：
      • src/main/config/ => staticPath.ts、windowsConfig.ts
      • src/main/services => windowManager.ts
  • 修改了dev-runner.ts脚本中的欢迎函数，自定义了chalk脚本的欢迎词“hi-sass”
  • 修复热更新脚本语法错误：
    • npm i --save-dev @types/adm-zip, 使adm-zip插件支持ts
    • const zip = new AdmZip()
  • 修复改进了主进程中的部分循环引用，减少不必要的错误。具体文件归类尚待最终确认。

2024.09.01

  • 修复express来模拟mock服务的参数路由问题；路由中带参数时，body是函数，不能直接输出结果，需要执行该函数。具体代码在@main/server/server.ts中。
  • 添加热键支持，修复全局复制、粘贴等按钮的响应。具体代码在@main/config/hotkeys.ts中。
  • 重整文件夹，相应调整对应的设置；注意： 文件夹位置如有移动，需要相应地调整引用
    • 在vite.config.mts及ts.config中均配置了文件路径别名，方便后期开发使用；文件夹移动也方便一些；
    • 别名路径文件夹移动后，要注意重新配置上述两个文件
    • mock文件夹不可以放置在根目录，即使配置了别名，也可能会有各种乱七八糟的报错
    • 非特殊情况，都建议将运行代码放置在根目录别名@下（也就是src/renderer/)
    • 如果对框架没有修改的需求，只需要修改前端，就无须修改src/renderer/目录以外的文件。

2024.08.28

  • 添加univerJs组件，由于使用yarn方式无法自动为它安装peerDependencies依赖，所以需要额外手动补充添加；

    • 另外，已知还需要依赖外部库：
      • react
      • @wendellhu/redi
      • clsx
      • rxjs
      • dayjs
      • @grpc/grpc-js

  • 使用express-ws做wss服务器模拟，依赖于express，ts中还需要安装@types/express-ws

2024.08.27

  • 去掉mock尝试及相关依赖，改为使用express做服务器进行模拟（配置容易、编写简洁，简直不要太方便），ts需要安装 @types/express

2024.08.25

  • TBD:修复模拟浏览器，升级相应语法到最新；
    • 浏览器函数文件在src/main/services/browserHandle.ts中
    • 里面默认的url地址，是在src/main/config/const.ts中配置

2024.08.21

  • 修复依赖，更新到最新包

  • 添加express依赖，制作内置服务器使用

  • 添加element-plus作为前端默认UI组件，相应地，有以下编译前变量定义

    • 默认主题：@theme ，在 .electron-vite/vite-config.mts 文件；
    • 组件库形成的主题文件，应该有一套完整的、可独立访问的前端路径；
    • 主题目录： src/renderer/themes/ 下；默认 default
    • 非必要不建议对themes进行任何更改。
    • 如果使用其他组件，可在主题目录下新建一个目录，并将一应文件存入。具体可参考themes里的default目录
    • 如果需要完善补充默认主题，建议复制default目录全部内容后再改。
    • 启用新的主题，需要修改 @theme 的路径定义。
    • 主题内，建议使用相对路径进行各内容的引用。

  • 其他补充：

    • 添加mock，做本地调试
    • 尝试：修改了src下的request.ts中的baseURL，（有可能还需要改回来）

2024.08.20

  • 修复依赖 minimist
    • 检查是否存在: npm i --save-dev @types/minimist
    • 安装: yarn add @types/minimist
  • 修复依赖 semver
    • 检查是否存在: npm i --save-dev @types/semver
    • 安装: yarn add @types/semver
  • 修改主应用菜单
    • 文件目录： src/main/hooks/menu-hooks.ts
    • 暂时去掉了“关于”菜单中的多余按钮（对话框相应的事件没写好，暂时去掉）
  • 项目定名：hi-sass-frame-front
    • 修改package.json
    • 修改build.json
  • 修复build脚本
    • 文件： .electron-vite/build.ts
    • web()或unionBuild()为异步方法，需要添加.then()来操作回调结果。
  • 修复语言包加载报错问题 ：vue: Property glob does not exist on type ImportMeta
    • 报错文件：src/i18n/index.ts
    • 问题：import.meta.glob函数报错
    • 原因：使用了ts类型的文件，需要处理相应的types类型
    • 解决：（1）修改tsconfig.json，types中添加“vite/client”;此时，大部分vite构建的项目都基本OK了； （2）添加glob.d.ts声明文件，放置在合适的位置；对于electron-vite配置，本项目指定了customTypes目录存放这些额外的声明文件，我又自定义了一个fixTypes目录来存放开发中需要补充的声明文件。文件内添加声明头注释： /// <reference types="vite/client" />
  • 修改启动界面提示文字
    • 文件： src/render/public/loader.html
    • 修改："资源加载中"
  • 添加release目录，用于存放打包好的APP
    • 目前以版本号为子目录
    • 替换程序的默认图标
      • mac 系统创建icns图标需要用到命令行.
        • 第一步：选定png图标文件（高清，1024*1028分辨率以上）；
        • 第二步：在当前目录下创建文件夹 pngpic.iconset;
        • 第三步：命令sips生成图标文件（7组共14张），全部存放在pngpic.iconset目录下；
        • 第四步：命令iconutil生成icns文件
      • 命令参考 
        sips -z 16 16 hi.png --out icon_16x16.png
sips -z 32 32 hi.png --out icon_16x16@2x.png
sips -z 32 32 hi.png --out icon_32x32.png
sips -z 64 64 hi.png --out icon_32x32@2x.png
sips -z 64 64 hi.png --out icon_64x64.png
sips -z 128 128 hi.png --out icon_64x64@2x.png
sips -z 128 128 hi.png --out icon_128x128.png
sips -z 256 256 hi.png --out icon_128x128@2x.png
sips -z 256 256 hi.png --out icon_256x256.png
sips -z 512 512 hi.png --out icon_256x256@2x.png
sips -z 512 512 hi.png --out icon_512x512.png
sips -z 1024 1024 hi.png --out icon_512x512@2x.png
sips -z 1024 1024 hi.png --out icon_1024x1024.png
sips -z 2048 2048 hi.png --out icon_1024x1024@2x.png

        iconutil -c icns pngpic.iconset -o icon.icns

2024.08.19

  • 项目创建。
  • 项目基础构成：
    • electron@31.4.0
    • vue@3.4.21
    • element-plus@2.7.5
    • vite@5.2.7