PLUA

لقد قمنا بدمج الوظيفة في مشروع Jetlua ، المتاح على https://github.com/tinybiggames/jetlua

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

؟ جدول المحتويات

• مقدمة
• الميزات الرئيسية
• ؟ الاستخدامات المحتملة
• ابدء
• ؟ تثبيت
• ؟ أمثلة الاستخدام
• ميزات متقدمة
• نظرة عامة على API
• ؟ المساهمة
• رخصة

مقدمة

Plua يقدم جسر؟ بين Delphi و Luajit ، يوفران حلاً نصفيًا قويًا لتوسيع قدرات مشاريع Delphi الخاصة بك. مع PLUA ، يمكن لمطوري Delphi الاستمتاع بجميع فوائد تضمين لغة برمجة ديناميكية وسريعة ، وسهلة الاستخدام مثل Lua ، مع الاستفادة من Luajit للأداء العالي؟ ️.

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

الميزات الرئيسية

• Bazing Fast Performance ⚡: مبني على Luajit ، يوفر PLUA سرعة استثنائية ، مما يجعله مناسبًا للتطبيقات المهمة للأداء.
• واجهات برمجة التطبيقات البسيطة : API سهلة الاستخدام لتسجيل إجراءات Delphi وتنفيذ البرامج النصية LUA.
• قابلية التشغيل البيني غير الملحومة : تمرير البيانات دون عناء بين بيئات Delphi و Lua.
• التصحيح التفاعلي ؟: استخدم dbg() في البرامج النصية LUA الخاصة بك لبدء تصحيح التصحيح التفاعلي.
• التسجيل الروتيني المخصص ➕: بسهولة إضافة إجراءات مخصصة في Delphi التي يمكن أن تتصل بها البرامج النصية Lua.
• الحد الأدنى من الإعداد : لا يتطلب سوى بضعة أسطر من التعليمات البرمجية للبدء.
• استيراد البرنامج النصي وتجميعه ؟: استخدم أمر import مخصص لدمج البرامج النصية ، وتجميعها في ملف واحد ، وقم بتخزينها اختياريًا كمورد EXE لتطبيق مستقل تمامًا.
• لا تبعيات خارجية ؟: يتم تجميع جميع التبعيات مباشرة في EXE ، لذلك لا توجد DLL خارجية للحفاظ عليها.

الاستخدامات المحتملة

• إضافة دعم تعديل : عزز تطبيقاتك من خلال السماح للمستخدمين بإنشاء تعديل.
• سير العمل الديناميكي : قم بإنشاء سير عمل مرن مع منطق الأعمال القابل للسيناريو.
• مرونة وقت التشغيل ⏱: إلغاء تحميل منطق البرامج النصية LUA لتعديل السلوك في وقت التشغيل.
• تطوير اللعبة ؟: بناء ألعاب أو محركات محاكاة مع طبقة نصية قوية.

ابدء

سيساعدك هذا القسم على الحصول على PLUA وتشغيله في بيئة دلفي الخاصة بك.

المتطلبات الأساسية

• Delphi 12 CE أو أعلى
• Windows 10 أو أعلى ؟
• تم اختباره على نظام التشغيل Windows 11 64 بت (23H2) ، Delphi 12.2 ✅

تثبيت

1. استنساخ أو تنزيل مستودع PLUA.

2. أضف ملفات مصدر PLUA إلى مشروع Delphi الخاص بك.

3. ؟ قم بتنزيل أحدث إصدار من PLUA.

4. استخراج محتويات دليل المشروع الخاص بك.

5. ➕ أضف مجلد PLUA src إلى مسار مكتبتك في دلفي.

6. في مشروعك ، قم بتضمين PLUA في شرط uses . للاستفادة من الامتدادات ، أضف PLUA.Ext بعد PLUA في شرط uses .

7. ؟ ارجع إلى مجلد examples للحصول على تعليمات الاستخدام التفصيلية وعروض مكتبة PSFML أثناء العمل.

هذا كل شيء! يجب أن تكون قادرًا الآن على بدء البرمجة النصية مع Lua في مشاريع Delphi الخاصة بك.

أمثلة الاستخدام

فيما يلي بعض الأمثلة البسيطة لإظهار كيفية دمج PLUA في مشروع Delphi الخاص بك:

تحميل وتشغيل البرامج النصية لوا؟

 var
  Lua: TLua;
begin
  Lua := TLua.Create();
  Lua.LoadString( ' print("Hello from Lua!") ' , False);
  Lua.Run();  
  Lua.Free();
end ;

تسجيل روتين دلفي لاستخدامه في لوا؟

 procedure MyDelphiRoutine (ALua: ILuaContext);
begin
  // Example routine that pushes a string result onto Lua stack
  ALua.PushValue( ' Hello from Delphi! ' );
end ;

var
  Lua: TLua;
begin
  Lua := TLua.Create();
  Lua.RegisterRoutine( ' DelphiRoutine ' , MyDelphiRoutine);
  Lua.LoadString( ' DelphiRoutine() ' , False);
  Lua.Run();
  Lua.Free();
end ;

استدعاء وظائف لوا من دلفي؟

 var
  Lua: TLua;
  Result: TLuaValue;
begin
  Lua := TLua.Create();
  Lua.LoadString( ' function greet() return "Hello from Lua!" end ' );
  Result := Lua.Call( ' greet ' , []);
  ShowMessage(Result.AsString);  
  Lua.Free();
end ;

ميزات متقدمة

يدعم PLUA أيضًا ميزات متقدمة مثل:

• تصحيح التصحيح التفاعلي ؟: إضافة dbg() في رمز LUA لبدء تصحيح الأخطاء ، مفيدة لتحديد المشكلات أثناء وقت التشغيل.
• استيراد البرنامج النصي : استخدم import لتجميع ملفات البرنامج النصي المختلفة في وحدة تجميع واحدة ، وهو أمر مفيد لحفظ البرامج النصية المترجمة وتحميلها كموارد.
• تجميع Bytecode ؟: ترجمة البرامج النصية LUA إلى Bytecode باستخدام CompileToStream() ، مما يسمح بالتغليف والتوزيع الفعال.

نظرة عامة على API

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

tlua؟

• إنشاء/تدمير : إدارة دورة حياة مثيل LUA.
• LoadStream/LoadString/Loadfile ؟: تحميل البرامج النصية Lua من مصادر مختلفة.
• يجري ▶ : تنفيذ البرنامج النصي المحمّل.
• اتصل ؟: استدعاء وظيفة لوا من دلفي.
• registerRoutine ➕: سجل روتين Delphi ليكون قابلاً للاتصال من Lua.

iluacontext

• PushValue/getValue : دفع القيم إلى أو الحصول على قيم من مكدس LUA.
• Clearstack/popstack ؟ ️: إدارة حالات المكدس بشكل فعال.
• SettableFieldValue/GetTableFieldValue ؟: Access والتلاعب جداول Lua.

المساهمة

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

رخصة

تم توزيع Plua تحت؟ ترخيص BSD-3-CASE ، مما يسمح بإعادة التوزيع والاستخدام في كل من النماذج المصدر والثنائية ، مع أو بدون تعديل ، في ظل ظروف محددة. انظر ملف الترخيص لمزيد من التفاصيل.

يدعم

• مشاكل
• المناقشات
• تعلم دلفي

---

نأمل أن يساعد Plua في جعل مشاريع Delphi الخاصة بك أكثر ديناميكية ومرونة. ترميز سعيد! ؟

مصنوع من ❤ في دلفي