Xcodegen生成自源码Framework无umbrella header，依赖模块报错

问题场景 #

用Xcodegen创建包含MySecrets框架目标和MyApp应用目标的项目，配置如下：

targets:
  MySecrets:
    platform: iOS
    type: framework
    settings:
      PRODUCT_BUNDLE_IDENTIFIER: com.kapucha.mysecrets
    sources:
      - MySecrets
    preBuildScripts:
      - script: sh generate_secrets.sh
        name: Generate Secrets file for MySecrets
        basedOnDependencyAnalysis: true
        inputFiles:
          - $(SRCROOT)/generate_secrets.sh
        outputFiles:
          - $(SRCROOT)/MySecrets/Secrets.swift
    info:
      path: MySecrets/Info.plist
  MyApp:
    platform: iOS
    type: application
    dependencies:
      - target: MySecrets
        embed: true
        codeSign: true

MyApp依赖MySecrets，后者通过预构建脚本生成唯一源码文件Secrets.swift，首次构建前MySecrets目录无Swift文件。构建时Secrets.swift能正常生成，但MySecrets会报警告：

warning: DEFINES_MODULE was set, but no umbrella header could be found to generate the module map (in target 'MySecrets' from project 'MyApp')

紧接着MyApp编译报错：No such module 'MySecrets'，只有提前生成Secrets.swift并重启Xcode才能正常构建。需要解决干净状态下的构建问题，确保源码仅在输入/输出变更时生成，且生成后模块能正常被依赖使用。

原因分析 #

首次构建时，MySecrets目录无任何Swift/ObjC源码，Xcode会默认按纯资源框架处理，不会生成Swift模块所需的模块映射文件。即便预构建脚本生成了Secrets.swift，Xcode的依赖分析在首次构建周期内无法实时更新目标的源码集合，导致模块无法被MyApp识别。

解决方案 #

1. 显式指定框架为纯Swift类型 #

修改MySecrets的Xcodegen配置，添加纯Swift模块相关设置，避免Xcode触发ObjC伞头文件的查找逻辑：

targets:
  MySecrets:
    platform: iOS
    type: framework
    settings:
      PRODUCT_BUNDLE_IDENTIFIER: com.kapucha.mysecrets
      SWIFT_INSTALL_OBJC_HEADER: NO
      DEFINES_MODULE: YES
    # 其他原有配置保持不变

2. 添加占位源码确保首次模块结构生成 #

在MySecrets目录下创建一个空的Placeholder.swift文件，仅作为首次项目生成时的源码占位，让Xcode提前生成Swift模块的基础结构：

// Placeholder.swift - 仅用于触发Xcode生成Swift模块配置，无实际业务逻辑

3. 强化预构建脚本的依赖分析 #

确保预构建脚本的inputFiles包含所有触发脚本执行的依赖文件（比如如果generate_secrets.sh依赖.env配置文件，也要加入），保证脚本仅在依赖变更时执行：

preBuildScripts:
  - script: sh generate_secrets.sh
    name: Generate Secrets file for MySecrets
    basedOnDependencyAnalysis: true
    inputFiles:
      - $(SRCROOT)/generate_secrets.sh
      - $(SRCROOT)/.env # 示例：如果有依赖配置文件需添加
    outputFiles:
      - $(SRCROOT)/MySecrets/Secrets.swift

4. 验证构建流程 #

• 执行xcodebuild clean或在Xcode中按Cmd+Shift+K清理项目
• 删除Secrets.swift文件回到干净状态
• 直接构建MyApp，此时预构建脚本会自动生成Secrets.swift，MySecrets框架可正常编译，MyApp能正确导入模块

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