# AGV-Develop_V2

**Repository Path**: theyn/agv-develop_V2

## Basic Information

- **Project Name**: AGV-Develop_V2
- **Description**: AGV开发调试上位机
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 1
- **Created**: 2023-12-14
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AGV

## README

# AGV 调试上位机

## 环境要求

- Python 3.12+
- Windows 10/11 x64
- Visual Studio 2022 (Community) + Windows SDK（Nuitka 编译需要）

## 安装依赖

```powershell
pip install -r requirements.txt
```

## 开发运行

```powershell
python main.py
```

## 打包

### Nuitka 编译（推荐，增量编译快）

```powershell
python scripts/build_nuitka.py
```

- **选项 1**：增量编译（仅编译修改过的文件）
- **选项 2**：清理后全量编译（首次或出问题时）
- **选项 3**：安装 Nuitka
- **选项 4**：安装项目依赖

输出：`dist\main.dist\AGV-Develop_YYMMDD.exe`

### PyInstaller 打包（备选）

```powershell
python scripts/build_PyInstaller.py
```

输出：`dist\AGV-Develop_YYMMDD.exe`

## 生成安装包

编译完成后，运行：

```powershell
python scripts/build_setup.py
```

需要安装 [Inno Setup 6](https://jrsoftware.org/isinfo.php)。

输出：`dist\AGV-Develop_Setup.exe`

## 路径管理

资源文件统一由 `app/common.py` 管理：

| 函数 | 说明 |
|------|------|
| `get_base_dir()` | exe 模式 → exe 同级目录；开发模式 → 项目根 |
| `get_resource(path)` | 获取资源绝对路径，如 `get_resource('widget/image/me.ico')` |

资源文件（`widget/`、`appDoc/`）放在 exe 同级目录，不打包进 exe。

## 目录结构

```
AGV-Develop_V3.6/
├── main.py              # 入口
├── app/                 # 业务逻辑
│   ├── common.py        # 统一路径 API
│   ├── crypto_tool.py   # 加密/配置
│   ├── license_checker.py # 授权验证
│   └── DataMonitor.py   # 数据监测
├── widget/              # UI 资源
│   ├── QSS/             # 样式表
│   ├── image/           # 图标/图片
│   └── Ui_*.py          # Qt UI 编译文件
├── appDoc/              # 配置/文档数据
├── scripts/             # 构建脚本
│   ├── build_nuitka.py
│   ├── build_setup.py
│   ├── build_PyInstaller.py
│   └── installer.iss    # Inno Setup 配置
└── requirements.txt
```

## 界面模块

| 模块 | 说明 |
|------|------|
| widget_main | 主界面 |
| widget_connect | 连接界面 |
| widget_imu | 陀螺仪参数监视 |
| widget_wifi | WiFi 参数设置 |
| widget_audio | 语音播报 |
| widget_tags | 二维码参数批量标定 |
| widget_config | 默认启动参数设置 |
| widget_graphConfig | 曲线绘制设置 |
| window_debug | 参数监测及曲线显示 |
| widget_servers | 多服务器 IP/端口连接 |
| widget_log | 日志界面 |
| widget_move | 运动控制界面 |
| widget_camera | 相机界面 |
| widget_test_board | 控制板一键测试 |
| widget_clean | 清洗机调试 |
| widget_clean_driver | 清洗机驱动板调试 |
| widget_ctu | CTU 调试 |
| widget_tcs_watch | 调度数据监测 |
| widget_log_analyse | 日志分析 |
| widget_standly | 纠偏算法调试 |
| widget_license | 软件许可授权 |
| widget_dataMonitor | 数据监测分析 |
| widget_OTA | OTA 升级 |