# pythub-builder **Repository Path**: pythub/pythub-builder ## Basic Information - **Project Name**: pythub-builder - **Description**: PyInstaller 图形化打包工具 - **Primary Language**: Python - **License**: BSD-3-Clause - **Default Branch**: main - **Homepage**: https://pythub.org/pythub-builder/ - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 2 - **Created**: 2020-04-06 - **Last Updated**: 2025-05-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Pythub Builder - PyInstaller 图形化打包工具 ![GUI界面示意图](resources/screenshots/1.png) ## 项目概述 一款基于 Tkinter 开发的图形化工具,用于简化 PyInstaller 打包 Python 脚本的操作。通过可视化界面配置打包参数,自动生成可执行文件,支持 Windows/Linux/macOS 多平台。 ## 功能特性 - **核心功能** - 📦 一键打包 Python 脚本为独立可执行文件 - 🖼️ 支持自定义程序图标(.ico/.icns) - 📄 添加版本信息文件(.rc) - 📁 灵活设置工作目录和输出路径 - **配置选项** - ✔️ 生成独立文件(--onefile)或文件夹包(--onedir) - ✔️ 关闭控制台窗口(--noconsole) - ✔️ UPX 压缩(--upx) - ✔️ 构建前清理临时文件(--clean) - ✔️ 自定义 EXE 文件名(--name) - **辅助功能** - 📜 实时日志输出显示 - 🚦 状态栏进度反馈 - 🔄 表单重置与日志清理 - 🛑 安全退出机制 ## 使用说明 ### 快速开始 ```bash 克隆仓库 git clone https://github.com/Crogram-Pythub/pythub-builder.git 安装依赖 pip install pyinstaller tkinter 启动应用 python src/app.py ``` ### 操作指南 1. **选择主程序** 点击 "选择文件" 按钮指定要打包的 `.py` 文件 2. **配置路径** - 工作目录:临时构建文件存放路径(默认:`项目路径/build`) - 输出目录:最终 EXE 文件生成路径(默认:`项目路径/dist`) 3. **高级设置** - 勾选 "UPX 压缩" 减小文件体积(需提前安装 UPX) - 指定版本信息文件添加版权信息 4. **执行打包** 点击 "构建生成" 按钮启动打包流程,实时日志将显示构建进度 ## 配置参数对照表 | 界面选项 | PyInstaller 参数 | 说明 | | ------------ | ---------------- | ------------------------------ | | 独立执行文件 | `--onefile` | 生成单个可执行文件 | | 文件夹包含 | `--onedir` | 生成包含依赖的文件夹 | | 关闭控制台 | `--noconsole` | 隐藏命令行窗口(GUI 程序必备) | | UPX 压缩 | `--upx` | 使用 UPX 压缩可执行文件 | | 构建前清理 | `--clean` | 清除缓存文件 | ## 依赖项 - Python 3.7+ - 必需库: ```requirements.txt PyInstaller==5.4.1 tkinter==0.1.0 ``` ## 代码结构 ``` pythub-builder/src ├── src/app.py # 主程序入口文件 ├── src/view.py # 主程序界面和逻辑 ├── src/utils.py # 工具函数(窗口控制/路径检测/退出确认) ├── resources # 资源文件(图标/截图) ├── build.sh # 项目打包脚本 └── README.md # 项目文档 ``` ## 常见问题 **Q:打包时报错 "PyInstaller 未找到"** ✅ 解决方案: ```bash pip install --upgrade pyinstaller ``` **Q:如何添加自定义图标?** ✅ 操作步骤: 1. 准备 256x256 像素的 `.ico` (Windows) 或 `.icns` (macOS) 文件 2. 通过 "选择图标" 按钮加载图标文件 **Q:版本信息文件格式要求** 🔍 参考:[微软版本资源文件规范](https://docs.microsoft.com/en-us/windows/win32/menurc/versioninfo-resource)([VERSIONINFO resource](https://learn.microsoft.com/zh-cn/windows/win32/menurc/versioninfo-resource)) ## 问题反馈 Please file an issue at [Issues](https://github.com/Crogram-Pythub/pythub-builder/issues). ## 许可证 Pythub Builder is released under the [BSD 3-Clause License](LICENSE) ## 作者 [Jackson Dou](https://github.com/jksdou) ## 版权 © 2025 [Crogram](https://crogram.org/) ## 其他 网站:[pythub.org](https://pythub.org/)