WatchOS Complication displayName不显示，如何自定义显示名称？

以下是针对该问题的具体排查和解决步骤：

1. 确认Widget Extension的Info.plist配置正确性 #

确保你的Widget Extension的Info.plist包含完整且正确的Complication配置：

• 展开NSExtension -> NSExtensionAttributes
  • 验证CLKComplicationPrincipalClass的值为你的Complication Provider类的完整类名（例如$(PRODUCT_MODULE_NAME).ComplicationDataSource）
  • 确认CLKComplicationSupportedFamilies数组包含你实际使用的所有Complication样式（如circularSmall、modularLarge等）

2. 正确在getConfiguration方法中设置名称 #

configurationDisplayName和description必须在getConfiguration方法返回的对应家族配置对象中设置，示例代码如下：

import WidgetKit
import ClockKit

class ComplicationDataSource: NSObject, CLKComplicationDataSource {
    func getConfiguration(for complication: CLKComplication, withHandler handler: @escaping (CLKComplicationConfiguration?) -> Void) {
        // 根据Complication家族匹配对应的配置类
        switch complication.family {
        case .circularSmall:
            let config = CLKComplicationConfigurationCircularSmall()
            config.configurationDisplayName = "我的自定义组件"
            config.description = "实时显示核心数据"
            handler(config)
        case .modularLarge:
            let config = CLKComplicationConfigurationModularLarge()
            config.configurationDisplayName = "快捷信息组件"
            config.description = "一键查看关键内容"
            handler(config)
        // 其他家族的配置逻辑...
        default:
            handler(nil)
        }
    }

    // 其他必填方法实现...
}

注意：不同的Complication家族对应不同的CLKComplicationConfiguration子类，必须严格匹配对应家族设置，否则配置不会生效。

3. 清理缓存并重新安装 #

缓存可能导致配置未更新，执行以下操作：

• 删除Apple Watch上的目标应用（真机测试场景）
• 在Xcode中执行Product > Clean Build Folder清理构建缓存
• 重新运行项目，将应用重新安装到Watch设备或模拟器

4. 检查本地化配置（若涉及多语言） #

如果使用了本地化功能，确保：

• 在对应语言的Localizable.strings文件中添加了名称和描述的本地化字符串
• 代码中通过NSLocalizedString正确引用，例如：

  config.configurationDisplayName = NSLocalizedString("Complication_Display_Name", comment: "表盘组件显示名称")
  

5. 验证Widget Extension的Bundle配置 #

检查Widget Extension的Info.plist中的CFBundleDisplayName字段，若该字段未设置，系统可能会 fallback 到主应用名称。可以给Widget Extension单独设置一个合适的显示名称，但核心自定义名称仍需依赖configurationDisplayName的设置。

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