Problemas conhecidos

• Sombra no final do fluxo após atualizar para 2.4.0 — o controle do fluxo é delegado ao chamador do SDK. Se uma sombra aparecer ou a tela não fechar após uma captura bem-sucedida, implemente um release dentro de onSuccessSelfie:

func onSuccessSelfie(_ result: SelfieResult!) {
    navigationController?.popViewController(animated: true)
    // seu código
}

• Erro de bitcode na distribuição de app usando Xcode 16 — após o lançamento oficial do Xcode 16 (17 set. 2024), a distribuição para a App Store pode ser bloqueada devido ao uso de bitcode em duas dependências internas (DeviceProfiling e UnicoSdkLogger) ao usar CocoaPods. Aplique o workaround abaixo no seu Podfile até que uma correção permanente seja lançada:

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

Se post_install do |installer| não estiver presente no Podfile, adicione-o antes do último end. Se você já remove o bitcode manualmente, apenas acrescente os caminhos em framework_paths.

Fontes: Bitrise, Notas de release do Xcode 16, Stack Overflow.

• pod install falha após atualizações — remova o Podfile.lock e execute pod install novamente.

• Obfuscation com iXGuard quebra o SDK — use iXGuard 4.12.6 ou superior. O código do SDK em si não deve ser obfuscado. Revise as regras de obfuscation.