🏭 TranslatorFactory 架构

架构 工厂分发

TranslatorFactory.createTranslator 是翻译器分发的唯一入口：按目标元素扩展名从内置表中挑 Translator 实现；扩展名不匹配时先问插件的 FullArchiveReader.buildTranslator，无插件则回退到 JavaTranslator。

扩展名 → Translator 分发表

flowchart TD
    T["createTranslator(className, archiveFile,<br/>allClassNames, fullArchiveReader)"] --> X{"后缀匹配"}
    X -- ".xml" --> AX["AndroidXmlTranslator<br/>二进制 XML → 明文"]
    X -- ".dex" --> DX["DexInfoTranslator<br/>dex 信息/方法统计"]
    X -- ".jar" --> JX["JarInfoTranslator<br/>jar 概要"]
    X -- ".apk" --> AX2["ApkTranslator<br/>APK 仪表盘"]
    X -- ".so" --> EX["ElfTranslator<br/>ELF 结构输出"]
    X -- "其它" --> P{"fullArchiveReader 非空<br/>且非 Empty?"}
    P -- 是 --> PR["插件 buildTranslator"]
    P -- 否/空 --> JT["JavaTranslator<br/>类反编译兜底"]

扩展名	Translator 实现	典型产物
.xml	AndroidXmlTranslator	明文 manifest
.dex	DexInfoTranslator	dex 头部信息、方法统计
.jar	JarInfoTranslator	jar 依赖与大小
.apk	ApkTranslator	APK 仪表盘（dashboard）
.so	ElfTranslator	文件大小、DT_NEEDED、动态符号
其它	插件回退 → JavaTranslator	类源码/反编译

匹配优先级与回退

判定顺序严格、互斥、靠前优先：

1. 五类内置扩展名 — .xml / .dex / .jar / .apk / .so，各自 endsWith 命中即返回，不再看后续。
2. 插件接管 — 传入的 fullArchiveReader 非空且不是 EmptyFullArchiveReader 时，调 buildTranslator(className, archiveFile) 让插件自定义未知元素。
3. Java 兜底 — 默认 new JavaTranslator(className, archiveFile)。对 .class 与一切未匹配项走类反编译。

⚠️ EmptyFullArchiveReader 是插件接口的空实现（buildTranslator 返回吞掉一切的占位 Translator），工厂用 instanceof 判断它的存在以决定是否跳过插件分支——这是"默认无插件"与"注册了插件"的区分点。

调用方

调用方	场景
SilverGhost.readContents	读内容后立即翻译 AndroidManifest.xml 缓存明文
SilverGhost.translateArchiveElement	GUI 选中类/条目时的即时翻译
SilverGhostFacade	CLI/API 各静态方法的翻译路径

工厂是纯静态分发，不持状态——所有调用都从 createTranslator 的四个静态重载进入，最终收敛到同一个 4 参核心方法。

进一步阅读

• 🧩 TranslatorFactory · Translator · JavaTranslator
• 🏗️ 翻译器架构 · FullArchiveReader · EmptyFullArchiveReader
• 🎯 SilverGhost 编排 · 入口层