Skip to content

release_notes_v3.0.0.md

Latest commit

 

History

History
96 lines (70 loc) · 8.56 KB

release_notes_v3.0.0.md

File metadata and controls

96 lines (70 loc) · 8.56 KB

中文

这次 GitHub 上正式发布的 v3.0.0，不仅包含最初 Release v3.0.0 提交里的大版本更新，也补齐了首发后继续验证和修复的那一批关键改动。

重点不只是继续打磨日常传输，而是把复杂校园网环境里最现实的几个痛点一起补上了：

  • 不只是“能发现但几乎传不动”，还包括“切到校园网后设备列表经常空白”与“发现到了又很快消失”
  • 不只是加了一条兼容链路，还把这条兼容链路的取消、超时回收、会话串包防护和体积边界一起收紧
  • 不只是拖拽体验更顺手，DropZone 的预热、回弹防护和后台最小化也进一步稳定

复杂网络与校园网突破

  • 新增手动 HTTP 兼容模式，默认关闭，默认仍优先保持 LocalSend 标准 HTTPS 传输。
  • 当校园网里设备发现正常、但 HTTPS 数据面频繁超时或悬空时，可在 macOS 菜单栏 Advanced -> Compatibility Mode (HTTP) 手动切换到兼容链路。
  • macOS 端新增 plain HTTP 接收器，并把局域网接收端口独立到 53318；Android 守护进程侧使用独立传输端口 53319，让发现面和数据面职责更清晰。
  • 发送前会做真实数据面预检，并在 HTTPS / HTTP 之间选择当前真正可用的链路，减少“设备明明在线却一直发不出去”的假在线情况。
  • Android -> Mac 的主动发送链路补上了 peer 记忆与连接重建逻辑，网络切换后更不容易掉进 No target found 或旧连接悬挂。
  • Android 守护进程增加网络绑定变化检测与自重绑能力，热点、校园网、接口切换后的恢复速度更快。
  • macOS 端新增了大网段校园网发现增强：当 UDP multicast 在 /16、/17 等校园网里失效时，会按 /24 切片向外扩散探测，不再只盯着当前一个小网段。
  • 设备一旦被发现，Mac 会额外记住它最近可用的 IP，并通过轻量级 preferred host probe 做后台保活与冷启动回找，修复“菜单里搜不到 / 出现后又很快消失”的问题。

首发 3.0.0 之后补上的兼容链路加固

  • campus fallback 现在加入了 session nonce 和来源 IP 绑定，降低旧包、错包、跨会话串包导致误判成功的概率。
  • fallback 增加超时清理与取消能力，半传输中断、假 prepare 或用户手动取消时，不再轻易留下脏状态。
  • fallback 默认不再每包同时做组播和广播双发，局域网噪音更小。
  • fallback 体积边界收紧到 1 MB，避免大文件在弱网或拥塞 Wi-Fi 下放大内存与流量压力。
  • HTTP 兼容模式保持手动开启，不会静默把原本的默认 HTTPS 传输自动降级成兼容链路。

DropZone 与拖拽体验升级

  • 重做本地文件拖拽识别，只接受真实的本地文件拖拽，忽略文本选择、窗口移动或其他伪拖拽来源。
  • 新增拖拽负载缓存与回读逻辑，修复 AppKit 在边界抖动时丢失 pasteboard 内容导致的“松手弹回”问题。
  • DropZone 预热、显示、隐藏与最小化流程重新梳理，拖拽飞行中尽量不做破坏 session 的窗口层级变更。
  • 边界命中、退出延迟和后台收起策略都做了收紧，拖拽目标更稳，失败时也更少打断操作。

传输与全链路稳定性

  • macOS 出站发送器补充了更强的预检、重试与协议切换策略。
  • Android 守护进程和 LocalSend patch 继续强化复杂网络下的链路恢复能力。
  • Magisk 模块与 Android 侧 daemon 资产一并刷新，发版构建产物与运行时代码保持一致。

兼容性说明

  • 默认安全模式仍然优先使用 HTTPS，继续保留与官方 LocalSend 的标准协议兼容能力。
  • HTTP 兼容模式 是 AirSend 针对复杂校园网场景额外提供的能力，官方 LocalSend 当前不提供这条手动兼容路径。
  • 复杂校园网下的“设备列表恢复与保活”能力现在也一并落地，不再只解决“传不出去”，还解决“设备经常看不见”。
  • 建议家庭路由器、手机热点等正常局域网继续使用默认安全模式；只有在“能发现、但几乎传不动”的校园网环境下再手动打开兼容模式。

English

This published GitHub v3.0.0 release includes not only the original Release v3.0.0 commit, but also the critical follow-up fixes we added after continued real-world validation.

The breakthrough is no longer just "campus Wi-Fi can discover devices but can barely transfer":

  • it also covers "after switching to campus Wi-Fi the device list is empty"
  • and "the device appears once, then disappears again"

It also means the compatibility path is no longer just present; it is now tightened with better cancellation, timeout cleanup, session isolation, and payload boundaries.

Breakthroughs for campus and complex LAN environments

  • Added a manual HTTP Compatibility Mode. It is off by default, and secure LocalSend-style HTTPS remains the default path.
  • When discovery works on a campus network but the HTTPS data plane keeps timing out or hanging, you can manually switch macOS to Advanced -> Compatibility Mode (HTTP).
  • macOS now has a dedicated plain-HTTP receiver and a separate LAN transfer port on 53318; the Android daemon uses its own transfer port 53319, keeping discovery and transport concerns cleaner.
  • Before sending, AirSend now performs real data-plane preflight checks and chooses the transport that is actually reachable, reducing the classic “device looks online but transfers never start” failure mode.
  • The Android -> Mac active-send path now remembers peers and rebuilds the connection state more reliably after network churn, reducing No target found and stale-route failures.
  • The Android daemon now watches for binding changes and can rebind itself after hotspot, campus Wi-Fi, or interface transitions.
  • macOS discovery now handles large campus subnets more aggressively: when UDP multicast is suppressed on /16 or /17 style LANs, it expands probing by /24 slices instead of staying trapped in a single local slice.
  • Once a device has been found, macOS also remembers its last reachable IP and keeps it alive with a lightweight preferred-host probe, fixing the “device list goes blank again” problem after campus-network transitions or app restarts.

Compatibility-path hardening added after the first 3.0.0 commit

  • The campus fallback path now uses a session nonce plus source-IP binding to reduce stale packets, wrong packets, and cross-session state pollution.
  • Fallback now has timeout cleanup and real cancellation support, so interrupted transfers and fake prepare packets are less likely to leave dirty state behind.
  • Fallback no longer defaults to dual multicast+broadcast sending for every packet, which reduces LAN noise.
  • The fallback payload cap is now 1 MB, avoiding large-file memory and airtime amplification on congested Wi-Fi.
  • HTTP Compatibility Mode remains manual and explicit instead of silently downgrading the default HTTPS path.

DropZone and drag-and-drop improvements

  • Reworked local-file drag detection so only real local file drags are accepted; text selections, window moves, and other false-positive drags are ignored.
  • Added staged drag payload caching and recovery to fix the AppKit boundary case where the pasteboard payload disappears and the drop “bounces back”.
  • Reworked DropZone prewarm, show, hide, and minimize behavior to avoid window-layer changes that can break the drag session mid-flight.
  • Tightened boundary handling, exit timing, and background minimization behavior so the target feels more stable and less disruptive during drag-and-drop.

Transport and end-to-end stability

  • The macOS sender now uses stronger preflight, retry, and protocol-switching behavior.
  • The Android daemon and LocalSend patches continue to harden recovery on unstable or policy-heavy LANs.
  • The Magisk module and Android daemon assets have been refreshed together so release artifacts stay aligned with the runtime code.

Compatibility notes

  • The default secure mode still prioritizes HTTPS and preserves standard protocol compatibility with official LocalSend in normal LAN environments.
  • HTTP Compatibility Mode is an AirSend-specific answer for difficult campus-style networks; official LocalSend does not currently offer this manual compatibility path.
  • The release also improves device-list recovery and keepalive behavior on campus LANs, not just the transfer path itself.
  • For home routers and mobile hotspots, the default secure mode is still recommended. Turn on compatibility mode only for networks where discovery works but actual transfers repeatedly stall.