Flutter iOS含Device Activity Extension归档失败：缺少Bundle Identifier

1. 添加Device Activity Report Extension后归档报错的具体原因 #

• Build Phase顺序异常：调整Build Phase顺序后，可能导致Extension的bundle identifier生成或嵌入时机错位——归档流程对产物完整性的校验比设备编译更严格，若Extension的构建产物未在「Embed ExtensionKit Extensions」阶段前正确生成包含bundle ID的文件，就会触发报错。
• 归档模式下的签名/配置不匹配：设备编译可能使用调试签名配置，但归档用Release配置，若Extension的Provisioning Profile、Team ID或Bundle ID在Release模式下配置有误（比如Extension的Bundle ID不是主应用的子ID），归档校验时会识别不到合法的bundle identifier。
• Embed阶段配置错误：「Embed ExtensionKit Extensions」构建阶段的输入路径或输出配置异常，导致归档时Extension的bundle信息未被正确嵌入主应用的归档包中。
• Flutter构建流程与原生Extension冲突：Flutter的flutter build ios脚本可能在归档前修改了项目配置，覆盖了Extension的bundle ID相关设置，或者Extension的构建未被Flutter的归档流程正确触发。

2. 确保Extension正确关联嵌入主应用以完成归档的步骤 #

• 修复Build Phase顺序：
  • 针对Extension目标：确保「Compile Sources」「Link Binary With Libraries」「Copy Bundle Resources」按正常顺序执行，无缺失或错位。
  • 针对主应用（Runner）目标：将「Embed ExtensionKit Extensions」放在「Copy Bundle Resources」之后、「Post Actions」之前，保证Extension构建完成后再被嵌入主应用。
• 统一签名与配置：
  • 确认Extension的Bundle ID是主应用ID的合法子ID（例如主应用为com.example.myapp，Extension需为com.example.myapp.devicereport），且两者Team ID一致。
  • 在Xcode的「Edit Scheme」中，将归档模式下主应用和Extension的Build Configuration统一设为Release，并使用相同的Provisioning Profile。
• 验证归档流程的目标包含：在Xcode Scheme的归档配置中，确保Extension目标被勾选为「Include in Archive」，避免归档时忽略Extension。
• 排查归档日志：通过Xcode的「Window > Organizer」查看归档的详细日志，定位到报错的具体阶段（比如Extension构建失败、嵌入阶段缺失文件），精准修复问题。
• 清理后分步构建：先执行flutter clean、Xcode的「Product > Clean Build Folder」，然后先单独构建Extension目标，再执行主应用的归档操作。

3. Flutter集成ExtensionKit扩展的特殊配置要求 #

• Bundle ID规则：Extension的Bundle ID必须是主应用Bundle ID的后缀形式，且两者共享同一个Team ID，否则无法通过苹果的签名与归档校验。
• Info.plist配置：
  • 主应用的Info.plist需添加Extension的声明：

    <key>NSExtensions</key>
    <array>
      <dict>
        <key>NSExtensionAttributes</key>
        <dict>
          <key>NSExtensionPointIdentifier</key>
          <string>com.apple.deviceactivityreport</string>
        </dict>
        <key>NSExtensionMainStoryboard</key>
        <string>MainInterface</string>
        <key>NSExtensionPointIdentifier</key>
        <string>com.apple.deviceactivityreport</string>
      </dict>
    </array>
    

  • Extension的Info.plist要配置正确的NSExtensionPointIdentifier（对应ScreenTime的com.apple.deviceactivityreport），以及必要的权限描述（如NSFamilyControlUsageDescription）。
• 进程间通信配置：若Extension需与Flutter主应用交互，必须配置App Groups：在主应用和Extension的Capabilities中开启App Groups，使用同一个Group ID，通过UserDefaults或FileManager共享数据（Extension无法直接调用Flutter方法）。
• 避免Flutter脚本覆盖配置：尽量通过Xcode手动管理Extension的签名、Build Phase和Info.plist配置，不要将Extension的配置写入Flutter的Info.plist或Podfile中，防止flutter build ios命令覆盖原生配置。
• 权限与授权：主应用和Extension都需在Provisioning Profile中包含Family Control权限，且Info.plist中添加对应的权限使用描述，否则归档或上架时会被苹果拒绝。

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