如何处理Cocoa可加载NSBundle插件中的重复符号问题？

项目结构 #

Host
|-- LoadablePlugIn
|   |-- Main.storyboard
|   |-- Info.plist
|   |-- TDWLPIClassOne.h
|   |-- TDWLPIClassOne.m
|   |-- TDWLPIClassTwo.h
|   |-- TDWLPIClassTwo.m
|-- TDWAppDelegate.h
|-- TDWAppDelegate.m
|-- TDWClassOne.h
|-- TDWClassOne.m
|-- TDWUtils.h
|-- TDWUtils.mm
|-- Base.lproj
|   `-- Main.storyboard
|-- Info.plist
`-- main.m

背景与问题 #

根目录是Host主可执行目标的源码，LoadablePlugIn为同名嵌入式插件目标的资源。两个目标都需要用到TDWUtils的符号，因此将TDWUtils.mm同时加入了两者的编译源。目前编译运行无异常，但由于插件是运行时动态加载的，链接器无法检测到二进制文件中TDWUtils符号重复的问题，不确定该场景是否健壮。插件加载核心代码如下：

...
Class plugInPrincipalClass = [NSBundle bundleWithURL:loadablePlugInURL].principalClass;
NSWindowController *windowController = [plugInPrincipalClass instantiateInitialController];
...

分析与解决方案 #

不建议保持现状 #

当前运行正常只是暂时的，这种写法存在明显隐患：

• 宿主和插件会各自拥有一份TDWUtils的实现副本，工具类中的静态变量、全局对象会存在两个独立实例，极易引发逻辑不一致（比如全局状态变量在宿主和插件中值不同步）。
• 后续若修改TDWUtils的实现，很容易出现宿主与插件版本不一致的情况，排查这类问题的成本极高。

推荐优化方案 #

1. 抽离为独立动态库

将TDWUtils打包成动态Framework或dylib，让宿主和插件都链接这个动态库。这样整个进程内只会存在一份TDWUtils的实现，从根源上解决符号冲突和多实例问题，这是最规范、最可靠的做法。

2. 给插件添加符号隐藏标记

如果不想抽成动态库，可以给LoadablePlugIn目标添加-fvisibility=hidden编译标记，同时手动将TDWUtils中插件内部需要调用的符号设置为可见（例如在函数或类声明前添加__attribute__((visibility("default")))）。这样插件内的TDWUtils符号不会暴露到全局符号表，就不会与宿主的符号产生冲突。

3. 静态化实现或添加命名前缀

对于纯C/ObjC++编写的工具类，可以将内部实现用static修饰，或者给插件内的工具类成员加上独有的命名前缀，从命名层面避免冲突。不过这种方式维护成本较高，可靠性不如前两种方案。

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