المستندات / استكشاف الأخطاء وإصلاحها

استكشاف الأخطاء وإصلاحها

تواجه مشكلة؟ ستجد أدناه حلولًا لأكثر المشكلات شيوعًا. تتناول كل بطاقة عرَضًا محددًا وطريقة حلّه.

الأذونات

«لا يستطيع BetterStage التحكم في نوافذي»

يتطلب BetterStage إذن إمكانية الوصول لقراءة النوافذ ونقلها. افتح إعدادات النظام > الخصوصية والأمن > إمكانية الوصول وتأكّد من أن BetterStage مدرج ومفعّل. وإذا كان مفعّلًا بالفعل، فجرّب إيقافه ثم تفعيله مجددًا. أعد تشغيل BetterStage بعد تغيير الإذن. وإذا أُلغي الإذن أثناء تشغيل BetterStage، ينبّهك التطبيق ويستعيد النوافذ المخفية بدلًا من تركها خارج الشاشة. ولم يعد إلغاء إذن «إمكانية الوصول» يتسبب في احتجاز BetterStage لإدخال لوحة المفاتيح أو الفأرة. ولا تؤدي إعادة منحه إلى مقاطعة عملية استعادة جارية لمساحة عمل محفوظة أو للاستمرارية أو بعد الاستيقاظ.

«الاختصارات لا تعمل»

يستخدم BetterStage واجهة Carbon الأصلية لمفاتيح الاختصار في اختصارات لوحة المفاتيح، فلا حاجة إلى إذن «مراقبة الإدخال». إذا كانت الاختصارات لا تعمل، فتحقّق أولًا من تفعيل إذن إمكانية الوصول. وتأكّد أيضًا من أن أي تطبيق آخر لا يستخدم مجموعات المفاتيح أو أزرار الفأرة أو إيماءات لوحة التتبع نفسها — فالاختصارات المتعارضة تمنع BetterStage من تلقي الأحداث. أعد تعيين عناصر التحكم بلوحة المفاتيح والفأرة ولوحة التتبع في الإعدادات > الاختصارات.

«لا يتم اكتشاف النوافذ»

يعتمد اكتشاف النوافذ على واجهة Accessibility API في macOS، والتي يغطيها إذن إمكانية الوصول. تأكّد من تفعيله في إعدادات النظام > الخصوصية والأمن > إمكانية الوصول. ولاحظ أن بعض التطبيقات تستخدم أنواع نوافذ غير قياسية (مثل اللوحات العائمة أو نوافذ Chrome المخصصة) قد لا تكتشفها واجهة إمكانية الوصول.

سلوك النوافذ

«هل ينبغي أن أستخدم BetterStage مع منظم المشاهد في macOS؟»

لا. أوقف منظم المشاهد المدمج من Apple قبل استخدام BetterStage. تدير الأداتان ظهور النوافذ، لذا قد يؤدي تشغيلهما معًا إلى تبديلات مربكة أو نوافذ مخفية أو نوافذ تظهر في غير مكانها. افتح إعدادات النظام > سطح المكتب وDock > منظم المشاهد وأوقف منظم المشاهد، ثم أعد تشغيل BetterStage إذا ظلت مساحة العمل تبدو غير صحيحة.

«نوافذ Firefox/Chrome تتحرك بحركة متدرجة بدلًا من الالتصاق فورًا»

تفعّل بعض المتصفحات (Firefox وChrome والتطبيقات المبنية على Electron) علامة إمكانية وصول تُسمى AXEnhancedUserInterface تجعل حركة النوافذ متدرجة بدلًا من الالتصاق الفوري. يكتشف BetterStage هذه العلامة تلقائيًا ويعطّلها للتطبيقات المتأثرة. وإذا ظللت ترى حركة متدرجة، فجرّب إنهاء المتصفح وإعادة فتحه ليتمكن BetterStage من إعادة تطبيق الإصلاح.

«نوافذ Firefox تومض، أو تقاوم تحديد موضعها، أو تتأخر عن تبديل المراحل»

يتعامل Firefox مع نوافذه بطرق غير قياسية، لذا لا يتجاوب دائمًا مع إدارة النوافذ — فقد ترى نوافذ تومض لحظيًا، أو تقاوم تحديد موضعها بدقة، أو تتأخر عن تبديل المراحل. هذه مشكلة معروفة، ونواصل تحسين التوافق مع Firefox.

«يظهر Finder عند الانتقال إلى مرحلة فارغة»

قد يُنشّط macOS تطبيق Finder عندما لا تكون للتطبيق النشط أي نوافذ ظاهرة. يُخفي BetterStage 2.2.0 النوافذ منفردةً في مساحة خاصة بدلًا من إخفاء التطبيق بأكمله. وإذا ظهرت نافذة على نحو غير متوقع في مرحلة فارغة، فأبلغنا باسم التطبيق وتسلسل عمليات تبديل المراحل أو أسطح المكتب التي أدت إلى ذلك.

«انتقلت النوافذ إلى مرحلة خاطئة بعد السكون أو شاشة التوقف»

انتظر حتى يستقر ترتيب الشاشات. يعود تخطيط الشاشة المحفوظة من تلقاء نفسه؛ وإذا ظهرت مطالبة بالاسترداد، فاختر «استعادة مساحة العمل» أو «الإبقاء على التخطيط الحالي». وللنوافذ التي تظل مخفية بعد إزالة سطح مكتب، أو التي انتهى بها المطاف خارج الشاشة بعد تغيّر الشاشات، استخدم إنقاذ النوافذ من شريط القوائم. وإذا أفاد BetterStage بأن مساحات macOS غير متاحة، فانتظر اكتمال الانتقال بين أسطح المكتب واختر «إعادة المحاولة». وأعد تشغيل BetterStage إذا استمرت المشكلة.

«مربع حوار أو نافذة عائمة عالقة خلف TabStack»

افتح عجلة الالتصاق واختر إبراز النوافذ العائمة من «إجراءات إضافية». يُحضر ذلك النوافذ العائمة وغير المتتبَّعة على هذه الشاشة إلى المقدمة دون تغيير التخطيط أو إظهار علامات التبويب المخفية. كما يستعيد «إنقاذ النوافذ» النوافذ التي أخفاها BetterStage في مساحات خاصة، بما فيها النوافذ التي أُزيل سطح مكتبها الأصلي.

«نوافذ مفقودة بعد عطل مفاجئ»

يسجّل BetterStage النوافذ المنقولة إلى مساحات خاصة ويشغّل أداة استرداد مساعدة منفصلة. وإذا أُغلق BetterStage على نحو غير متوقع، تستخدم الأداة المساعدة تلك السجلات لإعادة النوافذ المخفية إلى أسطح المكتب المحفوظة لها. وإذا ظلت نوافذ مفقودة، فأعد تشغيل BetterStage واستخدم «إنقاذ النوافذ». وقد يتطلب سطح المكتب المُزال أو الشاشة المفصولة وجهة بديلة متاحة.

إعدادات التطبيق

«التشغيل من الطرفية مقابل حزمة ‎.app»

عندما تشغّل BetterStage عبر swift run في الطرفية، يربط macOS إذن «إمكانية الوصول» بتطبيق الطرفية بدلًا من BetterStage نفسه. وللتعامل الصحيح مع الأذونات بحيث يظهر BetterStage باسمه في إعدادات النظام، ابنِ حزمة .app وشغّلها بدلًا من ذلك.

«شريط المراحل لا يظهر»

يمكن إظهار شريط المراحل عبر الحافة النشطة (بتحريك المؤشر إلى أعلى الشاشة) أو باختصار لوحة المفاتيح Opt+Up Arrow. تأكّد من تفعيل الحافة النشطة في الإعدادات. وإذا ظل شريط المراحل لا يظهر، فتحقّق من أن BetterStage يملك إذن «إمكانية الوصول» المطلوب.

على شاشات Mac المدمجة ذات الشق، يمكن للخيار الإعدادات > المراحل > شريط المراحل > تجنّب شق الشاشة تخطي الشق نفسه مع إبقاء بقية الحافة العلوية نشطة.

«الشاشة غير معروفة بعد إعادة توصيلها»

يتعرّف BetterStage على الشاشات من خلال تفاصيل العتاد مثل الطراز والرقم التسلسلي، لا من خلال معرّف الشاشة الذي يعيّنه macOS فقط. وفي حالات نادرة، كأن يكون ذلك بعد تحديث برنامج تشغيل أو مع منفذ أو محوّل مختلف، تتغير هذه التفاصيل. جرّب فصل الشاشة وإعادة توصيلها، ثم أعد تشغيل BetterStage. وإذا ظلت الشاشة غير معروفة، فأعد إعدادها في الإعدادات > الشاشات.

«لا يزال ⌘Tab يعرض مبدّل التطبيقات في macOS»

مبدّل ⌘Tab في BetterStage اختياري ومعطّل افتراضيًا. فعّل استخدام ⌘Tab من BetterStage في الإعدادات > مبدّل ⌘Tab وتأكّد من أن Pro أو الفترة التجريبية أو معاينة Pro اليومية نشطة. وبدون المعاينات يعرض أيقونات التطبيقات؛ فاسمح بإذن «تسجيل الشاشة» للحصول على صور مصغّرة مباشرة. راجع دليل مبدّل ⌘Tab.

«مراحلي لا تُحمَّل بعد العودة إلى 2.0.x»

لا يمكن للإصدارات السابقة فتح المراحل التي حفظها BetterStage 2.2. وإذا أعدت تثبيت 2.0.x، فلن تُحمَّل مراحلك؛ لذا حدّث إلى أحدث إصدار من صفحة التنزيل بدلًا من ذلك.

الإبلاغ عن خطأ

يحتفظ BetterStage بسجل تشخيصي دوّار بحد أقصى 10 MB كي لا يملأ قرصك أبدًا. لإرفاقه ببلاغ عن خطأ، افتح أيقونة BetterStage في شريط القوائم واختر إظهار سجل التشخيص… — فيفتح Finder على ملف السجل لتسحبه إلى رسالة على Discord أو بلاغ على GitHub أو بريد إلكتروني.

تتجنب الإصدارات النهائية التسجيل المفصّل الذي قد يلتقط عناوين النوافذ. وإذا كنت تعيد إنتاج مشكلة وتريد تتبعًا أغنى، فشغّل إصدار بيتا أو إصدارًا مرشّحًا، والتقط السجل، ثم عُد إلى قناة الإصدارات النهائية بعد ذلك.

لا تزال بحاجة إلى مساعدة؟

إذا لم تُغطِّ المعلومات أعلاه مشكلتك، فتواصل معنا وسنساعدك على حلّها.