代码习惯无复杂继承和类。

ApacheV2 License。

Ginthon 基于 pywebview、flask 等。无 PyQT。ApacheV2 License。

GUI 前端默认 Svelte5,运行于 Webview2、Webkit、WebKitGTK 中。

打包安装包体积在 55MB 左右,RAM 占用 170MB 左右。

全静态,可挂载其它语言程序编写的二进制子程序。

提醒:

Python版基座请戳:https://github.com/fyonecon/Ginthon (Open Code,ApacheV2 协议开源)。

Golang版基座请戳:https://github.com/fyonecon/Waigo (Closed Enterprise,商业闭源)。

Go和Py的基座代码都是“功能对齐+UI复用”的。

Go和Py都是以“尽量‘返回默认值’代替‘抛出Error’”+“尽量复用函数”+“尽量不使用继承”+“减少不必要的外部import”为原则。

拉取仓库:

窗口及服务·主程序(Ginthon-Main):

git clone -b main https://github.com/fyonecon/Ginthon.git Ginthon-Main

然后将“GinthonDemo”关键词全局替换成你的项目名称即可成为你的应用名。

开发环境运行项目:

#在dev环境默认展开console,build环境默认无console。

python dev.py

打包成桌面安装包(.app、.exe、.deb等):

#底层使用 pyinstaller 打包。仅打包当前"CPU类型+操作系统类型"的安装包。

python build.py

项目结构:

Py命名原则:
  • 系统集文件夹名或文件名:小写+下划线
  • 自定义文件夹名:小驼峰
  • 自定义函数:小驼峰
  • 自定义变量:小驼峰
  • 自定义接口名:小写+下划线
Frontend命名原则:
  • 函数及变量:小写+下划线
  • 引号:双引号 使用优先于 单引号
Ginthon-Main
├── build 打包运行时目录(自动生成)
├── dist 程序打包文件目录(自动生成。这里存放你打包后的app安装包)
├── docs 其它文档
│   └── README-Docs.md 项目原理说明
├── flaskassets 软件内部的额外引用文件
│       ├── files 其它可网络访问的文件
│       └── html 额外的可暴露在外的web静态文件(单页应用)
├── frontend 前端或静态文件
│   ├── tray (状态托盘二进制文件,自动创建)
│   └── view 前端视图(默认SvelteKit)
│       ├── src 视图发开发文件
│       │   └── common 公共函数
│       │   └── pages 页面具体实现
│       │   └── parts 公用Svelte组件
│       │   └── stores 绑定数据管理
│       │   └── services 内置服务
│       │   └── routes 路由、layout、公共参数验证
│       ├── config.js 配置文件
│       ├── readme.md 🔥前端操作记录与教程
│       └── static 静态文件
│   ├── appicon.png 应用Dock拦的icon
│   ├── favicon.ico 网页默认icon
│   ├── appicon.ico 网页默认icon
│   ├── appicon.icns Mac应用图标
├── internal 后段时间或py核心代码
│   ├── app 自定义的App功能
│   │   ├── flask Web控制器目录
│   │   ├── tray 状态栏托盘
│   │   └── window 窗口服务目录
│   │       ├── controller
│   │       │   ├── do_events.py 操作窗口事件
│   │       │   ├── js_call_py.py js调用py对照表
│   │       │   ├── on_events.py 窗口运行事件
│   │       │   ├── py_run_js.py py调用js对照表
│   │       │   └── tray_events.py
│   │       ├── window_route.py 窗口必要页面相关路由
│   │       └── window_view.py 窗口页面html代码
│   ├── bootstrap 框架加载核心
│   │   ├── app_auth.py 认证与密钥相关
│   │   ├── init_sys.py 检查系统及硬件
│   │   ├── init_window.py 窗口服务
│   │   ├── run_check_sys.py
│   │   ├── run_flask.py Web服务
│   │   ├── run_tray.py 启动状态栏托盘
│   │   └── run_services.py 其它主页服务
│   ├── common 公共函数、封装的kit
│   │   ├── kits 公共函数的Kit
│   │   │   ├── _7z.py 7Z解压
│   │   │   ├── FILETYPE_DICT.py 各种文件对照表
│   │   │   ├── ICON.py 程序icon的二进制
│   │   │   ├── main_dirpath.py 虚拟路径
│   │   │   ├── secret_aes.py 对称加密
│   │   │   ├── shell.py PY运行shell
│   │   │   ├── time_interval.py 定时器
│   │   │   ├── txt_data.py 简单的文件型数据库
│   │   │   ├── watch_pid.py
│   │   │   └── watch_processes.py
│   │   ├── func.py 公共函数
│   │   ├── request_data.go 公用处理Flask Input请求参数函数
│   │   └── translate.py 多语言翻译对照表
│   └── config.py 系统配置信息
│   ├── routes 自定义的路由
│   │   └── ...py 
│   ├── services 服务
│   │   ├── flask_middleware.py Web检测中间件
│   │   └── services_for_time_interval.py 定时器
├── LICENSE
├── README.md 项目说明
├── requirements-win.txt Win下的依赖
├── requirements.txt 默认依赖
├── build.json 打包程序的配置文件
├── build.py 打包程序一键运行
├── dev.json 开发环境运行的配置文件
├── dev.py 开发环境一键运行
├── ginthon_tray.py 状态栏托盘入口
├── ginthon_tray.spec PYinstaller的SPEC打包文件参数
├── ginthon_window.py 视窗主程序入口
└── ginthon_window.spec PYinstaller的SPEC打包文件参数

其它原理请戳 ./docs/README-Docs.md 文档。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐