mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 05:25:41 +00:00
Domain/ 根目录原有 62 个平铺源文件,无法从目录读出主题划分。 按「目录即主题」重组为 11 个目录(Rules/Custom 为嵌套子目录):Catalog / Subscription / Rules / Runtime / Activation / Settings / SystemProxy / Plugin / Credentials / LegacyImport / Diagnostics。纯移动:类型名、模块名 与 import 均未改动,Domain/ 根下不再有散落文件。目录口径取自 GLOSSARY.md 的章节划分(配置与订阅、代理规则、代理控制与网络、设置、 凭据与诊断),而非新造分类。 配套改动: - project.yml:wrapper 与 helper 两个 target 按文件引用的 15 条显式路径 随目录改名,并补注释固定这一约定——这 15 条指向不存在的文件时, xcodegen generate 以 "missing source directory" 直接失败(实测,不静默)。 - SkeletonTests 新增 DomainLayoutTests:断言 Domain/ 根下无平铺 .swift、 树下只有 .swift。后者防的是与 App/ 同源的坑——Domain/ 整目录是 app 与 Core 的 source path,任何非源码文件都会被 XcodeGen 收进 Resources 阶段 并封进签名后的 bundle。 - README 工程结构说明同步;docs/design 与 docs/research 属历史文档不改。 验证:xcodegen generate 后 app 164 / Core 163 源文件数与整理前一致;Agent 恰好 9 个、Helper 恰好 6 个 Domain 文件(无缺失无多出);app 与 Core 各覆盖 全部 62 个。clean build 0 error;task test 1024 用例全通过(整理前 1022, +2 为新增守卫);task format 未改写任何被移动文件(证明纯移动);task lint 与整理前同为 21 条内容型 warning;packaging-gate.sh ALL CHECKS PASSED。 布局守卫已做变异验证:临时投放松散 .swift 与非 .swift 文件时两个用例均 失败并点名违规文件,清理后复验为绿。
82 lines
3.5 KiB
Swift
82 lines
3.5 KiB
Swift
import Foundation
|
||
|
||
/// 插件解析 seam:当前路径查询与一次派生使用的只读目录快照。
|
||
/// nil 表示本地不可用;托管与用户映射共用这一激活语义。
|
||
protocol PluginExecutableResolving {
|
||
func executablePath(forProgram program: String) -> String?
|
||
func catalogSnapshot() -> PluginCatalogSnapshot
|
||
}
|
||
|
||
extension PluginExecutableResolving {
|
||
func catalogSnapshot() -> PluginCatalogSnapshot {
|
||
PluginCatalogSnapshot(
|
||
entries: ManagedPluginCatalog.plugins.map { info in
|
||
let path = executablePath(forProgram: info.program)
|
||
return PluginCatalogSnapshot.Entry(
|
||
program: info.program, path: path, source: .managed,
|
||
availability: path == nil ? .missing : .available, managedInfo: info)
|
||
})
|
||
}
|
||
}
|
||
|
||
/// 受管插件静态事实(#38):来源项目、许可证、固定版本与重签标识,供编辑器
|
||
/// 插件区与诊断导出展示。事实只随发版变更(D6「升级前重做静态清单」):新增
|
||
/// 或升级插件须同步 `Vendor/<name>/manifest.json` 与锚点测试
|
||
/// `ManagedPluginCatalogTests`,两处漂移即构建期失败。
|
||
struct ManagedPluginInfo: Equatable, Sendable {
|
||
/// SIP003 程序名,同时是 bundle 内二进制名与目录里的引用键。
|
||
let program: String
|
||
/// 来源项目(GitHub owner/repo)。
|
||
let project: String
|
||
let projectURL: String
|
||
/// 固定版本 tag(禁止 latest 漂移)。
|
||
let release: String
|
||
let license: String
|
||
/// 构建期 Developer ID 重签的 identifier(`<bundle-id>.plugin.<name>`)。
|
||
let signIdentifier: String
|
||
}
|
||
|
||
/// 本版本受管集(D10):首版仅 v2ray-plugin v1.3.2;shadow-tls、Cloak 暂缓,
|
||
/// 此目录只描述随 app 发布的程序;用户自备程序由 PluginCatalog 的本机映射提供。
|
||
enum ManagedPluginCatalog {
|
||
static let plugins: [ManagedPluginInfo] = [
|
||
ManagedPluginInfo(
|
||
program: "v2ray-plugin",
|
||
project: "shadowsocks/v2ray-plugin",
|
||
projectURL: "https://github.com/shadowsocks/v2ray-plugin",
|
||
release: "v1.3.2",
|
||
license: "MIT",
|
||
signIdentifier: "com.qiuyuzhou.ShadowsocksX-NG2.plugin.v2ray-plugin")
|
||
]
|
||
|
||
static func info(forProgram program: String) -> ManagedPluginInfo? {
|
||
plugins.first { $0.program == program }
|
||
}
|
||
}
|
||
|
||
/// 生产实现:受管集内且 bundle 内可执行文件在位才返回绝对路径。D10——GUI
|
||
/// 仅在生成配置时检查可执行文件存在,运行时不逐次哈希复验(bundle 签名 +
|
||
/// 公证即信任边界);受管集外引用一律视为「本版本未提供」,路径只从静态表
|
||
/// 派生,不拼接任何用户输入。
|
||
struct BundleManagedPluginProvider: PluginExecutableResolving {
|
||
/// 插件宿主 bundle 根;生产为应用 bundle,测试注入临时目录。
|
||
var bundleURL: URL = Bundle.main.bundleURL
|
||
var fileManager: FileManager = .default
|
||
|
||
func executablePath(forProgram program: String) -> String? {
|
||
guard let info = ManagedPluginCatalog.info(forProgram: program) else { return nil }
|
||
let url =
|
||
bundleURL
|
||
.appendingPathComponent("Contents/Helpers/Plugins")
|
||
.appendingPathComponent(info.program)
|
||
guard fileManager.isExecutableFile(atPath: url.path) else { return nil }
|
||
return url.path
|
||
}
|
||
}
|
||
|
||
/// 显式「本版本什么都不提供」的实现(测试与不涉插件的场景注入用):任何插件
|
||
/// 引用都是无效激活候选(点名原因),不是静默失败。
|
||
struct NoManagedPluginProvider: PluginExecutableResolving {
|
||
func executablePath(forProgram program: String) -> String? { nil }
|
||
}
|