Kotlin MPP集成CocoaPods失败：无法构建SnowplowTracker模块Gradle同步异常

一、CocoaPods环境&缓存排查 #

• 执行pod repo update更新本地CocoaPods官方索引库，确认SnowplowTracker 1.2.x版本在索引中可正常拉取
• 进入iOS模块目录，执行pod deintegrate && rm Podfile.lock && rm -rf ~/Library/Caches/CocoaPods完全清理CocoaPods本地缓存，再重新执行pod install拉取依赖
• 打开生成的.xcworkspace工程，检查SnowplowTracker依赖的编译架构是否包含当前构建目标的架构（如arm64、x86_64模拟器架构），排除架构不兼容问题

二、Kotlin MPP cinterop配置修正 #

• 在cocoapods配置块中补充静态框架适配配置，SnowplowTracker默认提供静态库，需要显式声明：

cocoapods {
    ios.deploymentTarget = "12"
    summary = "Kaia tracking library"
    homepage = "https://github.com/KaiaHealth/kaia-tracking-library"
    authors = company
    // 新增以下配置
    isStatic = true
    framework {
        baseName = "KaiaTracking"
    }

    pod("SnowplowTracker") {
        version = "~> 1.2.0"
    }
}

• 在gradle.properties文件中添加kotlin.native.cinterop.verbose=true开启cinterop详细日志，重新构建后检查clang编译参数中是否包含SnowplowTracker的头文件路径，排除路径引用错误

三、Xcode&构建规则适配 #

如果近期Xcode有升级到14及以上版本，新的模块构建规则会导致旧版第三方Pod构建失败，在Podfile中添加以下post_install钩子强制适配配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == 'SnowplowTracker'
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
      end
    end
  end
end

• 执行pod --version确认当前CocoaPods版本，若版本高于1.12.0建议降级到1.11.3稳定版测试，高版本CocoaPods和Kotlin 1.5.x的cocoapods插件存在兼容性问题

四、全局缓存清理 #

• 执行rm -rf ~/.gradle/caches完全删除全局Gradle缓存，避免旧的cinterop构建产物残留导致冲突
• 使用命令行执行构建绕过IDE缓存：./gradlew assembleDebug --no-build-cache --no-configuration-cache，排除IntelliJ IDEA自身的同步缓存问题

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