已知问题

• Release 构建失败但 debug 正常 — 可能是 Android 端的混淆问题。原生 SDK 不能被混淆。查看 ProGuard/DexGuard 规则。

• 更新插件后 pod install 失败 — 删除 ios/Podfile.lock 并从 ios/ 目录重新运行 pod install。

• 使用 Xcode 16 分发应用时出现 Bitcode 错误 — 在 Xcode 16 正式发布后（2024 年 9 月 17 日），由于使用 CocoaPods 时两个内部依赖（DeviceProfiling 和 UnicoSdkLogger）中存在 bitcode，向 App Store 分发可能被阻止。在永久修复推出之前，请在您的 ios/Podfile 中应用以下解决方案：

post_install do |installer|
  bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
  def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
    framework_path = File.join(Dir.pwd, framework_relative_path)
    command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
    puts "Stripping bitcode: #{command}"
    system(command)
  end

  framework_paths = [
    "Pods/unicocheck-ios/DeviceProfiling.xcframework/ios-arm64/DeviceProfiling.framework/DeviceProfiling",
    "Pods/unicocheck-ios/UnicoSdkLogger.xcframework/ios-arm64/UnicoSdkLogger.framework/UnicoSdkLogger"
  ]

  framework_paths.each do |framework_relative_path|
    strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
  end
end

如果 post_install do |installer| 不存在，请在最后一个 end 之前添加。

来源： Bitrise、Xcode 16 发行说明、Stack Overflow。

• 通过 platform channel 产生的错误 — 通常表示底层平台配置不完整。查看特定设置。

• 尝试使用桥接而非官方插件 — 不受支持。请迁移至官方插件。