# visualzvm_release

**Repository Path**: johhz/visualzvm_release

## Basic Information

- **Project Name**: visualzvm_release
- **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-09-14
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VisualZVM Releases

三平台发行文件通过本仓库的 [Releases](https://gitee.com/johhz/visualzvm_release/releases) 分发。

## PyQt5 2.1.4

这是 PyQt5 版三平台发行包，包含 SCP 上传、Guest IP 显示和原有 ZVM 管理界面。
包内已携带 Python、Qt5 和所需应用依赖，运行电脑无需安装 Python 或 Qt SDK。

## 下载与运行

| 包 | 目标平台 | 启动方式 |
|---|---|---|
| `VisualZVM-PyQt5-2.1.4-Windows-x64.zip` | Windows 10/11 x64；Windows 11 ARM64 可通过系统 x64 模拟运行 | 完整解压，打开 `VisualZVM.exe` |
| `VisualZVM-PyQt5-2.1.4-macOS-arm64.zip` | Apple Silicon Mac，macOS 11 或更新版本 | 解压后将 `VisualZVM.app` 移到“应用程序” |
| `VisualZVM-PyQt5-2.1.4-Linux-x64.tar.gz` | Linux x86_64，发布基线为 Ubuntu 24.04 / glibc 2.39 | 完整解压，在图形桌面中运行 `./VisualZVM` |

不要只复制可执行文件，运行库、插件和资源文件需要保留在同一个发布目录。
macOS 包采用 ad-hoc 签名，未做 Apple Developer ID 公证；Intel Mac 不适用此 arm64 包。
Linux 仍使用系统的 glibc、图形显示服务和显卡驱动。串口访问需要当前用户具有设备权限。

## 连接 ZVM

- 在板端启动 `zvm manager`，通过“连接 → 网络连接”输入板端 IP。
- 普通管理连接使用 TCP 4242/4243。原来的 TCP 连接、收发及监控协议保持不变。
- 本地串口选实际设备及板端波特率。当前 Parallels 虚拟 COM1 用 115200，实体板串口仍是 1500000。
- SSH 串口转发由外部工具负责；应用不会修改虚拟机或自动开启隧道。
- macOS/Linux 包不包含蓝牙后端；Windows 保留原 PyBluez 后端。跨平台主要使用网络和串口。

## SCP 上传与 IP

- 交互页每个 VM 名称下面、首页每张 VM 卡片内显示 Guest IP。
- 优先使用板端上报的 IP；未上报时按 `192.168.1.(200 + VM ID)` 显示默认地址。
- 选择运行中的 Linux 或 Zephyr VM，点击绿色“上传文件”。只在实际上传时显示进度框。
- Linux：先使用内置项目密钥，认证失败后尝试密码 `zvm`，目标为 `/root/`。
- Zephyr：直接使用密码 `zvm`，目标为 `/ext2/所选文件名`。
- 使用传统 SCP 协议 `-O`。沿用实验环境的动态 IP 策略，不检查或保存服务器主机指纹。
- 运行电脑需有兼容的 OpenSSH `ssh` 和 `scp`；Guest 需提供 SSH/SCP 服务、可用认证及可写目标目录。
- `file open failed: -30` 一般指向 Guest 文件系统只读；路径和挂载问题需要在 Guest 端处理。

## 构建信息

三个平台从同一份 PyQt5 源码构建。macOS 使用 Python 3.11.13，Linux 使用
Python 3.11.15，Windows 使用 Python 3.11.9。打包工具为 PyInstaller 6.14.1。
各平台的实际依赖版本见包内 `dependencies.json`；第三方许可文件见 `licenses/`。
配套源码归档包含构建脚本和依赖列表。

按用户要求，本次仅构建和打包，没有运行应用功能测试或板端测试。

本版源码提交：`5e1d3645a1eccc133318a3bbe192786b28ad26c3`。对应源码随 `VisualZVM-PyQt5-2.1.4-source.zip` 提供。
校验值见 `SHA256SUMS.txt`。