已知问题

• 更新至 2.4.0 后流程结束时出现阴影 — 流程控制委托给 SDK 调用方。如果捕获成功后出现阴影或屏幕未关闭，请在 onSuccessSelfie 中实现释放逻辑：

func onSuccessSelfie(_ result: SelfieResult!) {
    navigationController?.popViewController(animated: true)
    // your code
}

• 使用 Xcode 16 分发应用时的 Bitcode 错误 — 在 Xcode 16 正式发布（2024 年 9 月 17 日）后，由于两个内部依赖项（DeviceProfiling 和 UnicoSdkLogger）在使用 CocoaPods 时包含 bitcode，分发到 App Store 可能会被阻止。在永久修复发布之前，请在您的 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

如果 Podfile 中不存在 post_install do |installer|，请在最后一个 end 之前添加。如果您已手动剥离 bitcode，只需在 framework_paths 中追加相应路径即可。

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

• 更新后 pod install 失败 — 删除 Podfile.lock 并重新运行 pod install。

• iXGuard 混淆导致 SDK 故障 — 请使用 iXGuard 4.12.6 或更高版本。SDK 代码本身不得被混淆。查看混淆规则。