Files
MeshPort/docs/compatibility.md
T
shenleiandClaude Opus 5.5 dc1bfc99d2 Move mesh networking logic into the SDK and fix lifecycle bugs
SDK:
- Add build_config/migrate_config, mesh_cidrs, route_generation, health
  and start_bridged; expose abi_info (capability revision 2).
- Add wait_routes long-poll; stop wakes waiters, and context_free now
  stops the network immediately instead of waiting for waiters to time out.

Hosts:
- Dart: waitRoutes(), MeshProxySession route watcher, ABI capability check.
- Android: fix a deadlock where every VPN request waited on its own
  single-thread worker; requests are now async, status is served from a
  snapshot, and combined mode reports Partial when the mesh stops.
- macOS helper: mesh-only unified mode stops when the mesh is lost;
  installed_subnet_routes excludes the overlay.
- Lab: restore Partial sessions, write migrated profiles back, remove the
  unreachable TOML import dialog; native test now connects via the form.

Docs updated accordingly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 18:17:42 +09:00

1.7 KiB
Raw Blame History

兼容范围与依赖

EasyTier 仓库:https://github.com/EasyTier/EasyTier

vendor/easytier 是固定提交的本地定制快照,来源和修改清单见该目录 MESHPORT.md。基础提交:7af7bdc16a41d64d58743d15023a63b3eed2102c。Cargo.lock 固定传递依赖;build 使用 --locked。

原生库能力:C ABI 为 v1,Flutter 绑定要求能力修订号(abi_info.revision)≥ 2;MeshPortClient.open 在打开时检查,旧库(无 abi_info 或修订号更低)会以“native library is too old … rebuild meshport-ffi”的 StateError 拒绝。fromTransport(Android VpnService、macOS 辅助进程)由各自宿主保证同版本原生库,不做该检查。

当前本机验证:macOS aarch64、Rust1.99、Flutter3.41.4/Dart3.11.1。

目标平台:macOS/Linux/Windows/iOS/Android。macOS 原生库和客户端已验证。Android ARM64 原生库、JNI 和 APK 已构建,真机配置加密存储、应用内与系统 VPN TCP/UDP,以及公告子网自动接入和撤销已通过。其他 runner 是脚手架,仍需要目标编译、链接、库加载和真机测试。iOS 使用静态链接,并需要保留导出符号。Android 说明见 android.md。

本地集成测试两端使用同一固定 EasyTier 核心,因此证明的是该版本应用内数据面的组网与数据校验。与服务器既有发布版、跨版本混合网络、公网中继、NAT打洞、跨国链路和移动端后台恢复尚未实测。

上游 EasyTier 使用 LGPL-3.0,文本见 upstream/EasyTier-LICENSE;未复制 GPL-3.0 iOS 客户端代码。MeshPort 自身许可证尚未选定。发行原生库/客户端时需核对上游、smoltcp及传递依赖许可证和对应源码/构建材料。