能否根据目标macOS版本为Swift类提供不同的Sendable定义？

你的思路完全可行，这是苹果生态中处理新旧系统API兼容的标准做法，不存在方向偏差。以下是具体的实现细节和问题解答：

一、分版本实现的代码示例 #

通过Swift的条件编译或运行时版本检查，可以实现API完全一致的AtomicThing类：

方式1：编译时分版本（适用于打包独立版本包） #

如果需要为macOS 14和15分别编译独立的二进制包，直接用编译时条件指令即可：

import Foundation

// 假设Thing是你的核心数据类型
struct Thing: Sendable { /* 你的类型定义 */ }

#if os(macOS) && macos(>=15.0)
class AtomicThing: Sendable {
    private let mutex = Mutex<Thing>()
    
    // 统一的公共API
    func modify(_ block: (inout Thing) -> Void) {
        mutex.withLock { block(&$0) }
    }
    
    func get() -> Thing {
        mutex.withLock { $0 }
    }
}
#else
class AtomicThing: @unchecked Sendable {
    private let lock = NSLock()
    private var underlyingThing: Thing
    
    init(initialThing: Thing) {
        self.underlyingThing = initialThing
    }
    
    // 与高版本完全一致的公共API
    func modify(_ block: (inout Thing) -> Void) {
        lock.lock()
        defer { lock.unlock() }
        block(&underlyingThing)
    }
    
    func get() -> Thing {
        lock.lock()
        defer { lock.unlock() }
        return underlyingThing
    }
}
#endif

方式2：运行时分版本（适用于单一二进制兼容多系统） #

如果要打包单一二进制同时支持macOS 14和15，用运行时版本检查切换锁实现：

import Foundation

struct Thing: Sendable { /* 你的类型定义 */ }

class AtomicThing: Sendable {
    private let lockImpl: AnyObject
    private var thing: Thing
    
    init(initialThing: Thing) {
        self.thing = initialThing
        if #available(macOS 15.0, *) {
            self.lockImpl = Mutex<Thing>(wrapping: thing)
        } else {
            self.lockImpl = NSLock()
        }
    }
    
    func modify(_ block: (inout Thing) -> Void) {
        if #available(macOS 15.0, *) {
            (lockImpl as! Mutex<Thing>).withLock { block(&$0) }
        } else {
            (lockImpl as! NSLock).lock()
            defer { (lockImpl as! NSLock).unlock() }
            block(&thing)
        }
    }
    
    func get() -> Thing {
        if #available(macOS 15.0, *) {
            return (lockImpl as! Mutex<Thing>).withLock { $0 }
        } else {
            (lockImpl as! NSLock).lock()
            defer { (lockImpl as! NSLock).unlock() }
            return thing
        }
    }
}

二、归档与打包问题解答 #

• Xcode默认归档只会生成单一版本的包，不会自动拆分多系统版本。如果需要生成独立包，有两种方案：
  • 多目标配置：在项目中创建两个目标，分别设置部署目标为macOS 14和15，各自编译对应的代码分支后分别归档。
  • XCFramework打包：通过xcodebuild命令分别编译不同版本的二进制，再合并成XCFramework，分发时可自动适配不同系统版本。
• 若选择单一二进制兼容多系统，直接用普通归档流程即可，运行时会自动匹配对应的实现逻辑。

三、关键注意事项 #

• 旧版本中@unchecked Sendable不会由编译器验证线程安全性，需确保NSLock完全保护了所有对Thing的访问，保证类型本身的线程安全。
• 必须在macOS 14和15的测试环境下分别验证API行为一致，避免出现版本特异性bug。
• 未来放弃macOS 14支持时，只需删除旧版本代码分支即可，无需修改公共API，迁移成本极低。

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