بعد Xcode 11.2: تعطل التطبيق بسبب _UITextLayoutView — الحل

بعد تحديث Xcode 11.2 يتعطل التطبيق: كيفية التغلب على _UITextLayoutView

هل حدث معك هذا: كنت تعمل بهدوء على مشروعك، كل شيء يعمل بسلاسة، الاختبارات تمر، المستخدمون سعداء. ثم فجأة! تقوم بتحديث Xcode إلى الإصدار 11.2، تشغل التطبيق، فيتعطل مع خطأ غامض _UITextLayoutView. هل هذا مألوف؟ إذا كان الأمر كذلك، فأنت لست وحدك. هذه المشكلة فجرت Stack Overflow حرفيًا في نهاية عام 2019 (آلاف المشاهدات في أسبوع واحد).

في هذه المقالة، لن أشرح فقط كيفية إصلاح هذا الخلل، بل سأشرح أيضًا سبب حدوثه، وكيفية تشخيصه، والأهم من ذلك، كيفية منعه في المستقبل. سنحلل كل شيء بأمثلة حية بلغة Swift. هيا بنا!

ما هو هذا المخلوق _UITextLayoutView؟

لنبدأ بالنظرية. _UITextLayoutView هي فئة داخلية (خاصة) من UIKit مسؤولة عن عرض النص في UITextView. لا توثقها Apple علنًا، لذلك عندما حدث خطأ ما في Xcode 11.2 مع هذه الفئة، وجد المطورون أنفسهم في مأزق. يبدو الخطأ كالتالي تقريبًا:

*** إنهاء التطبيق بسبب استثناء غير ممسوك 'NSInvalidArgumentException'، السبب: '-[_UITextLayoutView setFrame:]: تم إرسال محدد غير معروف إلى المثيل 0x...'

العبارة الرئيسية هي "تم إرسال محدد غير معروف إلى المثيل". هذا يعني أنك تحاول استدعاء الأسلوب setFrame: على كائن لا يدعمه. وبما أن _UITextLayoutView هي فئة خاصة، فقد كان سلوكها مختلفًا قبل Xcode 11.2.

من هم في مجموعة الخطر؟

لا تظهر المشكلة لدى الجميع، فقط في ظل ظروف معينة. إليك السيناريو النموذجي:

\n
• أنت تستخدم UITextView مع تفعيل تغيير الحجم التلقائي (auto-sizing).
\n
• لديك تسلسل هرمي مخصص للعروض، حيث يكون UITextView متداخلاً داخل UIScrollView أو UITableViewCell.
\n
• أنت تتفاعل بنشاط مع حقل النص: التمرير، التحرير، تغيير الخط.
\n

إذا تطابق عنصر واحد على الأقل، تهانينا، أنت في منطقة الخطر. لكن لا تقلق: هناك حل، وهو أنيق.

الخطوة 1: التشخيص — ابحث عن الجاني

قبل العلاج، دعنا نتأكد من أن المشكلة تكمن بالفعل في _UITextLayoutView. افتح وحدة تحكم Xcode (View → Debug Area → Activate Console) وقم بتشغيل التطبيق. إذا رأيت خطأ مشابهًا للذي ذكرته أعلاه، فأنت على الطريق الصحيح.

علامة إضافية: يحدث التعطل عند أول محاولة لعرض UITextView أو عند التمرير داخله. إذا تعطل التطبيق فورًا بعد التحميل، فمن المحتمل جدًا أن يكون هذا هو السبب.

الخطوة 2: حل بسيط وسريع (للمستعجلين)

الإصلاح الأكثر شيوعًا على Stack Overflow هو تعطيل تغيير الحجم التلقائي لـ UITextView. إليك كيفية القيام بذلك:

// في viewDidLoad الخاص بك أو طريقة الإعداد\ntextView.isScrollEnabled = false\ntextView.translatesAutoresizingMaskIntoConstraints = true

لكن انتبه! هذا الحل يعمل، لكنه يكسر الحجم التلقائي للنص. إذا كان من الضروري بالنسبة لك أن يغير UITextView ارتفاعه ديناميكيًا وفقًا للمحتوى، فهذا الخيار غير مناسب. دعنا نتعمق أكثر.

الخطوة 3: حل متقدم — إعادة تعريف layoutSubviews

أصدرت Apple تصحيحًا في Xcode 11.2.1، ولكن إذا بقيت لسبب ما على الإصدار 11.2، أو كنت تريد حلاً عالميًا، فإليك ما يجب فعله.

أنشئ فئة فرعية من UITextView وأعد تعريف الأسلوب layoutSubviews:

import UIKit\n\nclass FixedTextView: UITextView {\n    override func layoutSubviews() {\n        super.layoutSubviews()\n        // نقوم بتنظيف الطبقة من العروض الفرعية الزائدة التي يسببها الخلل\n        self.subviews.forEach { subview in\n            if subview.isKind(of: NSClassFromString("_UITextLayoutView") ?? UIView.self) {\n        \n