محرر السكريبت

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

• تنسيق وتحديد بنية الأكواد في السكريبتات الخاصة بك.
• تقديم طرق لـ الإكمال التلقائي للعبارات في السكريبتات أثناء الكتابة.
• مساعدتك في تنقل الأكواد من خلال الانتقال إلى تعريفات المتغيرات والدوال.
• مساعدتك في البحث والاستبدال الأكواد في السكريبتات المفتوحة أو جميع السكريبتات.
• توفير ردود فعل فورية حول جودة أدائك وأكوادك.

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

ميزات الإكمال التلقائي

تولد ميزات الإكمال التلقائي في محرر السكريبت معلومات متعلقة بالكود يمكن أن تحسن من كفاءتك في البرمجة، مثل:

• اقتراحات مستنيرة حول كيفية إكمال العبارات أثناء كتابتها والتي تكون سياقية لنموذج بيانات التجربة data model. على سبيل المثال، إذا كان لديك Model في Workspace يسمى RocketShip، فإن الإكمال التلقائي يقترح RocketShip عندما تكتب workspace.roc ويشير إلى أنه Model.

  

  استخدم مفاتيح ↑ و ↓ لتصفح الاقتراحات، ثم اضغط على Tab أو Enter لقبول اقتراح وإدخال العبارة الكاملة.

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

  

• نوافذ وثائق منبثقة مع أمثلة كود مماثلة لتلك الموجودة في محرك API Reference، مما يعطيك سياق حول استخدام API.

  

• نوافذ توضيحية عند التحليق يمكنك تخصيصها بوثائق المعرفة الخاصة بك.

  

• تشخيصات تحليل السكريبت عند التحليق مع معلومات يمكنك استخدامها لاستكشاف الأخطاء وإصلاحها.

  

• تواقيع الدوال عندما تكتب ملاحظة، مما يوفر لك مرجعًا لمُتطلبات ومعايدات الدالة.

  

تنقل الأكواد

الانتقال إلى التعريف

يمكنك الانتقال إلى تعريف دالة أو متغير عن طريق الضغط على Ctrl على Windows أو ⌘ على Mac أثناء النقر على الاستدعاء، أو من خلال النقر بزر الماوس الأيمن على الاستدعاء والنقر على الانتقال إلى التعريف.

فلتر دالة السكريبت

يعرض فلتر دالة السكريبت قائمة بكل الدوال المعروفة في السكريبت. لفتحه، اضغط على AltF على Windows أو ⌥F على Mac. مع فتح القائمة، يمكنك تصفح التوقيعات لكل دالة، وتصفية تلك بواسطة الاسم، والنقر مرتين على واحدة للانتقال إلى تعريفها.

البحث والاستبدال

يتيح لك جهاز البحث/الاستبدال العثور على الأكواد واستبدالها في سكريبت مفتوح. يدعم الجهاز مطابقة الحالة، والمطابقة الكاملة للكلمة، والبحث باستخدام التعبيرات العادية. لفتحه، اضغط على CtrlF على Windows أو ⌘F على Mac.

ردود الفعل الفورية

تحليل السكريبت

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

المخرجات

تظهر نافذة المخرجات الأخطاء الملتقطة من تشغيل السكريبتات، والرسائل من محرك Roblox، والرسائل الناتجة عن الاستدعاءات لـ print()، والأخطاء الناتجة عن الاستدعاءات لـ warn().

مساعدة الأكواد

تعتبر مساعدة الأكواد ميزة تقترح أسطر أو دوال من الأكواد أثناء الكتابة، مما يساعدك على البرمجة بشكل أكثر كفاءة والتركيز. استنادًا إلى سياقات من التعليقات والأكواد الخاصة بك، ستُفعل الاقتراحات بطريقتين:

• ** تلقائيًا** عندما تتوقف على سطر لبضع ثوانٍ وتكون لدى النموذج الذكي ما يكفي من السياق لتقديم اقتراح.
• يدويًا باستخدام اختصار Alt∖ على Windows أو ⌥∖ على Mac.

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

تحسين الاقتراحات

للحصول على اقتراحات أكثر دقة وملاءمة، يُنصح بمراعاة ممارسات كتابة الأكواد النظيفة، بغض النظر عن المساعدة، و:

• قسم الأكواد الخاصة بك إلى دوال أصغر.
• استخدم أسماء سكريبت وصفية تعكس النية العامة لما تفعله كل دالة. على سبيل المثال، سمِّ سكريبت SyncCustomSounds بدلاً من مجرد Sounds.
• استخدم أسماء وصفية للمتغيرات والدوال والسكريبتات. على سبيل المثال، سمِّ جزءًا GreenSphere بدلاً من مجرد grs، أو سمِّ دالة generateSphere() بدلاً من gen(). يمكن أن ينتج استخدام الدوال المسماة مقابل الدوال المجهولة تلميحات أفضل.
• تضمين التعليقات المكتوبة بشكل جيد comments التي تصف المهمة التي تقوم بتنفيذها وما يجب أن تكون المدخلات/المخرجات.

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

القيود

تساعد الأداة في أتمتة المهام البرمجية الأساسية لكنها لا تقترح دائمًا أكواد مثالية. تشمل القيود المعروفة:

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

خصوصية الأكواد

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

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

مؤشر متعدد

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

• يتم نسخ التعديلات التي تقوم بها في المؤشر الأساسي إلى المؤشرات الثانوية. تُحتسب كل تعديل كعمل واحد، لذلك فإن التراجع/إعادة التقدم لتعديل ينطبق على جميع المؤشرات.
• تظهر العناصر مثل الإكمال التلقائي على المؤشر الأساسي ولكن ليس على المؤشرات الثانوية.
• تعمل جميع اختصارات لوحة المفاتيح القياسية لتحرير السكريبت مع التحرير باستخدام المؤشر المتعدد، بما في ذلك تحديد الأكواد، وتبديل التعليقات، وحذف الأسطر.

توفر الجدول التالي ملخصًا لعمليات العمل باستخدام المؤشر المتعدد واختصاراتها.

إضافة مؤشرات

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

في موقع الماوس

لإضافة مؤشر في موقع المؤشر الخاص بك:

1. اضغط على Alt على Windows أو ⌥ على Mac.

2. انقر حيث تريد إضافة المؤشر.

مع سحب الماوس

يمكنك سحب الماوس لإضافة مؤشر إلى تحديد، تقسيم تحديد متعدد الأسطر إلى أسطر، أو تحديد أعمدة وقطع من الأكواد/المسافات البيضاء.

لإضافة مؤشر إلى تحديد الأكود من خلال السحب:

1. اضغط على Alt على Windows أو ⌥ على Mac.

2. انقر واسحب الماوس فوق تحديد الأكواد.

فوق وأسفل المؤشر الأساسي

لإضافة مؤشر مباشرةً أعلى أو أسفل المؤشر الأساسي:

1. اضغط مع الاستمرار على CtrlAlt على Windows أو ⌘⌥ على Mac.

2. اضغط على أسهم ↑ أو ↓.

للتحديدات المتطابقة

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

لإضافة مؤشر إلى جميع مطابقة جزء محدد:

1. حدد الأكواد التي تريد البحث عن مطابقتها.

2. اضغط على ShiftAltL على Windows أو Shift⌥L على Mac.

إزالة المؤشرات

يمكنك إزالة المؤشرات باستخدام اختصارات لوحة المفاتيح التالية وحركات الماوس. بدلاً من ذلك، يمكنك الخروج من تحرير المؤشر المتعدد بالضغط على Esc.

في موقع الماوس

لإزالة مؤشر:

1. اضغط مع الاستمرار على Alt على Windows أو ⌥ على Mac.

2. انقر على المؤشر الذي تود إزالته.

الأكثر إضافة حديثًا

لإزالة المؤشر الأخير الذي تمت إضافته، اضغط على CtrlU على Windows أو ⌘U على Mac.

نسخ ولصق المؤشرات

يتضمن نسخ تحديد الأكواد المؤشرات الموجودة فيه. يعتمد سلوك اللصق على عدد المؤشرات في المصدر وعدد المؤشرات في الوجهة:

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

التنسيق عند الكتابة

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

إعدادات المحرر

تتوافر العديد من خيارات التخصيص عبر علامة تبويب محرر السكريبت في إعدادات الاستوديو. تشمل الخيارات الشائعة التي يتم تعديلها:

اختصارات لوحة المفاتيح

يمتلك محرر السكريبت الاختصارات التالية.