كيفية إصلاح keyWindow المهمل في iOS 13: دليل كامل

«keyWindow» أصبح مهملاً. ماذا تفعل؟

إذا كنت قد كتبت من قبل:

guard let window = UIApplication.shared.keyWindow else { return }

…فمن المؤكد أنك رأيت التحذير الأصفر من Xcode: «'keyWindow' was deprecated in iOS 13.0». هذا أحد أكثر الأسئلة شيوعاً على Stack Overflow (أكثر من 100,000 مشاهدة)، وليس من دون سبب — لقد غيرت Apple قواعد اللعبة حقاً.

في هذه المقالة، سنشرح لماذا حدث ذلك، ونقارن 4 طرق للحصول على نافذة التطبيق دون استخدام API المهمل. ستعرف أي طريقة مناسبة لـ UIKit و SwiftUI و SceneDelegate ومتى يجب استخدام كل منها. هيا بنا!

لماذا تخلت Apple عن keyWindow؟

قبل iOS 13، كان للتطبيق نافذة رئيسية واحدة — keyWindow. كان الأمر بسيطاً: نأخذها ونعمل بها. ولكن مع ظهور iPadOS وتعدد المهام (Split View, Slide Over)، يمكن أن يكون للتطبيق عدة نوافذ في نفس الوقت. كل نافذة تُدار بواسطة UIWindowScene الخاص بها. أصبح مفهوم «النافذة الرئيسية» غير واضح.

توصي Apple الآن بالحصول على النافذة من خلال المشهد (UIWindowScene) الذي ينتمي إليه المتحكم أو العرض الخاص بك.

مقارنة الطرق: من البسيط إلى الصحيح

سنستعرض 4 طرق، من «إسكات التحذير بسرعة» إلى «القيام بذلك بطريقة Apple». اختر الطريقة التي تناسب بنيتك البرمجية.

1. الإصلاح السريع: UIApplication.shared.windows.first(where:)

الإجابة الأكثر شيوعاً على Stack Overflow — استخدام الخاصية windows بدلاً من keyWindow:

if let window = UIApplication.shared.windows.first(where: { $0.isKeyWindow }) {\n    // نستخدم window\n}

الإيجابيات:

\n
• أقل تغيير في الكود
\n
• يعمل على iOS 13+
\n

السلبيات:

\n
• لا يزال غير آمن مع وجود نوافذ متعددة
\n
• قد يعيد nil إذا لم يتم إنشاء النافذة بعد
\n
• لا تزال Apple تضع علامة «مهمل» عليه في بعض السياقات
\n

متى تستخدم: فقط للنموذج الأولي السريع أو إذا كان لديك نافذة واحدة بالتأكيد (مثل تطبيق iPhone بدون تعدد النوافذ).

2. عبر SceneDelegate: الطريق الصحيح لـ UIKit

بدءاً من iOS 13، قدمت Apple UISceneDelegate. في الطريقة scene(_:willConnectTo:options:) تحصل على UIWindowScene ويمكنك حفظ مرجع للنافذة.

الخطوة 1: في SceneDelegate.swift أعلن الخاصية window:

class SceneDelegate: UIResponder, UIWindowSceneDelegate {\n\n    var window: UIWindow?\n\n    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {\n        guard let windowScene = (scene as? UIWindowScene) else { return }\n        window = UIWindow(windowScene: windowScene)\n        window?.rootViewController = ViewController()\n        window?.makeKeyAndVisible()\n    }\n}

الخطوة 2: احصل على النافذة من خلال المشهد:

if let windowScene = view.window?.windowScene,\n   let window = windowScene.windows.first {\n    // نستخدم window\n}

أو، إذا كنت بحاجة إلى النافذة الرئيسية في أي مكان في التطبيق، قم بتخزين مرجع إلى SceneDelegate و window الخاص به.

الإيجابيات:

\n
• يتوافق تماماً مع توصيات Apple
\n
• يعمل بشكل صحيح مع النوافذ المتعددة
\n
• آمن لتعدد المهام على iPad
\n

السلبيات:

\n
• يتطلب إعداد SceneDelegate (إذا لم تنتقل إليه بعد)
\n
• كود أكثر قليلاً
\n

3. عبر UIWindowScene.activeWindow (iOS 15+)

بدءاً من iOS 15، لدى UIWindowScene

المدونات

حذف خاصية من كائن JavaScript: 3 طرق والمزالق

كيفية إجراء إعادة توجيه في JavaScript: أفضل الممارسات لعام 2025

تمرير الدوال كوسائط في Rust: 3 طرق لتمرير دالة

توصيات الكتب

JavaScript (Node.js) وDocker: حاويات التطبيقات

كود نظيف بلغة Rust: دليل عملي لكتابة كود موثوق وقابل للصيانة

دورة مكثفة في لغة C++

Beginning TypeScript

اقرأ أيضًا

المؤشرات السمينة في Rust: فهم المؤشر السمين (fat pointer) نشر تطبيق PHP على VPS: دليل خطوة بخطوة تغطية الكود بالاختبارات في Go: المقاييس والأدوات والأمثلة العملية Kotlin: أتمتة الروتين. كتابة أدوات توفر الوقت حقًا تسجيل السجلات في تطبيقات C++: أفضل الممارسات والأدوات