Swift XCFramework中OSLog相关swiftinterface编译错误问题

问题根源 #

你在创建XCFramework时，代码同时用到了os.OSLog类和OSLogEntry类型（来自OSLog模块）。命令行归档生成的.swiftinterface文件里，OSLogEntry被写成了OSLog.OSLogEntry，但集成到测试项目时，编译器会把OSLog优先识别为os模块下的OSLog类，而非OSLog模块，导致编译错误：'OSLogEntry' is not a member type of class 'os.OSLog'。

解决方法 #

1. 显式指定类型的模块归属 #

在框架代码中使用OSLogEntry时，直接加上模块前缀，明确指定它来自OSLog模块，避免编译器混淆：

import os
import OSLog

public class MyFrameworkClass {
    private let systemLog = os.OSLog(subsystem: "com.your.framework", category: "core")
    
    public func logDebugMessage(_ message: String) {
        os_log("%@", log: systemLog, type: .debug, message)
    }
    
    public func fetchLogEntries() -> [OSLog.OSLogEntry] {
        // 显式用OSLog.OSLogEntry指定来自OSLog模块
        // 这里写具体的获取逻辑
        return []
    }
}

这样生成的.swiftinterface文件里的类型引用会保持明确，不会让编译器误判OSLog的指向。

2. 导入模块时重命名 #

如果觉得直接写OSLog.OSLogEntry不够简洁，可以在导入OSLog模块时给它起别名，彻底和os.OSLog划清界限：

import os
import OSLog as OSLogModule

public class MyFrameworkClass {
    private let systemLog = os.OSLog(subsystem: "com.your.framework", category: "core")
    
    public func logDebugMessage(_ message: String) {
        os_log("%@", log: systemLog, type: .debug, message)
    }
    
    public func fetchLogEntries() -> [OSLogModule.OSLogEntry] {
        return []
    }
}

这种方式会让生成的接口文件里使用别名，从根源上避免命名冲突。

3. 检查XCFramework归档脚本参数 #

确保你的命令行归档脚本里，模块名设置正确，没有和系统模块名冲突。比如在xcodebuild archive命令中，指定-module-name参数时，不要用OSLog作为框架的模块名，避免进一步混淆：

xcodebuild archive \
  -scheme YourFrameworkScheme \
  -destination "generic/platform=iOS" \
  -archivePath "./build/YourFramework-iOS.xcarchive" \
  SKIP_INSTALL=NO \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
  -module-name YourUniqueFrameworkName

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