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

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

يجب تسجيل جميع تقارير الأخطاء في متعقب الأخطاء الرسمي. ويَجرِي تتبع طلبات الميزات هناك أيضًا باستخدام بند الخطورة قائمة الرغبات. ولكن قبل القيام بذلك، يُرجَى القيام بما يلي:

الخطوة 1: الترقية إلى أحدث إصدار

يُرجَى الترقية إلى أحدث الإصدارات المُطلقة من كِدِنلايف. لا نجيب على تقارير الأخطاء لإصدارات كِدِنلايف القديمة (ما لم يمكن تكرارها في أحدث إصدار).

الخطوة 2: البحث في توثيق كِدِنلايف الرسمي

«اقرأ الدليل اللطيف (RTFM)» عبارة تستخدم للسخرية من المستخدمين الذين يطرحون أسئلة يمكن الإجابة عليها بقراءة التوثيق. في عصر دروس يوتيوب التعليمية هذا قد لا يـكـون هـذا مهمًا أو ذا صلة بعد الآن، لكن يشجّعون على استشارة توثيق كِدِنلايف الرسمي. يمكن البحث فيه ويحتوي على ثروة من المعلومات الجيدة والقيمة.

الخطوة 3: البحث في المنتديات

لدى كِدِنلايف مجتمع كبير نشط في المنتديات وغرف الدردشة. تحقق من المنتدى الرسمي ما إذا واجه مستخدمون آخرون نفس المشكلة. قد يكون هناك إصلاح أو حل بديل. القنوات الأخرى للتحقق منها هي

الخطوة 4: الاستعلام عن المشكلات المفتوحة

ابحث في متعقب الأخطاء. ربما المشكلة التي تواجهها قد أبلغ عنها بالفعل أو يَجرِي العمل عليها. حالة الخطأ هي مؤشر جيد لما يَجرِي حاليًا:

  • أُبْلِغَ هو خطأ أبلغ عنه ولكن لم يحدث شيء حتى الآن. قد تكون هناك مناقشة حوله، لذا يجدر التحقق مما إذا كان قد ينطبق على مشكلتك.
  • بحاجة إلى معلومات هو خطأ أبلغ عنه، ويحتاج إلى المزيد من الملاحظات. هذا يعني أن عضوًا في فريق التطوير نظر إليه ولكنه يحتاج إلى المزيد من التفاصيل
  • مؤكد يعني أنه يمكن تكرار الخطأ (إما من قبل مستخدمين آخرين أو فريق التطوير)
  • مُعَيَّن يعني أن مطورًا يتعامل مع الخطأ
  • حُلَّ يعني أن الخطأ أصلح في نسخة التطوير

الخطوة 5: الإبلاغ عن الخطأ

إذا واجهت تعطلًا عند بدء تشغيل كِدِنلايف أو عند محاولة تشغيل ملف فيديو، يُرجَى اتباع هذه الخطوات:

  1. إذا قمت بتجميع كِدِنلايف و/أو MLT بنفسك، فتأكد من اتباعك لجميع الخطوات الموضحة في تعليماتنا.
  2. تحقق من عدم تثبيت عدة إصدارات من MLT لديك
  3. حاول تشغيل ملف الفيديو الخاص بك باستخدام مشغل FFmpeg. من الطرفية: ffplay myvideo.mpg
  4. حاول تشغيل ملف الفيديو الخاص بك باستخدام مشغل MLT. من الطرفية: melt myvideo.mpg

ضمِّن النتائج في تقرير الخطأ الخاص بك كمرفقات.

للحصول على تقرير خطأ جيد، يُرجَى ضمّان المعلومات التالية:

  • إصدار كِدِنلايف و MLT الخاص بك. يمكنك نسخ تلك المعلومات من قائمة كِدِنلايف > مساعدة > حول.
  • نظام التشغيل (OS) الخاص بك، مثل ويندوز، توزيعة لينكس، أو ماك أو إس بما في ذلك الإصدار الخاص به
  • طريقة تثبيت كِدِنلايف، مثل مثبت ويندوز أو مستقل، أو لينكس flatpak/snap/ppa أو appimage
  • خطوات مفصلة لتكرار الخطأ. لقطات الشاشة وتسجيلات الشاشة مفيدة جدًا لتكرار المشكلة.
  • أي رسائل خطأ أو ملفات سجل يمكنك توفيرها. يُرجَى عدم نسخ ولصق محتوى السجل في تقرير الخطأ ولكن إضافته كمرفق.
  • إذا أدى الخطأ إلى تعطل كِدِنلايف، فوفر تتبعًا خلفيًا.

كيفية الحصول على معلومات تعطل مفيدة (تتبع خلفي)

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

صورة تطبيق لينكس

يُرجَى تثبيت الحزم التالية: gdb، kdenlive-dbg، libmlt-dbg (قد تختلف أسماء الحزم قليلاً حسب توزيعتك)

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

  1. اكتب gdb kdenlive
  2. بعد أن يقرأ gdb رموز التصحيح، اكتب run

حزمة فلاتباك لينكس

أولًا وقبل كل شيء، تأكد من تثبيت رموز تصحيح فلاتباك عن طريق كتابة flatpak install org.kde.kdenlive.Debug في سطر الأوامر.

الآن يمكنك بدء تشغيل فلاتباك من سطر الأوامر على هذا النحو:

  1. ابدأ تشغيل صدفة داخل بيئة فلاتباك المعزولة لكِدِنلايف: flatpak run --command=sh --devel org.kde.kdenlive
  2. اكتب gdb /app/bin/kdenlive
  3. بعد أن يقرأ gdb رموز التصحيح، اكتب run

لمزيد من التفاصيل حول تصحيح أخطاء فلاتباك، انظر هنا: https://docs.flatpak.org/en/latest/debugging.html

ويندوز

  1. ابنِ كِدِنلايف باستخدام KDE Craft محليًا كما هو موضح هنا.
  2. اكتب في سطر الأوامر cd C:/CraftRoot/mingw64/bin
  3. ابدأ gdb بـ gdb
  4. ابدأ كِدِنلايف -> احصل على رقم PID
  5. attach 3288 (استبدل 3288 برقم PID)
  6. انتظر عند محث (gdb)
  7. اكتب c

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

thread apply all bt full

ثم اضغط على Enter حتى ترى البيانات الكاملة. انسخ السجل إلى ملف وارفقه بتقرير الخطأ.