Files
Vole/scripts
yiguodev 7ba711d9b6 Adopt tun-rs and separate TCP receive/send buffer budgets (#5)
* refactor(tun): adopt tun-rs and split TCP buffer budgets

Preserve borrowed-fd ownership, framing, bounded batches and stop semantics. Add independent receive/send TCP buffer totals without increasing defaults. Refresh netstack reference links and platform documentation.

Validation: 117 memory regressions; netstack and production Clippy; all-target compilation; iOS and tvOS checks; formatting and diff checks. Linux offload remains disabled.

* Update repository references for YuanDevTeam organization
2026-10-07 20:47:11 +08:00
..

平台编译

vcore-scripts 只负责编译 Apple、Android、Windows 产物及记录交付身份。 命令从 VCore 根目录运行,或通过 --project 显式指定本仓库 scripts;Python 工程由 uv / uv.lock 管理,不推断外部工程。Rust 的定向离线回归见 tests。

入口

uv run --project scripts --locked vcore-scripts build apple
uv run --project scripts --locked vcore-scripts build android
uv run --project scripts --locked vcore-scripts build windows

# 交付记录要求干净、已提交的 checkout;在对应构建宿主执行。
uv run --project scripts --locked vcore-scripts build apple --delivery
uv run --project scripts --locked vcore-scripts build android --delivery
uv run --project scripts --locked vcore-scripts build windows --delivery

原生依赖需要 C/C++、CMake、Perl 和 libclang;Rust 目标须预先安装。 平台构建拒绝 interop-test / benchmark-geodata-http 等测试 feature。

平台产物

平台 构建环境与产物
Apple macOS / Xcode;dist/apple/LibVCore.xcframework,含 iOS 真机/模拟器、macOS、tvOS 真机/模拟器五切片
Android macOS 或 Linux / Android NDK;dist/android 的 ARM64、x86_64 库及同 ABI / NDK 的 libc++_shared.so
Windows 原生 ARM64 或 x64 Windows / Visual Studio C++;dist/windows/<architecture> 的 DLL、Provider Host、Session Host 及身份摘要

Apple 的 iOS/tvOS 真机和模拟器仅 ARM64,macOS 为 ARM64/x86_64 universal。 iOS 最低 13.0、macOS 10.15、tvOS 17.0;ARM64 iOS 模拟器/macOS 切片分别至少 14.0/11.0。构建检查每个 Rust/原生库对象的 Mach-O 平台、架构和最低版本。 最终链接 libc++;module map 已声明,直接 C 链接需 -lc++。

Android NDK 优先使用 ANDROID_NDK_HOME;否则从 ANDROID_HOME/ndk 选择 VCORE_ANDROID_NDK_VERSION 指定的完整版本或主版本内最新已安装正式版,默认主版本 为 30,排除预览版。Windows ARM64 还需要 clang-cl / clang 和 Ninja,并保留 BoringSSL 汇编;Windows 构建固定使用 Release 和完整生产 feature 集合。

Android 的 C/C++、CMake 与 bindgen 使用同一 API level(默认 24);绑定生成显式 传入带 API 版本的 clang target,兼容 NDK 30 的版本要求,并保留生效的额外 clang 参数。

普通 Apple/Android 构建可通过 VCORE_BUILD_PROFILE、VCORE_FEATURES 和各平台 输出/部署目标/NDK/API/ABI 环境变量定制,具体默认值以 builds.py 为准。 CARGO_TARGET_DIR 改变普通构建的中间产物位置,相对路径从本 VCore checkout 解析; 交付模式禁用这些隐藏输出、编译选项和 feature 覆盖。

Linux 使用原生 GNU/glibc 工具链,不属于上述打包交付入口:

cargo build --locked --release --lib --features ffi

交付边界

--delivery 在标准输出目录生成 vcore-delivery.json,绑定 VCore commit/tree、 lockfile、API/schema、完整 features、工具链/SDK/NDK 和全部产物的大小/hash。 本地 boring path 开发态要求 fork 同样干净并记录 commit/tree;PR/发布仍须切回 Git release 依赖,按 TLS 来源契约 审查。

交付前拒绝输出路径中的符号链接/reparse point,清除旧记录;Android 同时清空标准 输出以隔离旧 ABI。构建后的内部完整性检查核对文件集合、源码身份、架构与平台元数据, 包括 Android C++ runtime、Apple 全部切片和 Windows 配套进程。 检查失败不保留交付 manifest。它不执行原生 C/Swift 消费者,不证明设备 VPN、 签名安装、许可证审核或正式发布;这些按 验收边界 独立取证。

独立容器验证

互通与压力编排位于公开的 container-benchmark, 始终显式提供 VCore checkout;VCore 编译入口不导入该工程或猜测相邻路径。

uv run --project /path/to/container-benchmark --locked container-benchmark interop --list
uv run --project /path/to/container-benchmark --locked container-benchmark interop --source vcore=/path/to/VCore
uv run --project /path/to/container-benchmark --locked container-benchmark stress --source vcore=/path/to/VCore --geodata-records 1280000

interop 保留 Mihomo listener 和 Xray-core / Hysteria2 / V2Ray / Caddy 补充对端; stress 使用原生 Linux TUN、GeoData 与混合吞吐/DNS 负载,二者独立执行。 所有服务端在隔离容器运行,规则见 测试隔离。 依赖身份、用例、指标与清理方式由 benchmark 维护;迁移代码或离线测试通过不等于 当次网络互通或压力测试已经通过。