大海Online的博客

Looking for Interest

HarmoBridge:让一台 Mac 和一部鸿蒙手机一对一互通

有时我只想把鸿蒙手机上的一段文字贴进 Mac 的编辑器,或者把手机当前屏幕直接贴进聊天窗口。为此我做了 HarmoBridge,把手机截图、剪贴板和文件传输放进同一个工具。配套模式的设计从一个约束开始:一次只配对一台 Mac 和一部手机。

一、一对一绑定,快捷键就有了固定目标

按下 ⌘⌃V 时,我希望 Mac 直接向刚才扫码的手机取剪贴板,然后贴到当前输入框。请求截图和发送文件也走当前连接。即使局域网里同时有几部手机,快捷键的目标也由这次扫码确定。

这里的绑定是一轮会话。Mac 出码,手机扫码,配对成功后 Mac 隐藏二维码。只要连接还在,后续操作都沿用同一条连接。主动断开或网络中断后,这轮绑定结束。换手机或重新连接时,再生成一个新的二维码。

二、Mac 出码,鸿蒙手机发起连接

  1. Mac 和手机加入同一个局域网。在 Mac 的「配套 App」模式里确认局域网 IP,然后生成二维码。码里有 Mac 的地址、端口、TLS 证书和随机口令。
  2. 鸿蒙配套 App 扫码后连接 Mac。手机先验证对端证书与扫码拿到的证书一致,再在 TLS 连接里提交配对口令。
  3. 口令两分钟内有效,只能成功使用一次。Mac 接受配对后,将截图、剪贴板和文件请求绑定到这条会话。

二维码负责确定连接对象,TLS 负责保护传输。配套模式里的截图、剪贴板和文件都在局域网内点对点传输,无需注册账号或经过云端中转。剪贴板按操作读取和发送。传文件时,接收端先检查长度和 SHA-256,再保存到选定位置。

三、我在 Mac 上怎么用

默认快捷键 操作
⌘⌃V 取手机剪贴板,在 Mac 当前应用中粘贴
⌘⌃A 截取手机当前屏幕,在 Mac 当前应用中粘贴
⌘⌃C 复制 Mac 当前选中内容并发送到手机
⌘⌃K 将 Mac 剪贴板里已有的内容发送到手机

快捷键可在「快捷键与说明」中修改。自动粘贴需要 Mac 的辅助功能权限。也可以在应用窗口里触发操作。

四、下载 Mac 试用版

下载 HarmoBridge 0.1.0(Apple 芯片 Mac,ZIP,需准备 HDC)

解压后将 HarmoBridge.app 拖到「应用程序」。这是采用临时签名、未经 Apple 公证的试用包。

  • HDC 模式要求 macOS 13 或更新版本。新版已把 arm64 版 hdc 和 USB 动态库内置到 App,在 Apple 芯片 Mac 上打开即可使用,无需安装 DevEco Studio 或配置 PATH。内置版的公开下载待确认第三方组件的分发条件。使用上方试用版时,可从华为 macOS 命令行工具包获取 hdc 和随附的 USB 动态库,将工具目录加入 PATH 后从同一终端运行 /Applications/HarmoBridge.app/Contents/MacOS/HarmoBridge。手机需开启开发者调试,可通过 USB 或无线连接。截图和文件传输走 HDC,文字剪贴板还要求手机支持 testhelper。
  • 配套 App 模式要求 macOS 15 或更新版本,手机需另行安装鸿蒙配套 App。本次提供 Mac 下载包。两端已接入双向截图、文字与图片剪贴板和文件传输,完整真机流程仍待验证,尤其是手机切到后台后的连接和截图。