Files
ShadowsocksX-NG/ShadowsocksX-NG2/Domain/Plugin/ManagedPluginProviding.swift
T
Qiu Yuzhou 856d6b4272 refactor(domain): 按主题重组 Domain/ 源码目录
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 文件时两个用例均
失败并点名违规文件,清理后复验为绿。
2026-10-05 20:13:35 +08:00

82 lines
3.5 KiB
Swift
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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 }
}