Files
leonapp/pyqt5fluentdesign/README.md

128 lines
3.7 KiB
Markdown
Raw Normal View History

2025-09-20 22:20:08 +08:00
# LeonApp GUI
基于PyQt5和Fluent Design的App Store API图形界面工具提供美观、易用的交互方式来访问和管理App Store的各种API功能。
## 功能特性
- **现代化界面**采用Fluent Design风格提供优雅、直观的用户界面
- **应用管理**:查看所有应用列表、获取应用详细信息、搜索应用
- **标签管理**:查看所有标签、获取标签下的应用列表
- **开发者管理**:查看开发者的应用列表、获取开发者详细信息
- **公告管理**:查看所有公告信息
- **统计信息**:获取应用商店的统计数据(应用总数、开发者总数等)
- **异步操作**使用多线程进行API请求避免界面卡顿
- **分页支持**:支持列表数据的分页浏览
- **错误处理**:友好的错误提示和信息反馈
- **响应式设计**:适配不同屏幕尺寸
## 环境要求
- Python 3.6 或更高版本
- PyQt5 及其依赖库
## 安装指南
1. 确保你已安装Python 3.6或更高版本
2. 克隆或下载此项目到本地
3. 安装依赖包:
```bash
cd pyqt5fluentdesign
pip install -r requirements.txt
```
4. 运行应用程序:
```bash
python leonapp_gui.py
```
## 使用方法
### 主界面
应用启动后,你会看到一个包含多个标签页的主界面,每个标签页对应不同的功能模块:
- **应用管理**:查看、搜索和浏览应用列表
- **标签管理**:查看所有标签和标签下的应用
- **开发者管理**:查看开发者的应用和信息
- **公告管理**:查看所有公告
- **统计信息**:查看应用商店的统计数据
### 应用管理
在"应用管理"标签页中:
1. 应用列表默认显示所有应用每页显示20个
2. 你可以在搜索框中输入关键词搜索应用
3. 可以通过下拉框调整每页显示的应用数量
4. 双击表格中的任意应用,可以查看应用的详细信息
5. 使用"上一页"和"下一页"按钮浏览更多应用
### 应用详情
应用详情窗口显示了应用的完整信息,包括:
- 应用名称、版本、年龄分级
- 应用描述
- 应用评分和下载量
- 应用标签
- 版本历史
- 图片数量
### 标签管理
在"标签管理"标签页中:
1. 标签列表显示了所有可用的标签
2. 双击表格中的任意标签,可以查看该标签下的所有应用
### 开发者管理
在"开发者管理"标签页中:
1. 输入开发者ID
2. 点击"查看应用列表"按钮,可以查看该开发者创建的所有应用
3. 点击"查看开发者信息"按钮,可以查看该开发者的详细信息
### 公告管理
在"公告管理"标签页中:
1. 公告列表显示了所有公告
2. 使用"上一页"和"下一页"按钮浏览更多公告
3. 双击表格中的任意公告,可以查看公告详情
### 统计信息
在"统计信息"标签页中:
1. 显示了应用商店的关键统计数据
2. 点击"刷新统计数据"按钮,可以更新统计信息
## 配置
目前API基础URL是硬编码在`leonapp_gui.py`文件中的:`http://leonmmcoset.jjxmm.win:8010/api.php`。如果你的API地址不同你需要修改文件中的`api_base_url`变量。
## 注意事项
1. 确保API服务器正在运行并且可以从你的计算机访问
2. 如果遇到连接问题,请检查网络连接和防火墙设置
3. 程序使用了多线程处理API请求确保你的系统支持多线程操作
4. 对于大数据量的操作,可能需要一些时间来完成数据加载
## 许可证
[MIT License](LICENSE)
## 作者
LeonApp GUI Team
## 更新日志
### v1.0.0
- 初始版本,支持所有基本功能
- 提供现代化的Fluent Design界面
- 支持异步操作和分页浏览
- 完善的错误处理和用户反馈