mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-17 20:54:41 +00:00
104 lines
4.2 KiB
Swift
104 lines
4.2 KiB
Swift
import Foundation
|
||
|
||
/// 插件解析 seam:路径、本地启动参数与传输模式,以及一次派生使用的只读目录快照。
|
||
/// nil 表示本地不可用;托管与用户映射共用这一激活语义。
|
||
struct ResolvedPlugin: Equatable, Sendable {
|
||
let path: String
|
||
let arguments: [String]
|
||
var mode: PluginTransportMode = .tcpOnly
|
||
}
|
||
|
||
protocol PluginExecutableResolving {
|
||
func resolve(program: String) -> ResolvedPlugin?
|
||
func catalogSnapshot() -> PluginCatalogSnapshot
|
||
}
|
||
|
||
extension PluginExecutableResolving {
|
||
func catalogSnapshot() -> PluginCatalogSnapshot {
|
||
PluginCatalogSnapshot(
|
||
entries: ManagedPluginCatalog.plugins.flatMap { info in
|
||
info.names.map { program in
|
||
let resolved = resolve(program: program)
|
||
return PluginCatalogSnapshot.Entry(
|
||
program: program, path: resolved?.path, source: .managed,
|
||
availability: resolved == nil ? .missing : .available, managedInfo: info,
|
||
arguments: resolved?.arguments ?? [], mode: resolved?.mode ?? .tcpOnly)
|
||
}
|
||
})
|
||
}
|
||
}
|
||
|
||
/// 受管插件静态事实:来源项目、许可证、固定版本与重签标识,供编辑器
|
||
/// 插件区与诊断导出展示。事实只随发版变更:新增
|
||
/// 或升级插件须同步 `Vendor/<name>/manifest.json` 与锚点测试
|
||
/// `ManagedPluginCatalogTests`,两处漂移即构建期失败。
|
||
struct ManagedPluginInfo: Equatable, Sendable {
|
||
/// 内置记录的固定身份,与可引用名称及打包文件名分别维护。
|
||
let program: String
|
||
let names: [String]
|
||
let executableName: 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
|
||
}
|
||
|
||
/// 本版本受管集:固定版本的 v2ray-plugin 与 Cloak 客户端。
|
||
/// 此目录只描述随 app 发布的程序;用户自备程序由 PluginCatalog 的本机映射提供。
|
||
enum ManagedPluginCatalog {
|
||
static let plugins: [ManagedPluginInfo] = [
|
||
ManagedPluginInfo(
|
||
program: "v2ray-plugin",
|
||
names: ["v2ray-plugin", "v2ray-plugin-v1"],
|
||
executableName: "v2ray-plugin",
|
||
project: "shadowsocks/v2ray-plugin",
|
||
projectURL: "https://github.com/shadowsocks/v2ray-plugin",
|
||
release: "v1.4.0",
|
||
license: "MIT",
|
||
signIdentifier: "com.qiuyuzhou.ShadowsocksX-NG2.plugin.v2ray-plugin"),
|
||
ManagedPluginInfo(
|
||
program: "ck-client",
|
||
names: ["cloak", "cloak-v2"],
|
||
executableName: "ck-client",
|
||
project: "cbeuw/Cloak",
|
||
projectURL: "https://github.com/cbeuw/Cloak",
|
||
release: "v2.12.0",
|
||
license: "GPL-3.0",
|
||
signIdentifier: "com.qiuyuzhou.ShadowsocksX-NG2.plugin.ck-client"),
|
||
]
|
||
|
||
static func info(forProgram program: String) -> ManagedPluginInfo? {
|
||
plugins.first { $0.names.contains(program) }
|
||
}
|
||
}
|
||
|
||
/// 生产实现:受管集内且 bundle 内可执行文件在位才返回绝对路径。GUI 仅在生成
|
||
/// 配置时检查可执行文件是否存在,运行时不逐次哈希复验(bundle 签名 +
|
||
/// 公证即信任边界);受管集外引用一律视为「本版本未提供」,路径只从静态表
|
||
/// 派生,不拼接任何用户输入。
|
||
struct BundleManagedPluginProvider: PluginExecutableResolving {
|
||
/// 插件宿主 bundle 根;生产为应用 bundle,测试注入临时目录。
|
||
var bundleURL: URL = Bundle.main.bundleURL
|
||
var fileManager: FileManager = .default
|
||
|
||
func resolve(program: String) -> ResolvedPlugin? {
|
||
guard let info = ManagedPluginCatalog.info(forProgram: program) else { return nil }
|
||
let url =
|
||
bundleURL
|
||
.appendingPathComponent("Contents/Helpers/Plugins")
|
||
.appendingPathComponent(info.executableName)
|
||
guard fileManager.isExecutableFile(atPath: url.path) else { return nil }
|
||
return ResolvedPlugin(path: url.path, arguments: [])
|
||
}
|
||
}
|
||
|
||
/// 显式「本版本什么都不提供」的实现(测试与不涉插件的场景注入用):任何插件
|
||
/// 引用都是无效激活候选(点名原因),不是静默失败。
|
||
struct NoManagedPluginProvider: PluginExecutableResolving {
|
||
func resolve(program: String) -> ResolvedPlugin? { nil }
|
||
}
|