Kotlin多平台项目集成MLKit时出现图像类型不匹配问题

问题根源 #

这个类型不匹配问题出在Kotlin/Native的CocoaPods绑定机制上：

• objcnames.protocols下的MLKCompatibleImageProtocol是Kotlin对Objective-C协议的自动绑定产物，而cocoapods.MLKitVision下的同名协议是CocoaPods框架直接生成的绑定。二者在Kotlin类型系统中被判定为不同类型，尽管底层对应同一个Objective-C协议。
• Swift中无此问题是因为Swift直接复用Objective-C的类型体系，不会出现这种命名空间拆分导致的类型割裂。

解决方案 #

方案1：手动实现类型转换扩展 #

通过扩展函数强制转换类型（底层是同一个Objective-C对象，转换安全），绕开Kotlin的类型检查：

import cocoapods.MLKitVision.MLKVisionImage
import objcnames.protocols.MLKCompatibleImageProtocol

// 扩展函数实现类型转换
fun MLKVisionImage.toMLKCompatibleImage(): MLKCompatibleImageProtocol {
    return this as MLKCompatibleImageProtocol
}

使用示例：

val visionImage = MLKVisionImage(didOutputSampleBuffer)
val barCodeResults = barcodeScanner.resultsInImage(visionImage.toMLKCompatibleImage())

方案2：修复官方依赖导入问题 #

你提到官方推荐的pod("GoogleMLKit/BarcodeScanning")无法使用，大概率是版本或镜像问题，尝试以下步骤：

1. 在build.gradle.kts中指定稳定版本替换依赖：

pod("GoogleMLKit/BarcodeScanning") {
    version = "3.2.0" // 锁定兼容Xcode 15.4的稳定版本
}

2. 清理缓存并重新生成绑定：
   • 删除项目根目录下的build文件夹
   • 进入ios目录执行pod deintegrate && pod install
   • 重新同步Gradle项目

方案3：调整Kotlin绑定生成配置 #

在build.gradle.kts的kotlin.native.cocoapods块中添加配置，强制统一协议的绑定路径：

kotlin {
    ios {
        binaries.framework {
            baseName = "YourFrameworkName"
        }
        cocoapods {
            pod("MLKitVision")
            pod("MLKitBarcodeScanning")
            // 添加以下配置统一协议绑定
            generateInteropBinding = true
            extraOpts += "-Xobjc-protocols-as-interfaces"
        }
    }
}

该配置会让Kotlin将Objective-C协议生成为统一的接口类型，避免出现objcnames.protocols的拆分。

补充建议 #

如果以上方案无效，建议：

• 更新Kotlin到最新稳定版（Kotlin 2.x部分版本对CocoaPods协议绑定存在bug）
• 确保CocoaPods版本≥1.14.0（适配Xcode 15.4的最低版本要求）

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