macOS CoreAudio插件开发：Swift类无法在Objective-C中调用问题排查

一、手动生成[MyTarget]-Swift.h的命令 #

你可以通过xcodebuild命令手动触发Swift到Objective-C桥接头文件的生成，命令格式如下：

xcodebuild -target MyTarget -configuration Debug -sdk macosx12.3 generate-swift-interface

如果需要指定和你提到的一致的派生数据路径，可添加-derivedDataPath参数：

xcodebuild -target MyTarget -configuration Debug -sdk macosx12.3 -derivedDataPath ~/Library/Developer/Xcode/DerivedData/[MyProject]-[hash] generate-swift-interface

执行后，对应的[MyTarget]-Swift.h会生成在指定派生数据路径下的Build/Intermediates.noindex/[MyTarget].build/Debug/macosx/[MyTarget].build/Objects-normal/[你的架构]/目录中（架构为x86_64或arm64）。

二、MySwiftClass被忽略的可能原因及修复方案 #

CoreAudio插件属于Extension类型Target，和普通Mac App的Swift接口导出规则存在差异，以下是常见的被忽略原因及修复方式：

1. Swift类未继承NSObject且未用@objcMembers修饰
   Swift类要被Objective-C访问，必须满足两个条件之一：要么继承自NSObject，要么用@objcMembers修饰整个类（自动为所有成员添加@objc标记）。仅给类加@objc但不继承NSObject的话，在Extension Target中不会被导出到桥接头文件。
   修复示例：

   @objc public class MySwiftClass: NSObject {
       @objc public func myPublicMethod() {
           // 实现代码
       }
   }
   

2. Swift类的访问级别不足
   Swift默认的internal访问级别在Extension Target中无法被导出到Objective-C桥接头文件，必须将类和需要调用的方法设置为public或open，同时配合@objc标记。

3. Target Build Settings配置异常
   检查CoreAudio插件Target的Build Settings：

   • 确认Swift Compiler - General下的Objective-C Generated Interface Header Name正确设置为[MyTarget]-Swift.h
   • 确认Install Objective-C Compatibility Header设置为YES
   • 确认Defines Module设置为YES（Extension Target默认可能为NO，需手动开启）

4. CoreAudio插件的特殊限制
   如果你的CoreAudio插件是AUv3类型，Swift类需要符合音频单元相关协议（如继承AUAudioUnit），否则可能被Xcode判定为非插件必需代码而跳过导出。如果是普通工具类，确保它的Target Membership仅勾选插件Target，且没有被其他Target引用导致编译冲突。

5. 派生数据缓存残留
   即使运行过xcodebuild，残留的缓存仍可能导致头文件不更新。直接删除整个~/Library/Developer/Xcode/DerivedData/[MyProject]-[hash]目录，再重新执行build命令，强制Xcode重新生成桥接头文件。

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