mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-10-28 21:23:44 +00:00
Qiu Yuzhou
7d0ebc79b4
单测不再以 app 可执行为宿主：新增 ShadowsocksX-NG2Core 静态库 target 同源 编译 App/（除 @main）与 Domain/，模块名沿用 ShadowsocksX_NG2 使全部测试的 @testable import 零改动；app target 模块改名 ShadowsocksX_NG2App 避免共享 Products 目录 swiftmodule 撞名。两个测试 target 改链 Core 后 xcodegen 不再 生成 TEST_HOST，xcodebuild test 只构建不启动 app——与安装版运行实例零接触 （pgrep 全程验证无 app 进程）。同源双编译沿用 Agent/Helper 共享 Domain 文件 的既定模式，Core 只被测试 target 依赖，发布链不编译它。 随之删除 MainApp.swift 的整套测试宿主脚手架（isUnitTesting/makeTesting/ Noop 服务/Ephemeral 存储，-142 行），app 在测试下不再启动，守卫失去存在 理由。宿主移除暴露三处 Bundle.main 依赖，改为显式缝：控制器新增 appBundle 注入（内置规则快照 BuiltinRuleCatalog 与 LaunchDaemon 清单指纹 launchDaemonPlistData(in:) 均按 bundle 读取，生产默认 .main 不变）；XPC listener delegate 期望客户端身份改为可注入（测试按本进程 SecCode 自查）。 测试经 AppArtifact.bundle（沿测试包落盘位置向上查找 app 产物，兼容 TEST_HOST 内嵌与平级两种布局）统一取产物。 665 单测 + 11 冒烟全绿，task build 生产构建不受影响。
ShadowsocksX-NG
🚧 重新实现进行中 —— 本仓库正在使用现代技术栈重写 ShadowsocksX-NG macOS 客户端。
新工程不再通过 git 子模块在仓库内构建依赖，而是直接复制上游项目发布好的可执行文件，以简化构建流程。
目录结构
.
├── ShadowsocksX-NG2/ # 新工程：现代化重写版本（开发中）
└── Legacy/ # 旧版工程完整源码，仅供参考，不保证可构建
旧版工程的功能说明与使用文档见 Legacy/README.md。
开发钩子
新 clone 后，在仓库根目录启用 Git hooks：
git config core.hooksPath .githooks
启用后，pre-commit 只检查暂存区中 ShadowsocksX-NG2/ 下的 .swift 文件：swift format 的结果写回暂存区、不修改工作区；SwiftLint 的 error 级违规拒绝提交，warning 仅提示。Legacy/ 和其他文件跳过；没有 NG2 Swift 文件时直接放行。含有 NG2 Swift 文件但缺少工具时，提交检查失败。工具安装与版本见 ShadowsocksX-NG2/README.md。