如何通过Closure Compiler编译SDK并向未编译扩展提供API接口

首先得明确核心问题：Google Closure Compiler在高级优化模式下会混淆未显式标记为对外暴露的符号，你定义的INode接口和getMagic方法虽然加了@export，但如果没有配合正确的编译配置或导出逻辑，编译后方法名会被替换（比如变成b），导致外部实现的getMagic无法被SDK识别，继承场景下的super.getMagic()也会失效。

为什么之前的临时方案不生效？ #

你尝试的node['getMagic']() || node.getMagic()逻辑，在外部直接实现接口时能凑合用，但遇到继承就会崩溃：当外部类extends NN.INode时，super.getMagic()需要指向SDK中INode原型的方法，但编译后的SDK里INode.prototype.getMagic已经被混淆成了其他名称（比如b），外部原型链上根本找不到getMagic这个方法，自然调用失败。

正确的解决方案 #

要实现SDK与外部扩展的双向兼容，需要做到两点：让SDK对外暴露的接口/方法保留原名，SDK调用外部对象方法时不依赖混淆后的名称。

1. 调整SDK代码与编译配置，保留对外符号的原名

首先确保你的NN命名空间、INode接口以及getMagic方法被编译器明确标记为需要保留原名：

• 给NN命名空间添加@export注解
• 如果使用Closure Library，用goog.exportSymbol和goog.exportProperty显式导出符号；如果是原生JS，配合编译选项强制保留指定属性名

修改后的SDK代码示例：

/**
 * @nocollapse
 * @const
 * @namespace
 * @export
 */
var NN = {}
/**
 * @interface
 * @export
 */
NN.INode = function() {}
/**
 * @export
 * @return {number}
 */
NN.INode.prototype.getMagic = function() {}

// 若使用Closure Library，添加显式导出逻辑（可选但推荐）
if (typeof window.goog !== 'undefined') {
  goog.exportSymbol('NN.INode', NN.INode);
  goog.exportProperty(NN.INode.prototype, 'getMagic', NN.INode.prototype.getMagic);
}

document.addEventListener("click", () => {
  const node = /** @type NN.INode */ (window['specialNodeAddedByAPIClientOutsideOfTheSdk'])
  // 用字符串索引调用方法，避免依赖混淆后的名称
  console.log(node['getMagic']())
})

然后编译时添加强制导出的选项（以命令行编译为例）：

java -jar closure-compiler.jar \
  --compilation_level ADVANCED_OPTIMIZATIONS \
  --js nn-sdk.js \
  --js_output_file nn-sdk-compiled.js \
  --export_property "NN.INode" \
  --export_property "NN.INode.prototype.getMagic"

这个配置会告诉编译器：NN.INode及其原型上的getMagic方法必须保留原始名称，不能被混淆。

2. 验证外部扩展代码的兼容性

修改后，外部的继承和实现代码就能正常工作了：

// 外部实现代码
NN.Node = class extends NN.INode {
  getMagic() {
    // super.getMagic()能正确指向SDK中保留原名的INode.prototype.getMagic
    const superValue = super.getMagic();
    return superValue !== undefined ? superValue : 4;
  }
}
window['specialNodeAddedByAPIClientOutsideOfTheSdk'] = new NN.Node();

此时点击事件触发时，SDK调用node['getMagic']()会正确执行外部类的方法，super.getMagic()也能正常访问SDK接口的默认实现。

关键原理总结 #

• Closure Compiler的高级优化会默认混淆所有未标记为对外暴露的符号，必须通过注解+编译选项明确保留需要外部访问的接口和方法名。
• SDK调用外部对象的方法时，必须用字符串索引（node['getMagic']()）而非直接点调用，避免依赖编译后的混淆名称，确保外部实现的方法能被正确识别。

内容的提问来源于stack exchange，提问作者kmitov