Xcode 14：WatchKit App未包含WatchKit Extensions问题求助

核心问题分析 #

你犯了两个关键错误：一是可能未正确创建WatchKit Extension目标（仅创建了Watch App），二是错误地将Extension的Info.plist配置加到了Watch App的plist文件中。

分步修复方案 #

1. 确认并创建WatchKit Extension目标

   • 打开Xcode项目，点击左侧项目文件→切换到Targets标签页，检查是否存在带Extension后缀的WatchOS目标（比如YourApp WatchKit Extension）。
   • 如果没有，点击左上角+添加Target，选择WatchOS分类下的WatchKit App，新版Xcode默认会同时生成Watch App和Extension两个目标，无需额外勾选特殊选项。

2. 修正Info.plist配置

   • Watch App的Info.plist：只保留WKWatchKitApp键，值设为YES，删除你添加的NSExtension字典——这个配置属于Extension，放在这里会导致冲突。
   • WatchKit Extension的Info.plist：确保包含以下配置（如果缺失则手动添加）：

     <key>NSExtension</key>
     <dict>
         <key>NSExtensionPointIdentifier</key>
         <string>com.apple.watchkit</string>
         <key>NSExtensionPrincipalClass</key>
         <string>$(PRODUCT_MODULE_NAME).ExtensionDelegate</string>
     </dict>
     

     其中NSExtensionPrincipalClass指向你的Extension代理类，用$(PRODUCT_MODULE_NAME)可自动适配项目模块名。

3. 检查Target依赖与嵌入配置

   • 主iOS App Target：
     • 进入Build Phases→Target Dependencies，添加你的Watch App目标。
     • 进入Build Phases→Embed Watch Content，选择你的Watch App目标，确保嵌入方式为默认的正确选项（非Do Not Embed）。
   • Watch App Target：
     • 进入Build Phases→Target Dependencies，添加你的WatchKit Extension目标。

4. 验证Bundle ID规则

   • 主App：com.yourcompany.yourapp
   • Watch App：com.yourcompany.yourapp.watchkitapp（主App ID + .watchkitapp）
   • Watch Extension：com.yourcompany.yourapp.watchkitapp.watchkitextension（Watch App ID + .watchkitextension）
     三者必须保持层级关联，不能随意命名。

5. 清理并重新构建

   • 按下Cmd+Shift+K清理构建文件夹，再按Cmd+B重新构建项目，之后尝试归档验证。

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