تصحيح الأخطاء

يقدم الاستوديو العديد من أدوات تصحيح الأخطاء وتدفقات العمل الشائعة الموجودة في بيئات التطوير المتكاملة (IDEs). تساعدك هذه الأدوات على فحص وحل الأخطاء في النصوص البرمجية أثناء تشغيلها.

تصحيح الأخطاء باستخدام نقاط التوقف

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

الإدارة

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

الإدراج

تأخذ نقاط التوقف عدة تنويعات ويمكن إدراجها في أي سطر من التعليمات البرمجية القابلة للتنفيذ كما يلي:

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

التعطيل

لتعطيل نقطة توقف مؤقتًا دون حذفها، استخدم أي من تدفقات العمل التالية:

• انقر على رمز نقطة التوقف.
• انقر بزر الماوس الأيمن على رمز نقطة التوقف واختر تعطيل نقطة التوقف.
• تحرير نقطة التوقف وقم بتبديل خانة الاختيار مفعل.

تظهر نقطة توقف معطلة كنسخة فارغة من رمزها المفعل، على سبيل المثال دائرة فارغة لنقطة توقف قياسية معطلة، أو ماسة فارغة لنقطة توقيف تسجيل معطلة.

الحذف

لحذف نقطة توقف، انقر بسرعة على رمزها أو انقر بزر الماوس الأيمن على رمزها واختر حذف نقطة توقف.

التحرير

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

لتحرير نقطة توقف:

1. انقر بزر الماوس الأيمن على رمز نقطة التوقف واختر تحرير نقطة التوقف.

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

   الخيار	الوصف
   الحالة	تعبير اختياري يحدد ما إذا كانت نقطة التوقف تنشط. إذا كانت الحالة فارغة، فإن نقطة التوقف تنشط دائمًا. إذا كانت الحالة موجودة، فإن نقطة التوقف تصبح نقطة توقف شرطية وتنشط فقط إذا كانت الحالة صحيحة. على سبيل المثال، إذا كنت تريد أن تنشط نقطة التوقف فقط إذا كانت المتغير var تساوي 10، قم بتعيين الحالة إلى var == 10.
   رسالة السجل	تعبير يطبع إلى نافذة المخرجات عند الوصول إلى نقطة التوقف. تنسيق رسالة السجل هو نفسه لبيان print() . على سبيل المثال، قم بتعيين رسالة السجل كـ "قيمة var هي:", var لإنتاج نفس الرسالة مثل print("قيمة var هي:", var).
   استمرار التنفيذ	تحدد ما إذا كانت نقطة التوقف توقف النص البرمجي إذا نشطت. يتم تعطيل هذا الخيار بشكل افتراضي ما لم تكن نقطة التوقف المدخلة نقطة تسجيل.
   إزالة نقطة التوقف عند الوصول	إذا تم تحديدها، تزيل نقطة التوقف نفسها تلقائيًا بعد أول جلسة اختبار لعب، مما يجعلها فعليًا نقطة توقف مؤقتة.
   التنشيط في	تحدد سياق نقطة التوقف ما إذا كانت يجب أن تنشط في العميل (نصوص العميل الجانبي)، الخادم (نصوص الخادم الجانبي)، أو التعديل (تصحيح نصوص الإضافة). إذا اختارت سياق مخصص، تظهر نافذة تشير إلى السياقات النشطة الحالية.

سير العمل

سير العمل النموذجي لتصحيح الأخطاء باستخدام نقاط التوقف هو كما يلي:

1. افتح النص البرمجي الذي ترغب في تصحيحه وأدرج نقاط التوقف على الأسطر التي ترغب في فحصها.

2. من الميزانين في الاستوديو، قم ببدء اختبار اللعب للبدء في تصحيح الأخطاء.

   

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

   

4. خلال توقف النص، افحص نافذة نقاط التوقف، ونافذة المراقبة، ونافذة سجل الاستدعاءات، ونافذة المخرجات، ومحرر النصوص البرمجية للعثور على معلومات حول قيم المتغيرات وتنفيذ الدوال.

5. لمواصلة تنفيذ الكود بعد الوصول إلى نقطة توقف، انقر على استئناف النصوص في الميزانين.

   

   يمكنك أيضًا تنفيذ الكود سطرًا واحدًا في كل مرة باستخدام أزرار الخطوات في الميزانين:

   

   الإجراء	اختصار	الوصف
   خطوة داخل	F11	زر خطوة داخل ينقل المصحح إلى كود الدالة في السطر الحالي. إذا لم يكن هناك دالة في السطر الحالي، ينتقل المصحح إلى السطر التالي.
   خطوة فوق	F10	زر خطوة فوق ينقل المصحح إلى السطر التالي من التعليمات البرمجية، دون الانتقال إلى داخل الدوال.
   خطوة للخارج	ShiftF11	زر خطوة للخارج ينقل المصحح خارج الدالة الحالية إلى السطر التالي من التعليمات البرمجية بعد استدعاء الدالة. إذا لم يكن السطر الحالي داخل دالة، ينتقل المصحح إلى السطر التالي.

6. عندما تنتهي من تصحيح الأخطاء في الجلسة الحالية، انقر على زر توقف.

   

المراقبة

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

نقاط التوقف

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

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

أثناء جلسة التصحيح، يظهر العمود الأبعد إلى اليسار (x3) مما يشير إلى السياقات المتعددة (العميل، الخادم، التعديل) لنقطة التوقف. عند توسيع فرع أي نقطة توقف، يمكنك بعد ذلك النقر على الرمز بجوار سياق معين لتعطيله/تمكينه [(#disable)] لذلك السياق، مثل تعطيل نقطة توقف فقط في سياق العميل بينما تظل ممكّنة في سياق الخادم.

سجل الاستدعاءات

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

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

المراقبة

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

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

محرر النصوص البرمجية

يتكامل المصحح مع محرر النصوص البرمجية. عندما تتوقف تجربتك عند نقطة توقف في نص برمجي، يمكنك تمرير الماوس فوق اسم متغير لرؤية قيمته. على سبيل المثال، يمكنك رؤية تركيب جدول ومفاتيحه/قيمه المحتواة.

أدوات التصحيح الإضافية

بالإضافة إلى المصحح، يقدم الاستوديو أدوات تصحيح إضافية لك لإصلاح المشاكل والأخطاء في تجربتك.

شريط الأوامر

يتيح لك شريط الأوامر تشغيل أوامر Luau أثناء تشغيل التجربة. إنه متاح في الاستوديو من قائمة نافذة ⟩ نص البرمجة وفي وحدة تحكم المطور.

وحدة تحكم المطور

توفر وحدة تحكم المطور مجموعة واسعة من التفاصيل بما في ذلك الناتج من العميل والخادم، واستخدام الذاكرة، وأداء الشبكة، وأكثر من ذلك. لفتح الوحدة أثناء الاختبار أو اللعب ، اكتب /console في الدردشة أو اضغط على F9.

ملفات السجل

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

ويندوز

للوصول إلى ملفات السجل على ويندوز:

1. افتح مستكشف الملفات.
2. انتقل إلى الدليل %LOCALAPPDATA%\Roblox\logs.
3. انقر مرتين على سجل لفتحه. تكون السجلات التي تحمل نفس قيمة XXXXX من نفس جلسة الاستوديو.

ماك

للوصول إلى ملفات السجل على ماك:

1. افتح Finder.
2. من شريط القائمة، اختر اذهب ⟩ اذهب إلى المجلد ....
3. في الحوار، أدخل ~/Library/Logs/Roblox.
4. انقر نقراً مزدوجاً على النتيجة للانتقال إلى دليل سجلات Roblox.
5. داخل الدليل، انقر نقراً مزدوجاً على سجل لفتحه.

iOS

يمكنك جمع سجلات iOS باستخدام ماك أو باستخدام جهاز iOS.

للوصول إلى ملفات سجل iOS على ماك:

1. قم بتوصيل جهاز iOS بجهاز ماك.
2. افتح Finder.
3. انتقل إلى المرافق وافتح تطبيق الكونسول.
4. لتوفير السجلات الفورية في تطبيق الكونسول، اختر جهاز iOS من الشريط الجانبي، انقر زر بدء، وأعد إنتاج المشكلة على جهاز iOS.
5. لتوفير السجلات المؤرشفة في تطبيق الكونسول، قم بتشغيل sudo log collect --device-name "[اسم جهاز iOS]" في Terminal. تأكد من عدم وجود علامات اقتباس في اسم الجهاز وإلا قد تحصل على خطأ عند تشغيل الأمر.

أندرويد

للوصول إلى ملفات السجل على أندرويد:

1. انتقل إلى الإعدادات ⟩ النظام ⟩ خيارات المطور.
2. قم بتشغيل خيارات المطور.
3. على جهاز الكمبيوتر، قم بتنزيل وتثبيت Android Studio.
4. في Android Studio، انقر على Logcat.
5. قم بتوصيل جهاز أندرويد بالكمبيوتر لبدء ملء Logcat بالسجلات تلقائيًا.