HMTrans v0.2.1

HMTrans v0.2.1

本次更新替换了原有的 v0.2.1 安装包，版本号保持不变，包含截至 2026 年 7 月 17 日的最新连接、配对、设备信息、传输状态和安装包布局修复。建议 Mac 与 MatePad 两端都重新安装或升级到最新的 v0.2.1。

本次替换包新增修复

• 修复 macOS DMG 打开后窗口尺寸异常、工具栏出现和图标布局错乱的问题，安装窗口现在使用固定布局。
• 修复 Mac 端只显示 Pad 型号名、无法显示用户设置的完整设备名称的问题。
• 修复 HarmonyOS 当前网络 IPv4 地址字节顺序颠倒的问题，例如 192.168.3.204 不再错误显示为 204.3.168.192。
• 修复首次安装后点击设备无响应、配对码校验失败，以及已配对设备重新连接无反应的问题。
• 修复双端连接状态不同步，以及已连接后仍残留“正在确认身份”提示的问题。
• 修复任意一端删除配对关系后，对端仍显示连接中或无法重新配对的问题。
• 修复文件实际接收完成后，Pad 端仍停留在“准备中”的问题。
• 修复同一台设备因名称变化或历史别名被拆分成多个历史记录分组的问题。
• 清理 HarmonyOS 发布构建中的异常处理警告，并完善相关状态测试。

配对与连接改进

• 正常覆盖升级会保留已配对设备，并自动尝试恢复连接。
• 完全卸载后重新安装会生成新的应用身份，需要重新输入六位配对码。
• 首次配对只需在任意一端输入另一端显示的六位配对码。
• 任意一端删除已配对设备后，对端会实时退出已连接状态，再次连接时需要重新配对。
• 优化设备发现、在线状态、断线检测、受信任设备心跳和重连逻辑。
• 优化传输完成回执，发送端只有在收到接收端最终确认后才会显示完成。

HarmonyOS 权限说明

• ohos.permission.READ_LOCAL_DEVICE_NAME：读取系统中设置的完整设备显示名称，用于在 Mac 端正确显示 Pad 名称。
• ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY：将接收文件保存到文件管理器可见的 Download 目录。
• 文件仍然只通过局域网在设备之间直传，不上传云端，也不需要账号。

使用说明

• Mac 与 MatePad 需要连接同一 Wi-Fi。
• 建议双端同时升级到本次最新的 v0.2.1，旧包与新包混用可能无法获得完整修复。
• HarmonyOS 端应授予应用所需的设备名称、网络和下载目录权限。

系统要求

• macOS 26 或更高版本
• HarmonyOS 6.1.0 / API 23 或更高版本

macOS 安装包校验

• 文件名：HMTrans.dmg
• SHA-256：162e76f8a3b95e55c9b0ec399b69d6d4db0a6eadb50f271e8121c0bea85df301

macOS 安装包使用本地 ad-hoc 签名，未经过 Apple 公证。若首次打开时被系统阻止，请前往“系统设置 → 隐私与安全性”选择“仍要打开”。