SPM包中基于构建配置设置XCFramework路径的问题

问题原因 #

Package.swift本质是Swift脚本，在SPM解析包结构时就会执行，而你在Xcode项目构建设置中添加的-DDEBUG是传递给目标代码的编译标志，不会影响Package.swift脚本的执行环境，所以#if DEBUG在这里完全不会生效。

可行解决方案 #

方法1：通过环境变量控制 #

在Package.swift中读取系统环境变量，根据变量值选择不同的XCFramework路径，这是最灵活的方案。

修改后的Package.swift代码：

import PackageDescription
import Foundation

// 读取环境变量判断是否为Debug配置
let isDebug = ProcessInfo.processInfo.environment["USE_DEBUG_XCFRAMEWORK"] == "true"

let package = Package(
    name: "flutter_module_ios",
    products: [
        .library(
            name: "flutter_module_ios",
            targets: ["App", "Flutter"])
    ],
    targets: [
        .binaryTarget(
            name: "App",
            path: isDebug ? "Debug/App.xcframework" : "Release/App.xcframework"
        ),
        .binaryTarget(
            name: "Flutter",
            path: isDebug ? "Debug/Flutter.xcframework" : "Release/Flutter.xcframework"
        )
    ]
)

配置环境变量的方式：

• 命令行构建：
  Debug构建时：

  USE_DEBUG_XCFRAMEWORK=true swift build
  

  或者Xcode命令行构建：

  USE_DEBUG_XCFRAMEWORK=true xcodebuild -scheme flutter_module_ios -configuration Debug build
  

• Xcode GUI构建：
  1. 打开项目的Scheme（Product > Scheme > Edit Scheme）
  2. 选择Build选项卡，点击左上角的+添加一个Run Script预动作
  3. 在脚本内容中输入：export USE_DEBUG_XCFRAMEWORK=true（仅在Debug配置下启用这个预动作，点击右侧的Build Configuration选择Debug）
  4. 对于Release配置，重复上述步骤，输入export USE_DEBUG_XCFRAMEWORK=false并选择Release配置

方法2：维护独立的包变体（备选） #

如果环境变量的方式不符合你的工作流，可以维护两个独立的SPM包结构：

• 一个专门存放Debug版本的XCFramework，对应单独的分支或子目录
• 另一个存放Release版本的XCFramework
  然后在项目中根据构建配置切换依赖的包路径或分支。不过这种方式需要额外的维护成本，不如环境变量灵活。

注意事项 #

• SPM会缓存包解析结果，如果你修改了环境变量，可能需要清理Xcode缓存（File > Packages > Reset Package Caches）才能生效
• 确保环境变量在SPM解析Package.swift之前就已设置，Xcode的预动作要放在Build阶段之前执行

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