简单的使用前端语言即可快速开发桌面程序，程序体积小于 1M。

为什么

想开发一个简单的桌面程序，只使用前端语言开发，暂只考虑在 windows 上运行，希望开发体验像在浏览器中一样，然后程序的样子像是本地应用一样，调用本地文件、系统命令、后台运行、托盘菜单这些都没有问题。

调研了一些常见的方案，发现他们都不适合，所以就开发了此项目 。

如何使用

方式一：直接开发

这个方式适用于体验，无需任何开发环境。

• 第一步：下载 main 文件打开；
• 第二步：当前目录生成了名为 page.html 的文件，你可以在这个文件里写界面或调用系统 API 。

方式二：单独引用

• 安装: npm i sys-shim
• 导入:
  • esm 方式 import Sys from 'sys-shim'
  • cjs 方式 const Sys = require('sys-shim')
  • umd 方式 <script src="./node_modules/sys-shim/browser/main.umd.min.js"></script>
• 使用:

new Sys('ws://127.0.0.1:10005?token=tokentokentoken').then(main => {
  main.native.win.msgbox(`hello`, `title`)
})

方式三：使用脚手架模板开发

• 命令行
• 服务
• 界面

贡献

如果你想参与这个项目的开发。

node v18.19.0

rem 安装依赖
pnpm i

rem 生成库文件 sys.js
pnpm gen.res

rem 获取 main.exe, 可以通过编译或下载得到
pnpm main:build

rem 启动项目
pnpm dev

rem 发布 npm
pnpm gen.npm.push

todo

• [ ] fix: 当端口变更后，localstorage 等信息可能丢失
  • https://github.com/tauri-apps/tauri/issues/896
  • https://github.com/tauri-apps/tauri/commit/0d63732b962e71b98430f8d7b34ea5b59a2e8bb4?diff=split&w=0
  • https://github.com/tauri-apps/tauri/blob/9f75d06228fcb7036cf7a4e215abc7bc8d1a0a56/tooling/api/src/webview.ts#L613
  • https://github.com/maemon4095/tauri-custom-protocol
  • https://github.com/tauri-apps/tauri/issues/6330
  • https://docs.rs/tauri/latest/tauri/struct.Builder.html#method.register_uri_scheme_protocol
  • https://github.com/tauri-apps/tauri/issues/323
  • https://github.com/tauri-apps/wry/pull/65/files#diff-72a48c45fe590fb0a06f7e3635f417381ea5199505b3e8f706a54ec39211d5e1R99
  • https://www.electronjs.org/docs/latest/api/protocol#protocolregisterschemesasprivilegedcustomschemes
  • https://github.com/MicrosoftEdge/WebView2Feedback/issues/73
• [ ] feat: buffer 自动转换
• [ ] fix: 应正确接收稀疏返回值
  • 例如： return {1, null, 3}
• [ ] feat: 流式传输数据
  • 例如： 实时向 native 保存下载的数据
• [ ] refactor: 整理代码
  • [ ] 统一文档和代码中 sys-shim 的全局名称为 Sys, 实例化名称为 shim
  • [ ] 移除代码中的全局名称引用, 登录 window.msg, window.sys 使用当前 this 实现获取引用
  • [ ] 替换 doc.md 的内容为文档站点地址
  • [ ] 移除 App.js 中的用例
• [ ] feat: 自动从终端输出中读取 url 入口
• [ ] doc: 更新文档
  • [ ] 安装
    • [ ] 通过 main
    • [ ] 通过 nodejs
  • [ ] 使用本地前端代码
  • [ ] 使用线上 url 链接
  • [ ] 集成到正在开发的前端项目
  • [ ] 打包
  • [ ] 使用
    • [ ] 发布给用户
      • [ ] 报毒：因为软件的性质问题，会被误报，等到达 v1.0.0 版本之后，会向各安全平台提交核验申请，在此之前可以要求用户关闭杀毒软件或配置白名单，或自己向安全平台提审。