SwiftUI中CALayer重绘时未使用应用主题而跟随系统主题

问题背景 #

在SwiftUI应用中已实现深色模式，为颜色、图片资源定义了多外观（Any、Light、Dark）。应用启动时读取系统主题，同时支持用户通过开关选择并保存自定义主题，通过ThemeManager.setTheme利用overrideUserInterfaceStyle设置主题。

但遇到以下异常：

• 视图首次加载时，onAppear中绘制的CALayer能正确使用用户设置的主题颜色
• 视图存活期间重绘包含有色子层的CALayer时，颜色会变为设备系统主题的样式，只有销毁视图重新打开后才恢复正常

问题代码片段：

// 设置CAShapeLayer的描边色
let wallLayer = CAShapeLayer()
wallLayer.strokeColor = theme.wallColor

// 设置CAShapeLayer的填充色
let shapeLayer = CAShapeLayer()
shapeLayer.fillColor = theme.floorColor

所有形状层添加到CALayer后，通过UIViewRepresentable嵌入SwiftUI视图。

问题原因 #

1. CGColor未实时更新：SwiftUI的Color转CGColor仅在视图初始化/onAppear时执行一次，后续主题切换后，CALayer不会自动重新获取最新主题对应的CGColor。
2. TraitCollection未被正确使用：直接将SwiftUI的Color转CGColor时，默认使用系统当前的traitCollection，而非用户通过overrideUserInterfaceStyle设置的自定义主题对应的traitCollection，导致重绘时颜色解析错误。
3. UIViewRepresentable未响应主题变化：主题切换时，UIViewRepresentable的updateUIView方法未被触发，无法通知底层CALayer更新颜色。

解决方案 #

步骤1：让ThemeManager支持主题变化通知 #

将ThemeManager改为ObservableObject，用@Published属性暴露当前主题，确保主题变化时SwiftUI视图能收到更新：

class ThemeManager: ObservableObject {
    static let shared = ThemeManager()
    
    @Published var currentTheme: Theme // Theme为自定义主题枚举（Light/Dark/System）
    
    func setTheme(_ theme: Theme) {
        currentTheme = theme
        // 处理overrideUserInterfaceStyle逻辑
        switch theme {
        case .light:
            UIApplication.shared.windows.first?.overrideUserInterfaceStyle = .light
        case .dark:
            UIApplication.shared.windows.first?.overrideUserInterfaceStyle = .dark
        case .system:
            UIApplication.shared.windows.first?.overrideUserInterfaceStyle = .unspecified
        }
        // 保存主题到UserDefaults的逻辑
    }
}

步骤2：在UIViewRepresentable中监听主题变化并更新CALayer #

在UIViewRepresentable中，通过@EnvironmentObject监听ThemeManager的变化，在updateUIView方法中重新设置CALayer的颜色，确保每次重绘都使用最新主题和正确的traitCollection：

struct CustomLayerView: UIViewRepresentable {
    @EnvironmentObject var themeManager: ThemeManager
    
    func makeUIView(context: Context) -> UIView {
        let view = UIView()
        // 初始化layer并添加到view
        let wallLayer = CAShapeLayer()
        let shapeLayer = CAShapeLayer()
        view.layer.addSublayer(wallLayer)
        view.layer.addSublayer(shapeLayer)
        // 将layer存储到coordinator，方便后续更新
        context.coordinator.wallLayer = wallLayer
        context.coordinator.shapeLayer = shapeLayer
        // 首次设置颜色
        updateLayerColors(for: view, coordinator: context.coordinator)
        return view
    }
    
    func updateUIView(_ view: UIView, context: Context) {
        // 主题变化时重新设置layer颜色
        updateLayerColors(for: view, coordinator: context.coordinator)
        // 触发重绘
        context.coordinator.wallLayer?.setNeedsDisplay()
        context.coordinator.shapeLayer?.setNeedsDisplay()
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    class Coordinator {
        var wallLayer: CAShapeLayer?
        var shapeLayer: CAShapeLayer?
    }
    
    private func updateLayerColors(for view: UIView, coordinator: Coordinator) {
        let theme = themeManager.currentTheme
        // 正确转换SwiftUI Color到CGColor：使用当前view的traitCollection（包含overrideUserInterfaceStyle）
        let wallUIColor = UIColor(theme.wallColor)
        let resolvedWallColor = wallUIColor.resolvedColor(with: view.traitCollection)
        coordinator.wallLayer?.strokeColor = resolvedWallColor.cgColor
        
        let floorUIColor = UIColor(theme.floorColor)
        let resolvedFloorColor = floorUIColor.resolvedColor(with: view.traitCollection)
        coordinator.shapeLayer?.fillColor = resolvedFloorColor.cgColor
    }
}

步骤3：注入ThemeManager到根视图 #

在应用根视图中注入ThemeManager，确保所有子视图能获取到主题实例：

@main
struct YourApp: App {
    @StateObject private var themeManager = ThemeManager.shared
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(themeManager)
        }
    }
}

关键要点说明 #

• 使用resolvedColor：UIColor.resolvedColor(with:)方法会根据传入的traitCollection（包含用户设置的overrideUserInterfaceStyle）解析出正确的颜色，避免使用系统默认主题。
• updateUIView触发更新：updateUIView是SwiftUI通知UIKit视图更新的核心方法，主题变化时（themeManager.currentTheme的@Published触发视图更新），该方法会被调用，此时重新设置layer颜色并触发重绘。
• 避免缓存CGColor：不要提前缓存CGColor，每次需要时都从当前主题和traitCollection重新转换，确保颜色始终与用户设置的主题一致。

内容的提问来源于stack exchange，提问作者József Ádám Punk