WatchOS Complication无法加载图片问题求助

一、排查图片加载失败的问题及修复 #

1. 检查资源配置细节 #

• 确认图片是放在Watch App Target的Assets目录里，不是仅存于iOS主App的Assets中——Complication属于WatchOS模块，资源必须归属对应目标。
• 调整Asset的缩放设置：要么给图片添加1x、2x、3x版本（对应145px、290px、435px），要么把Asset的"Scales"选项设为"Single Scale"（仅用145px图的情况）。
• 核对图片文件名的大小写，WatchOS对文件名大小写敏感，必须和代码里的字符串完全匹配。

2. 优化视图布局约束 #

Complication有固定尺寸限制，直接用Image可能因无布局规则导致不显示，给Image加上布局修饰符：

struct ComplicationsEntryView : View {
    var entry: Provider.Entry

    var body: some View {
        Image("ComplicationImage")
            .resizable()
            .scaledToFit()
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .clipped()
    }
}

二、实现Complication点击启动应用功能 #

要让Complication能唤起App，需在数据源中配置启动行为，具体步骤如下：

1. 更新Complication Provider代码 #

在你的Provider类（Complication数据源）中，确保getCurrentTimelineEntry方法返回包含启动行为的时间线条目：

class Provider: ComplicationDataSource {
    // 其他已实现方法...

    func getCurrentTimelineEntry(for complication: CLKComplication, withHandler handler: @escaping (CLKComplicationTimelineEntry?) -> Void) {
        let entryView = ComplicationsEntryView(entry: SimpleEntry(date: Date()))
        let template = CLKComplicationTemplateGraphicCircularView(entryView)
        // 配置启动App的行为
        let launchActivity = CLKComplicationActivity(userInfo: nil, appLaunchURL: nil)
        let timelineEntry = CLKComplicationTimelineEntry(date: Date(), template: template, complicationActivity: launchActivity)
        handler(timelineEntry)
    }

    // 关闭时间旅行（不需要的话）
    func getSupportedTimeTravelDirections(for complication: CLKComplication, withHandler handler: @escaping (CLKComplicationTimeTravelDirections) -> Void) {
        handler(.none)
    }
}

2. 确认项目配置 #

• 在Watch App的Info.plist中，添加WKComplicationPrincipalClass键，值设为你的Complication控制器类名。
• 在Apple Watch App的配置页面，检查"Supported Families"是否勾选了你正在使用的表盘样式（比如圆形、模块化等）。

三、测试建议 #

• 用Cmd+Shift+K清理Xcode缓存，重新构建并安装到手表。
• 模拟器测试时，选择匹配的WatchOS版本，且表盘样式要和你配置的Complication家族一致。

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