124 lines
2.5 KiB
Markdown
124 lines
2.5 KiB
Markdown
# Python 项目集成指南
|
||
|
||
本指南说明如何将 `F:/04.python/04.python/uf2touft3` 项目与 Qt 应用程序集成。
|
||
|
||
## 两个方案对比
|
||
|
||
### 方案一：增强的 QProcess 方案 (推荐用于生产环境)
|
||
|
||
**优点：**
|
||
- 简单稳定，不易出错
|
||
- 进程隔离，不会影响主应用程序
|
||
- Python 依赖问题独立解决
|
||
- 调试方便
|
||
|
||
**缺点：**
|
||
- 进程间通信开销
|
||
- 无法直接共享内存
|
||
|
||
**状态：已实现并集成 ✅**
|
||
|
||
### 方案二：pybind11 嵌入方案 (高级选项)
|
||
|
||
**优点：**
|
||
- 更紧密的集成
|
||
- 可以直接调用 Python 函数
|
||
- 更好的性能
|
||
|
||
**缺点：**
|
||
- 配置复杂
|
||
- 需要 C++ 编译环境
|
||
- 调试困难
|
||
- Python 全局解释器锁 (GIL) 问题
|
||
|
||
**状态：提供示例代码 ⚠️**
|
||
|
||
## 使用方案一 (推荐)
|
||
|
||
### 1. 确保 Python 环境可用
|
||
|
||
确保系统已安装 Python 3.8+，并且可以在命令行中运行：
|
||
```bash
|
||
python --version
|
||
```
|
||
|
||
### 2. 确保 Python 项目完整
|
||
|
||
确保 `F:/04.python/04.python/uf2touft3` 目录包含所有必要文件：
|
||
- `main.py`
|
||
- `processCombination.py`
|
||
- `config.ini`
|
||
- 其他依赖的模块和配置文件
|
||
|
||
### 3. 使用 Qt 应用程序
|
||
|
||
直接运行编译好的 `Uft30ChangeCode.exe`，点击"开始转换"按钮即可调用 Python 代码。
|
||
|
||
## 构建方案二 (高级)
|
||
|
||
如果你想使用 pybind11 方案，按以下步骤：
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
pip install pybind11
|
||
```
|
||
|
||
### 2. 创建构建目录
|
||
|
||
```bash
|
||
cd python_bindings/pybind11_binding
|
||
mkdir build
|
||
cd build
|
||
```
|
||
|
||
### 3. 配置 CMake
|
||
|
||
```bash
|
||
cmake .. -G "MinGW Makefiles"
|
||
# 或使用 Visual Studio
|
||
# cmake .. -G "Visual Studio 16 2019" -A x64
|
||
```
|
||
|
||
### 4. 编译
|
||
|
||
```bash
|
||
cmake --build . --config Release
|
||
```
|
||
|
||
### 5. 集成到 Qt 项目
|
||
|
||
在你的 Qt 代码中动态加载编译好的库。
|
||
|
||
## Python 项目的依赖
|
||
|
||
确保你的 Python 项目所需的所有依赖都已安装：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
*(需要在 uf2touft3 项目中创建 requirements.txt)*
|
||
|
||
## 故障排查
|
||
|
||
### Python 无法启动
|
||
- 检查 Python 是否在 PATH 中
|
||
- 尝试设置完整的 Python 路径
|
||
- 检查是否有多个 Python 版本
|
||
|
||
### 模块导入错误
|
||
- 确保工作目录设置正确
|
||
- 检查所有依赖的模块是否都在 Python 路径中
|
||
- 检查 `config.ini` 中的路径配置是否正确
|
||
|
||
### 中文路径问题
|
||
- 确保所有路径使用 UTF-8 编码
|
||
- 避免在路径中使用特殊字符
|
||
|
||
## 自定义配置
|
||
|
||
如需修改 Python 脚本路径，可以编辑 `mainwindow.cpp` 中的配置：
|
||
```cpp
|
||
QString scriptPath = "F:/04.python/04.python/uf2touft3/main.py";
|
||
```
|