构建xcframework未包含依赖包：如何整合第三方Swift Package？

问题描述 #

我有一个依赖某开源包的简易Swift Package，本地集成到iOS应用时能正常运行（包含依赖包功能），但打包成XCFramework后，集成时出现「No such module <dependant_package>」错误。我的Package.swift代码如下：

// swift-tools-version: 5.7
// The swift-tools-version declares the minimum version of Swift required to build this package.

import PackageDescription

let package = Package(
    name: "MyPackage",
    platforms: [
        .iOS(.v13) // Specify the desired iOS version
    ],
    products: [
        // Products define the executables and libraries a package produces, and make them visible to other packages.
        .library(
            name: "MyPackage",
            targets: ["MyPackage"]),
    ],
    dependencies: [
        // Dependencies declare other packages that this package depends on.
        // .package(url: /* package url */, from: "1.0.0"),
        .package(url: "https://github.com/example/dependant.git", branch: "master")
    ],
    targets: [
        // Targets are the basic building blocks of a package. A target can define a module or a test suite.
        // Targets can depend on other targets in this package, and on products in packages this package depends on.
        .target(
            name: "MyPackage",
            dependencies: [
                .product(name: "dependant", package: "dependant")
            ]
        ),
        .testTarget(
            name: "MyPackageTests",
            dependencies: ["MyPackage"]),
    ]
)

解决方案 #

方式一：静态链接依赖（推荐） #

默认情况下Swift Package可能采用动态链接依赖，导致XCFramework不包含依赖代码，集成时找不到模块。修改配置让依赖静态链接，将代码合并到你的XCFramework中：

1. 修改Package.swift配置
   在target中添加链接设置，强制静态链接依赖：

   .target(
       name: "MyPackage",
       dependencies: [
           .product(name: "dependant", package: "dependant")
       ],
       linkerSettings: [
           .linkedLibrary("dependant", .when(platforms: [.iOS]))
       ]
   )
   

   或者如果依赖包本身支持静态编译，可直接在依赖声明时指定类型：

   .package(url: "https://github.com/example/dependant.git", branch: "master", product: "dependant", type: .static)
   

2. 重新构建XCFramework
   执行以下命令，确保覆盖真机和模拟器架构，同时开启分发模式：

   # 归档真机版本
   xcodebuild archive \
       -scheme MyPackage \
       -destination "generic/platform=iOS" \
       -archivePath "./build/MyPackage-iOS.xcarchive" \
       SKIP_INSTALL=NO \
       BUILD_LIBRARY_FOR_DISTRIBUTION=YES
   
   # 归档模拟器版本
   xcodebuild archive \
       -scheme MyPackage \
       -destination "generic/platform=iOS Simulator" \
       -archivePath "./build/MyPackage-iOSSimulator.xcarchive" \
       SKIP_INSTALL=NO \
       BUILD_LIBRARY_FOR_DISTRIBUTION=YES
   
   # 合并为XCFramework
   xcodebuild -create-xcframework \
       -framework "./build/MyPackage-iOS.xcarchive/Products/Library/Frameworks/MyPackage.framework" \
       -framework "./build/MyPackage-iOSSimulator.xcarchive/Products/Library/Frameworks/MyPackage.framework" \
       -output "./build/MyPackage.xcframework"
   

方式二：一同分发依赖的XCFramework #

如果依赖包不支持静态链接，需要将依赖包也打包成XCFramework，和你的包一起提供给集成方：

1. 单独构建依赖包的XCFramework（步骤同上述构建命令，替换对应scheme和名称）
2. 修改你的Package.swift，将远程依赖改为本地XCFramework依赖：

   dependencies: [
       .package(path: "./Dependant.xcframework")
   ]
   

3. 重新构建你的XCFramework，集成时需要同时导入你的XCFramework和依赖的XCFramework

关键注意事项 #

• 必须开启BUILD_LIBRARY_FOR_DISTRIBUTION=YES，这是构建可分发二进制包的核心参数，保证模块接口稳定且能被正确识别。
• 提前确认依赖包的编译类型，如果是动态库，静态链接可能引发冲突，此时只能选择方式二。
• 构建时要覆盖所有需要的架构（真机+模拟器），避免集成时出现架构缺失导致的运行错误。

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