# health-python-qml

**Repository Path**: lshhome001/health-python-qml

## Basic Information

- **Project Name**: health-python-qml
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt/QML 控件测试程序

基于 Python + PyQt5 + QML 开发的测试程序，兼容银河麒麟 v10 系统（Qt 5.12.12）。

## 功能特性

### 1. 控件测试
- **输入框测试**
  - 普通输入框（带实时反馈）
  - 密码输入框（隐藏输入）
  - 数字输入框（带验证器）
  
- **按钮测试**
  - 普通按钮
  - 禁用按钮
  - 复选框
  - 单选按钮
  
- **滑块和进度条**
  - 滑块控件（0-100）
  - 进度条（与滑块联动）
  
- **下拉菜单**
  - ComboBox 选择控件
  
- **文本显示**
  - 多种文本样式（普通、粗体、斜体、下划线、彩色）

### 2. 数据库操作
- **数据录入**
  - 添加新记录
  - 支持名称、值、描述字段
  
- **数据查询**
  - 显示所有记录
  - 按名称搜索
  
- **数据操作**
  - 编辑记录
  - 删除记录
  - 刷新列表

## 环境要求

### Windows 环境
- Python 3.6+
- PyQt5 >= 5.12.0
- PyQt5-sip >= 12.8.0

### 银河麒麟 v10 环境
- Python 3.6+
- PyQt5 >= 5.12.0（系统自带）
- Qt 5.12.12

## 安装步骤

### Windows 安装
1. 安装 Python 3.6 或更高版本
2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

### 银河麒麟安装
1. 系统通常已预装 Python 3 和 PyQt5
2. 如需手动安装：
   ```bash
   sudo apt update
   sudo apt install python3-pyqt5 python3-pyqt5.qtsql
   ```

## 运行方法

### Windows
```bash
python main.py
```

### 银河麒麟
```bash
python3 main.py
```

## 项目结构

```
testproject/
├── main.py              # Python 主程序
├── main.qml             # QML 界面文件
├── requirements.txt     # Python 依赖
├── README.md           # 说明文档
└── test.db             # SQLite 数据库（运行时生成）
```

## 技术说明

### Python 端
- 使用 PyQt5 创建应用程序
- 通过 QQmlApplicationEngine 加载 QML
- 使用 pyqtSignal 和 pyqtSlot 实现 Python 与 QML 的交互
- 使用 PyQt5.QtSql 模块操作 SQLite 数据库

### QML 端
- 使用 QtQuick 2.12
- 使用 QtQuick.Controls 2.12
- 使用 TabBar 和 StackLayout 实现选项卡界面
- 使用 TableView 显示表格数据
- 使用 ListModel 存储数据

### 数据库
- 使用 SQLite 轻量级数据库
- 表结构：
  - id: 主键
  - name: 名称
  - value: 值
  - description: 描述
  - created_time: 创建时间

## 兼容性说明

本程序专门针对银河麒麟 v10 系统的 Qt 5.12.12 版本进行优化：
- 所有 QML 导入版本均为 2.12
- 避免使用 Qt 5.12 之后的新特性
- 使用兼容的 API 和语法
- 在 Windows Qt 5.15.2 环境下也可正常运行

## 常见问题

### 1. 无法启动
- 检查 Python 版本是否>=3.6
- 确保 PyQt5 已正确安装
- 检查 Qt 版本兼容性

### 2. 数据库错误
- 确保有写入权限（用于创建 test.db）
- 检查 SQLite 驱动是否可用

### 3. QML 加载失败
- 检查 main.qml 文件是否存在
- 查看 Qt 版本是否兼容
- 检查 QML 语法是否正确

## 开发说明

### 添加新的 Python 接口
1. 在 TestInterface 类中添加新的 pyqtSlot 方法
2. 使用@pyqtSlot 装饰器
3. 在 QML 中通过 testInterface 调用

### 添加新的 QML 控件
1. 在 main.qml 中添加相应的 QML 元素
2. 确保导入版本兼容 Qt 5.12
3. 测试在银河麒麟上的运行情况

### 数据库扩展
1. 修改 DatabaseManager 类
2. 添加新的查询方法
3. 在 QML 中调用新方法

## 许可证

本程序仅供学习和测试使用。