如何将双目标watchOS应用的WidgetKit扩展迁移至单目标架构？

问题根源 #

双目标watchOS应用中，WidgetKit扩展的Bundle ID格式为com.company.app.watchkitapp.watchkitextension.widgets；迁移到单目标后，Xcode 15会自动移除中间的.watchkitextension域，新Bundle ID变为com.company.app.watchkitapp.widgets。由于Widget的用户配置与Bundle ID强绑定，旧配置无法关联到新扩展，导致Widget显示空白，需要用户重新配置。手动改回旧Bundle ID会因不符合单目标下的Bundle ID层级规则（父应用前缀后存在多余层级）被系统拒绝安装。

可行解决方案 #

通过WidgetKit提供的迁移策略API，将旧Bundle ID关联的Widget配置自动迁移到新Bundle ID，无需用户重新操作：

1. 创建迁移策略类
   实现WidgetMigrationPolicy协议，指定旧Widget扩展的Bundle ID：

   import WidgetKit
   
   class LegacyWidgetMigrationPolicy: NSObject, WidgetMigrationPolicy {
       func oldBundleIDs(for widgetKind: String) -> [String] {
           // 替换为你旧Widget扩展的完整Bundle ID
           return ["com.company.app.watchkitapp.watchkitextension.widgets"]
       }
   }
   

2. 关联迁移策略到Widget配置
   在你的Widget结构体中，为WidgetConfiguration添加迁移策略：

   struct YourWidget: Widget {
       let kind: String = "YourWidget"
   
       var body: some WidgetConfiguration {
           // 根据你的Widget类型选择IntentConfiguration或StaticConfiguration
           IntentConfiguration(kind: kind, intent: ConfigurationIntent.self, provider: Provider()) { entry in
               YourWidgetEntryView(entry: entry)
           }
           .configurationDisplayName("你的Widget名称")
           .description("Widget描述")
           .migrationPolicy(LegacyWidgetMigrationPolicy()) // 绑定迁移策略
       }
   }
   

额外注意事项 #

• 若你的Widget依赖App Groups共享数据，请确保新扩展的App Groups配置与旧版本完全一致，避免数据源访问失败。
• 务必在安装了旧版双目标应用的设备上测试迁移流程，验证Widget配置是否正常迁移、显示是否恢复正常。

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