# pyqt5_win_app

**Repository Path**: ChenGp/pyqt5_win_app

## Basic Information

- **Project Name**: pyqt5_win_app
- **Description**: PyQt5桌面应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyQt5桌面应用

一个使用PyQt5开发的跨平台桌面应用程序示例，包含完整的开发和打包流程。

## 功能特点

- 现代化UI界面设计
- 多标签页布局（表单示例、控件展示、文件操作）
- 自动检测版本更新功能
- 支持直接下载并安装更新
- 跨平台支持（Windows、macOS）

## 项目结构

```
├── app.py              # 主应用程序文件
├── main.py             # 简化版应用程序示例
├── version.py          # 统一版本信息配置
├── requirements.txt    # 项目依赖
├── setup.py            # py2app打包配置
├── build_windows.py    # Windows打包脚本
├── build_macos.py      # macOS打包脚本
├── build_fbs.py        # fbs跨平台打包脚本
├── start.sh            # 环境初始化脚本
└── icons/              # 应用图标目录
```

## 环境要求

- Python 3.6+
- PyQt5 5.15.0+
- 打包工具依赖（PyInstaller、py2app或fbs）

## 安装依赖

```bash
# 安装基本依赖
pip install -r requirements.txt
```

## 运行应用

```bash
# 运行完整版应用
python app.py

# 运行简化版应用
python main.py
```

## 打包应用

### Windows打包

```bash
python build_windows.py
```

### macOS打包

```bash
python build_macos.py
```

### 使用fbs跨平台打包

```bash
python build_fbs.py
```

## 版本更新

项目使用统一的版本信息管理，所有版本相关信息都在`version.py`文件中定义：

```python
# 修改版本号
APP_VERSION = "1.0.0"
BUILD_NUMBER = "001"
```

## 自动更新功能

应用程序包含自动检测版本更新功能：

1. 应用启动时自动检查更新
2. 用户可以通过点击"检查更新"按钮手动检查
3. 发现新版本时，可以直接下载并安装

## 贡献指南

欢迎提交问题和改进建议！

## 许可证

[MIT](LICENSE)