ruby2d
v0.12.1
هذا هو جوهر Ruby 2D. تحقق من موقع Ruby 2D لمعرفة كيفية البدء في بناء تطبيقات ثنائية الأبعاد في Ruby.
للعمل على الأحجار الكريمة محليًا ، قم أولاً بتشكيل هذا الريبو باستخدام:
git clone --recursive https://github.com/ruby2d/ruby2d.git للحفاظ على حجم مستودع رمز المصدر هذا صغير ، يتم استخدام العارض الفرعي GIT للإشارة إلى الأصول. يضمن العلم --recursive أن يتم تهيئة العارض الفرعي وتحديثه عند استنساخ هذا الريبو. إذا صادفك استنساخ هذا الريبو بدون --recursive يزال بإمكانك تهيئة وتحديث العلامات الفرعية مع:
git submodule init
git submodule update --remote قم بتحديث هذه المكونات الفرعية في أي وقت باستخدام git submodule update --remote أو مهمة rake update .
بعد ذلك ، قم بتثبيت التبعيات باستخدام Bundler عن طريق تشغيل bundle install للحصول على الأحجار الكريمة للتطوير.
أخيرًا ، قم بتشغيل rake لإنشاء وتثبيت الأحجار الكريمة محليًا. استخدم rake dev لإنشاء مكتبات مرجعية للمستخدم (مثل SDL).
يستخدم Ruby 2D مزيجًا من الاختبارات الآلية عبر RSPEC واختبارات تفاعلية يدوية للتحقق من صحة وظائف البصرية والصوتية والمدخلات. قم ببناء الجوهرة وقم بتشغيل جميع الاختبارات الآلية باستخدام أمر rake . قم بإنشاء وتشغيل اختبار تفاعلي في test/ الدليل باستخدام rake test:<target> <name_of_test> ، على سبيل المثال:
# Run `test/testcard.rb` using the standard Ruby interpreter, MRI (CRuby)
rake test:cruby testcard # `test:mri` or just `test` work also
# Build `test/audio.rb` using mruby and run
rake test:mruby audio
# Build `test/mouse.rb` for the web using WebAssembly and run in the default browser
rake test:wasm mouseRuby 2D هو مشروع مفتوح المصدر بالكامل (بما في ذلك تبعياته) التي صممها الأشخاص المتفانون الذين يعتقدون أن إنشاء تطبيقات ثنائية الأبعاد يجب أن يكون بسيطًا وطبيعيًا ومبهجًا ، بروح لغة الياقوت نفسها.
إذا كنت ترغب في المشاركة ، فهناك عدد من الطرق للقيام بذلك:
اقتراح وتنفيذ ميزات جديدة. ؟ Ruby 2D يفعل الكثير بالفعل ، ولكن هناك الكثير من الأشياء الجديدة التي يمكن أن تفعل. إذا كان لديك طلب ميزة ، أو اقتراحًا حول كيفية تحسين اللغة الخاصة بالمجال ، أو أي شيء آخر لإضافة أو إزالة أو تغيير ، فتح مشكلة جديدة وإخبارنا بذلك. إذا كنت ترغب فقط في التحدث بشكل عرضي من خلال فكرة دون ضغط فتح مشكلة ما ، فأرسل ملاحظة إلى القائمة البريدية أو الدردشة معنا على Gitter.
أضف الدعم لمزيد من المنصات. يهدف Ruby 2D إلى أن تكون منصة متقاطعة تمامًا. ساعدنا في اختبار وتحسين تجربة المطورين على المنصات الحالية وإضافة المنصات الجديدة.
العثور على المشكلات وإصلاحها. ؟ سيكون مساعدتك في تحديد وتوحيد الأخطاء ، وتحسين الأداء على طول الطريق ، أمرًا بالغ الأهمية لضمان حصول الآخرين على تجربة قوية باستخدام المكتبة. تحقق من تعقب القضية والحصول على ذلك!
كتابة ومراجعة الوثائق. من الأهمية بمكان لنجاح كل مشروع مفتوح المصدر الوثائق. لقد بدأنا بداية لائقة ، ولكن هناك دائمًا المزيد للكتابة والتعديل. تصفح عبر موقع Ruby 2D ومساعدتنا في تحديد المناطق لإضافة وضوح أو ملء الثغرات. في الجزء العلوي من معظم الصفحات ، سترى رابطًا لـ "اقتراح تحرير" ينتقل مباشرة إلى الملف المصدر في موقع الويب الخاص بـ REPO.
إنشاء الأمثلة وتحسينها. ؟ نحن حاليًا القليل من الضوء على عينة تطبيقات مساعدة الأشخاص في البدء. نود أن نحصل على أفكارك لتطبيقات ملفات واحدة صغيرة لتوجيه المستخدمين من خلال ميزات أو تقنيات محددة ، والتي نجمعها في مستودع الأمثلة. تحقق من العرض لمعرفة ما يبنيه الناس ويحصلون على بعض الإلهام.
من أجل تحقيق مثل هذه البساطة ، يجب أن يحدث الكثير تحت الغطاء. سواء أكان إضافة ميزة أو إصلاح خطأ ، حاول القيام بما يلي لضمان دمج طلب السحب الخاص بك. قد يبدو بعضها شاقًا ، لكننا سعداء بالمساعدة على طول الطريق!
تحقق مما إذا كانت هناك مشكلة موجودة ، وإذا لم يكن الأمر كذلك ، افتح مشكلة جديدة لبدء مناقشة. قبل تخصيص الوقت والطاقة لفكرة أو إصلاح ، دعونا نتأكد من أنها تتفق مع مبادئ وأهداف المشروع ، وأن لدينا استراتيجية قوية لتنفيذ واختبار.
استخدم مجموعة فرعية من الياقوت التي تعمل في كل مكان. تطبيقات Ruby 2D ، بطبيعة الحال ، مكتوبة في روبي. قد يختار بعض المستخدمين تسخير القوة الكاملة للغة والمكتبة القياسية والنظام الإيكولوجي للأحجار الكريمة من خلال كتابة التطبيقات المفسرة التي تستهدف التنفيذ القياسي ، التصوير بالرنين المغناطيسي. قد يرغب الآخرون في استهداف الويب عبر webassembly أو الأجهزة المحمولة أو إنشاء تطبيقات سطح المكتب الأصلي ، وكلها تستخدم تطبيقًا مختلفًا يسمى MRUBY. يهدف Ruby 2D إلى دعم جميع حالات الاستخدام هذه ، حتى مع نفس قاعدة كود التطبيق. يجب أن تدعم مساهمتك مجموعة فرعية من الياقوت المتوافقة معها وتتصرف بشكل مشابه عبر التصوير بالرنين المغناطيسي/cruby و mruby. إلى جانب قراءة الوثائق لكل تطبيق Ruby ، يمكنك أيضًا تجربة قصاصات التعليمات البرمجية على سطر الأوامر باستخدام Repls: irb للتصوير بالرنين المغناطيسي ، و mirb لـ MRUBY.
اختبار شامل التغيير الخاص بك. على عكس مكتبات Ruby الأخرى ، لا يمكن تغطية كل شيء هنا بسهولة مع اختبارات الوحدة وحدها. نحتاج أيضًا إلى التأكد من أن الأمور تبدو وصحيحًا ، وعمل المدخلات كما هو متوقع ، والسلوك متسق عبر جميع منصات دعم Ruby 2D.
rake update لتحديث العوامل الفرعية version.rb ، ارتكب التغييراتv#.#.# ، واكتب ملاحظة إصدار صغيرةrake release لبناء الأحجار الكريمة ، ثم ادفعه إلى Rubygems.org مع gem push ruby2d-#.#.#.gem
