KMM依赖集成CocoaPods的库时iOS链接找不到pod模块如何解决？

KMM 的 CocoaPods cinterop 机制生成的 klib 仅包含 Kotlin 到原生框架的绑定声明，不包含原生框架本身的二进制实现。将核心库发布到 Maven 时，上传的产物只有 Kotlin 编译产物（klib、jar 等）和对应框架的头文件/符号表，既不会携带依赖的原生 CocoaPods 框架，也不会自动传递原生框架的链接配置给下游依赖。你遇到的 ld: framework not found gRPC_ProtoRPC 报错就是链接阶段找不到对应原生框架的二进制文件导致的。

认知偏差纠正：你认为核心库的 iOS 产物包含 cinterop 处理后的 klib 就能满足下游依赖的全部需求，这是错误的。klib 只是跨语言调用的绑定层，原生依赖的二进制需要在最终链接的环境中单独提供。

你想要实现的核心库被下游 KMM 库依赖的逻辑是完全可行的，按照以下方案调整即可。

方案一：下游库显式对齐 CocoaPods 配置（推荐，适配绝大多数场景） #

你之前重新声明 pod 依赖没有生效，大概率是版本没有和核心库对齐，或是没有补充链接参数，按以下步骤配置即可：

1. 在第二个库的 cocoapods 配置块中，添加和核心库版本完全一致的 pod 依赖，确保 cinterop 生成的绑定和核心库完全兼容：

cocoapods {
    // 其余基础配置（比如 minimumDeploymentTarget 等）和核心库保持一致
    pod("gRPC/GRPCCore", grpcVersion) // grpcVersion 和核心库使用的版本完全相同
    pod("gRPC-ProtoRPC", grpcVersion)
    pod("Protobuf", "3.15.8")
}

2. 在第二个库的 framework 配置块中添加链接参数，同时确保 framework 的静态/动态属性和核心库对齐：

framework {
    baseName = "SecondSharedLib"
    export("first.shared.lib:1.0.0")
    // 新增配置开始
    isStatic = true // 如果核心库的 framework 是动态的则改为 false，和核心库保持一致
    linkerOpts += listOf(
        "-framework", "gRPC_ProtoRPC",
        "-framework", "GRPCCore",
        "-framework", "Protobuf"
    )
    // 新增配置结束
    xcf.add(this)
}

3. 如果第二个库最终生成的 xcframework 要提供给原生 iOS 工程使用，还需要在 iOS 工程的 Podfile 中同样添加上述版本一致的 pod 依赖。

方案二：核心库导出原生依赖配置（适合内部多团队共用场景） #

如果不想下游库每次都重复声明 pod 依赖，可以在核心库的构建脚本中，将原生依赖的版本、链接参数等信息作为自定义属性写入发布的 pom 文件中，下游库通过 Gradle 脚本自动读取这些参数并自动添加到构建配置中。该方案无需下游手动维护依赖配置，但是需要额外自定义构建逻辑，维护成本较高，适合内部核心库迭代的场景。

• 所有依赖核心库的 KMM 库、以及最终的 iOS 工程，CocoaPods 依赖的版本必须完全一致，否则会出现符号冲突、找不到符号等问题
• 如果使用静态 framework，不要在多个 KMM 库中重复生成同一个 pod 的 cinterop 绑定，否则会出现符号重复的报错
• 不要尝试将 CocoaPods 的原生框架打包进 KMM 的 framework 产物中，这会导致 iOS 端集成时出现类重复、安装包体积膨胀等问题，原生依赖统一由最终 iOS 工程的 Podfile 管理是最优方案。

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