godot embed external editor

godot embed external editor

GDExtension الذي يسمح بتضمين محرر كود خارجي مثل Visual Studio Code مباشرة في محرر Godot الخاص بك!

دليل البدء السريع

سمات

• إرفاق وفصل برامج تحرير التعليمات البرمجية الخارجية تلقائيًا.
  • يتحقق مما إذا كان محرر التعليمات البرمجية مناسبًا للمشروع المحدد (على سبيل المثال، يتم فتح مجلد المشروع بداخله) كلما أمكن ذلك.
  • زر تبديل في شريط علامة تبويب المشهد لإرفاق محرر التعليمات البرمجية الخارجي وفصله يدويًا.
• المحررين الخارجيين المعتمدين:
  • رمز Visual Studio فقط في الوقت الحالي.

بداية سريعة

• تأكد من ذلك
  • أنت تستخدم جودو 4.
  • أنت على ويندوز.
  • في إعدادات محرر Godot، تم تعطيل "وضع النافذة الواحدة" (وإلا فلن تظهر مربعات الحوار أمام محرر التعليمات البرمجية).
  • في إعدادات محرر Godot، يتم تمكين محرر التعليمات البرمجية الخارجي وإعداده بشكل صحيح (النقر المزدوج فوق ملف البرنامج النصي في مستكشف ملفات Godot يجب أن يفتح المحرر الذي تختاره).
  • عليك اتباع تعليمات الإعداد للمحرر الذي تختاره.
• قم بتنزيل واستخراج أحدث قطعة أثرية للبناء أو تجميعها من المصدر.
• انسخ مجلد addons إلى مجلد مشروع اللعبة الخاص بك.
• إذا كان Godot قيد التشغيل، فتأكد من تحديد "Project -> Reload Current Project" أو أعد تشغيل المحرر (لا يتم إعادة تحميل ملحقات GDE بشكل مباشر، راجع هذه المشكلة).
• قم بتمكين المكون الإضافي في إعدادات المشروع.
• افتح محرر التعليمات البرمجية الخاص بك عن طريق النقر المزدوج فوق ملف البرنامج النصي في مستكشف Godot (لن يتم تضمين محررات التعليمات البرمجية غير ذات الصلة في هذا الملحق) - يجب أن تختفي بعد وقت قصير من بدء التشغيل.
• قم بالتبديل إلى علامة التبويب "البرنامج النصي" واستمتع!

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

كود الاستوديو المرئي

يمكن إجراء تغييرات الإعدادات التالية إما في إعدادات المستخدم (Ctrl+Comma)، أو لكل مجلد مساحة عمل:

• اضبط window.titleBarStyle على native . وإلا فلا يمكن إخفاء شريط العنوان وسيتم تغيير حجم نافذة المحرر بشكل مستقل عن الحاوية الخاصة بها.
• تأكد من أن إعدادات window.title و window.titleSeparator تستخدم قيمها الافتراضية. اتبع هذه التعليمات إذا قمت بتعديلها:
  • يجب أن يحتوي إعداد window.title على كل من السلسلة Visual Studio Code واسم المجلد المفتوح حاليًا ${rootName} . يعد هذا ضروريًا حتى يتمكن الملحق من اكتشاف ما إذا كان المثيل قد فتح المشروع أم لا.
  • وبالمثل، يحتاج window.titleSeparator إلى مسافة بيضاء بادئة وزائدة ليعمل بشكل صحيح.

إذا كنت تفضل استخدام Visual Studio Code كمحرر نص عادي دون ميزات IDE الخاصة به، ففكر في استخدام Zen Mode:

• اضبط zenMode.centerLayout على false و zenMode.fullScreen على false .
• قم بتمكين وضع Zen عن طريق تشغيل الأمر View: Toggle Zen Mode .

القيود

هذا الملحق تجريبي للغاية ومخترق. أحاول تحسينه، ولكن هناك بعض الأشياء التي لا يمكن إصلاحها بهذه السهولة:

عام

• لا يزال لدى Godot مشكلات في اكتشاف تغييرات ملف البرنامج النصي الخارجي (راجع هذه المشكلة).
  • الحل البديل: أعد تشغيل المحرر باستخدام "Project -> Reload Current Project".
• لا يمكن عرض الوثائق في المحرر دون فصل المحرر.
  • الحل البديل: يمكنك استخدام خيار "سرد الفئات الأصلية" الخاص بـ VSCode كبديل.
• كان هناك تجميد عرضي في الماضي وحاولت إصلاحه. إذا كانت لا تزال قائمة، يرجى فتح قضية.
  • الحل البديل: إذا تعرضت للتجميد، فيبدو أن Alt+Tab يعمل على إصلاح المشكلة في معظم الأوقات.
• لا يظهر شريط عنوان المحرر بعد إلغاء الإرساء.
  • الحل البديل: تصغير النافذة واستعادتها.
• قد تحصل النافذة المضمنة على حدود نافذة أصلية ويمكن تغيير حجمها في بعض الأحيان (على سبيل المثال، عندما ينقطع مصحح الأخطاء).
  • الحل البديل: قم بإلغاء إرساء النافذة وإرسائها مرة أخرى.
• لن يتم قبول إدخال لوحة المفاتيح إلا من خلال النافذة التي يتم التركيز عليها (على سبيل المثال F5 لتشغيل اللعبة).
• لا يقوم Godot بالتبديل تلقائيًا إلى علامة تبويب البرنامج النصي.
• لا تظهر الصور المصغرة لعلامات تبويب المشهد أمام محرر التعليمات البرمجية المضمن.

كود الاستوديو المرئي

• وإلى أن يتم الانتهاء من عملية العلاقات العامة هذه ودمجها، فإن تصحيح أخطاء ألعاب Godot من خلال VSCode غير ممكن.
• نادرًا ما يظهر شريط أسود في الجزء العلوي من VSCode والذي يعوض جميع أحداث الإدخال
  • الحل البديل: أعد تشغيل VSCode لإصلاح هذه المشكلة (للأسف، حتى أمر "Reload Window" لا يحل هذه المشكلة).

المساهمة

لا أخطط للعمل في هذا المشروع لأكثر من حالات الاستخدام الشخصية، لذا سأكون ممتنًا جدًا للمساعدة من الآخرين لتحسين هذا الامتداد:

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

إنشاء مشكلات للأفكار أو التعليقات أو الأخطاء. افتح طلبات السحب إذا قمت بتنفيذ شيء ما. هو موضع تقدير كل المساعدة! :)

إذا كنت تريد أن تقول شكرًا، فيمكنك بدلاً من ذلك التبرع على رعاة GitHub.