Apple Watch Widget Complications异常：添加后仅显示黑圈求助

我正在给现有Apple Watch应用添加Widget Complications，已经添加了WatchOS Widget Extension，并按照指引创建了仅用于从表盘启动应用的静态非更新Complications。Complications在预览中显示正常，但添加到表盘后无法显示图片，仅呈现黑圈。

以下是Widget Extension中的代码：

import WidgetKit
import SwiftUI

struct Provider: TimelineProvider {
    
    func getSnapshot(in context: Context, completion: @escaping (SimpleEntry) -> Void) {
    }
    
    func getTimeline(in context: Context, completion: @escaping (Timeline<SimpleEntry>) -> Void) {
    }
    
    func placeholder(in context: Context) -> SimpleEntry {
        SimpleEntry(date: Date())
    }
    
    func snapshot(in context: Context) async -> SimpleEntry {
        SimpleEntry(date: Date())
    }
}

struct SimpleEntry: TimelineEntry {
    let date: Date
//    let configuration: ConfigurationAppIntent
}

struct TrapScores_WidgetsEntryView : View {
    
    @Environment(\.widgetFamily) var widgetFamily
    var entry: Provider.Entry
    
    var body: some View {
        
        switch widgetFamily {
        case .accessoryCorner:
            ComplicationCorner()
        case .accessoryCircular:
            ComplicationCircular()
        case .accessoryRectangular:
            Text("TrapScores")
        case .accessoryInline:
            Text("TrapScores")
        @unknown default:
            //mandatory as there are more widget families as in lockscreen widgets etc
            Text("AppIcon")
        }
    }
}

@main
struct TrapScores_Widgets: Widget {
    let kind: String = "TrapScores_Complications"
    
    var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            TrapScores_WidgetsEntryView(entry: entry)
                .containerBackground(.fill.secondary, for: .widget)
        }
        .configurationDisplayName("TrapScores")
        .description("This will launch TrapScores App")
        .supportedFamilies([.accessoryCorner, .accessoryCircular])
    }
}
    
    struct ComplicationCircular: View {
        var body: some View {
            Image("Graphic Circular")
                .widgetAccentable(true)
                .unredacted()
        }
    }
    struct ComplicationCorner: View {
        var body: some View {
            Image("Graphic Circular")
                .widgetAccentable(true)
                .unredacted()
        }
    }
    
    #Preview(as: .accessoryCircular) {
        TrapScores_Widgets()
    } timeline: {
        SimpleEntry(date: .now)
    }

可能的原因及解决方法 #

1. 图片资源未关联到Widget Extension目标 #

预览正常但表盘不显示，最常见的原因是图片没有被包含进Widget Extension的资源包：

• 在Xcode中选中Graphic Circular图片，打开右侧检查器，在Target Membership区域勾选你的Widget Extension目标（如TrapScores_Widgets）。

2. 图片命名或格式问题 #

• 确认代码中的图片名称"Graphic Circular"与资源文件的名称完全一致，watchOS对资源名称的大小写和空格敏感；
• 确保图片格式适配watchOS，推荐使用PNG或SVG，同时提供对应1x、2x、3x的多倍图，匹配组件的尺寸要求。

3. 图片渲染模式问题 #

尝试强制保留图片原始颜色，避免系统自动适配主题导致异常：

Image("Graphic Circular")
    .renderingMode(.original)
    .widgetAccentable(true)
    .unredacted()

4. 时间线方法未正确实现 #

虽然是静态组件，但空的getTimeline方法可能导致组件初始化异常，补充基础实现：

func getTimeline(in context: Context, completion: @escaping (Timeline<SimpleEntry>) -> Void) {
    let entry = SimpleEntry(date: Date())
    let timeline = Timeline(entries: [entry], policy: .never)
    completion(timeline)
}

5. 清理缓存重新部署 #

• 删除模拟器/真机上的应用及组件；
• 执行Xcode清理操作（Cmd+Shift+K），重新编译部署项目。

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