SPM中UIColor资源无法支持暗黑模式相关问题咨询

首先明确核心结论：SPM 资源目录下的 .xcassets 颜色集本身完全支持暗黑模式、高对比度等所有系统外观适配，不存在不支持暗黑模式的问题。你遇到的仅能读取到浅色模式色值的问题属于配置错误，常见诱因如下：

• Package.swift 资源声明错误：没有将资源声明为 process 类型，或资源未放在对应 target 的指定资源目录下，导致编译阶段 Xcode 没有保留颜色集的多外观配置，仅提取了默认的 Any 外观色值
• Storyboard 引用时未指定正确的包：SPM 包内的资源默认归属对应包的独立 bundle，Storyboard 选色时默认读取主工程 main bundle 的资源，没有读取 SPM 包内的颜色配置，自然无法触发暗黑模式适配
• 代码调用时未指定正确的 bundle：如果手动通过名字读取颜色，没有传入 SPM 包对应的 bundle，也会默认读取主工程资源，导致适配失效

问题修复方案 #

1. 修正 SPM 资源配置 #

确认 Package.swift 中对应 target 的资源声明格式正确，示例配置如下：

.target(
    name: "你的SPM库名称",
    resources: [
        .process("Resources") // 填你存放颜色集的目录路径
    ]
)

2. 修正 Storyboard 颜色引用逻辑 #

在 Storyboard 的颜色选择下拉菜单中点击 Other，弹出颜色面板后切换到颜色集列表页，顶部的 Bundle 下拉栏选择对应 SPM 包，再选中对应颜色即可完成带包的引用。

3. 修正代码颜色调用逻辑 #

优先使用 Swift 5.3+ 自动生成的资源调用 API，不需要手动处理 bundle：

// 自动关联SPM包bundle，自带所有外观适配能力
let customColor = UIColor(resource: .你的颜色名称)

如果需要手动读取，写法如下：

let spmBundle = Bundle.module
let customColor = UIColor(named: "你的颜色名称", in: spmBundle, compatibleWith: nil)

SPM 资源系统的设计意义 #

• 实现资源与代码的绑定分发：组件化开发场景下，UI组件依赖的颜色、图片、本地化字符串等资源可以和代码一起打包在SPM包内，不需要主工程额外手动导入资源，避免资源冲突、漏导入等问题
• 统一资源版本管理：资源随SPM包的版本迭代同步更新，不会出现主工程资源版本和代码版本不匹配的问题
• 完全对齐Xcode原生资源能力：支持颜色集多外观适配、图片暗黑模式适配、本地化、Core Data模型等所有Xcode支持的资源类型，能力和主工程内的资源完全一致

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