Problemas conocidos

• Sombra al final del flujo tras actualizar a 2.4.0 — el control del flujo es delegado al llamador del SDK. Si aparece una sombra o la pantalla no se cierra después de una captura exitosa, implementa una liberación dentro de onSuccessSelfie:

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

• Error de Bitcode en la distribución de apps usando Xcode 16 — tras el lanzamiento oficial de Xcode 16 (17 de sep de 2024), la distribución en el App Store puede bloquearse por el uso de bitcode en dos dependencias internas (DeviceProfiling y UnicoSdkLogger) al usar CocoaPods. Aplica el siguiente workaround en tu Podfile hasta que se publique una solución definitiva:

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

Si post_install do |installer| no está presente en el Podfile, agrégalo antes del último end. Si ya eliminas el bitcode manualmente, simplemente añade las rutas en framework_paths.

Fuentes: Bitrise, Notas de la versión de Xcode 16, Stack Overflow.

• pod install falla después de actualizaciones — elimina Podfile.lock y ejecuta pod install nuevamente.

• La ofuscación con iXGuard rompe el SDK — usa iXGuard 4.12.6 o superior. El código del SDK en sí no debe ser ofuscado. Revisa las reglas de ofuscación.