如何在Swift Package Manager中添加二进制框架依赖？求可行方案

Hey there! I totally get how frustrating it is to hit this roadblock with SPM and binary frameworks—let's walk through some practical fixes for that package has an unsupported layout, binary.framework/module.modulemap should be inside the 'include' directory error you're seeing.

1. Adjust Your Directory Layout to Match SPM's Requirements #

SPM has strict rules about where it expects to find module maps for binary frameworks. Here's how to fix the layout:

• Create a new include folder at the root of your Swift package (same level as your Package.swift file).
• Move your module.modulemap file into this include directory. Your final structure should look something like this:

  MySwiftPackage/
  ├── Package.swift
  ├── include/
  │   └── module.modulemap
  ├── MyBinaryFramework.framework/
  └── Sources/
      └── MyPackageSource/
  

• Update your Package.swift to correctly reference the binary target. Make sure the path points directly to your framework:

  let package = Package(
      name: "MySwiftPackage",
      products: [
          .library(name: "MySwiftPackage", targets: ["MyPackageSource", "MyBinaryFramework"]),
      ],
      targets: [
          .target(name: "MyPackageSource", dependencies: ["MyBinaryFramework"]),
          .binaryTarget(
              name: "MyBinaryFramework",
              path: "./MyBinaryFramework.framework"
          ),
      ]
  )
  

  SPM will automatically look in the include directory for the module map when processing the binary target.

2. Switch to Using an XCFramework (Recommended) #

If adjusting the directory feels clunky, switching to an XCFramework is a more robust solution—SPM has first-class support for XCFrameworks without extra layout hoops. Here's how:

• Convert your existing framework to an XCFramework using Xcode's command-line tool. Run this in your terminal (replace placeholders with your actual paths):

  xcodebuild -create-xcframework \
      -framework /path/to/MyBinaryFramework.framework \
      -output /path/to/MyBinaryFramework.xcframework
  

• Update your Package.swift to reference the XCFramework instead:

  .binaryTarget(
      name: "MyBinaryFramework",
      path: "./MyBinaryFramework.xcframework"
  )
  

  This avoids the module map layout issue entirely because XCFrameworks encapsulate all platform-specific binaries and their module maps internally.

3. Temporary Workaround: Local Git Repository for the Framework #

If you need a quick fix while waiting for SPM's binary support to improve, you can wrap your binary framework in a local Git repository and reference it as a dependency:

• Initialize a Git repo inside your framework's folder, commit the files (including the adjusted include directory if you went with option 1).
• In your main package's Package.swift, add it as a local dependency:

  dependencies: [
      .package(path: "../MyBinaryFrameworkRepo")
  ],
  

As you mentioned, the SPM community does have proposals for more flexible binary framework support, but there's no public timeline for when those will be rolled out. For now, the above methods should get you up and running.

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