المشكلات المعروفة

• ظل في نهاية التدفق بعد التحديث إلى 2.4.0 — يُفوَّض التحكم في التدفق إلى المستدعي لـ SDK. إذا ظهر ظل أو لم تُغلق الشاشة بعد الالتقاط الناجح، طبّق إصداراً داخل onSuccessSelfie:

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

• خطأ Bitcode عند توزيع التطبيق باستخدام Xcode 16 — بعد الإصدار الرسمي لـ Xcode 16 (17 سبتمبر 2024)، قد يُحجب التوزيع على App Store بسبب استخدام bitcode في تبعيتين داخليتين (DeviceProfiling وUnicoSdkLogger) عند استخدام CocoaPods. طبّق الحل البديل التالي في ملف 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| موجوداً في ملف Podfile، أضفه قبل آخر end. وإذا كنت تُزيل bitcode يدوياً بالفعل، فما عليك سوى إضافة المسارات في framework_paths.

المصادر: Bitrise، ملاحظات إصدار Xcode 16، Stack Overflow.

• فشل pod install بعد التحديثات — احذف Podfile.lock وأعد تشغيل pod install.

• تشويش iXGuard يُعطّل SDK — استخدم iXGuard 4.12.6 أو أعلى. يجب ألا يُشوَّه كود SDK نفسه. مراجعة قواعد التشويش.