اشحن لعبة إلى المتجر
لعبة المتجر لعبة تبنيها مرة ويستطيع أي أحد تضمينها: تنشر مستودع GitHub عامًّا، فتفهرسه المنصّة، ويبلغها المستخدمون بمعرّف لعبتها بلا تدخّل منك. هذا الطرف المقابل من اللعبة المخصّصة، التي تستخدمها أنت وحدك وتستضيفها بنفسك. هذا القسم هو الدليل المفصّل، ابنِ-وانشر، لمسار المتجر.
إن أردت لعبة لمفاتيح مواقعك أنت فقط، فأنت تريد تطوير لعبة مخصّصة بدلًا. تعال هنا حين تريد توزيع لعبة إلى كل مستخدم Caputchin.
خطّ الأنابيب كله
كل صندوق يقابل صفحةً في هذا القسم:
| القطعة | ما هي | الصفحة |
|---|---|---|
| اللعبة | حزمة JS مكتفية بذاتها مبنيّة مقابل SDK اللعبة تعمل في إطار iframe المعزول للأداة. | ابنِ لعبة المتجر، ومرجع الـ SDK |
| البيان | caputchin.json في جذر المستودع يصف اللعبة، وتهيئاتها، وحزمتها. | بيان caputchin.json |
| عقد إعادة التشغيل | run(seed, trace) -> verdict حتمي يعيد الخادم تشغيله للوصول إلى القرار الموثوق. | عقد إعادة التشغيل |
| عدّة المحرّك | عدّة تأليف اختيارية تنتج run مطابقًا من مُختزِل عادي. | عدّة engine-kit |
| النشر | وسِم المستودع، فيكتشفه المفهرِس ويثبّته، واختياريًّا أتمِته بـ CI. | انشر إلى المتجر |
قابلة لإعادة التشغيل مقابل غير قابلة
أهمّ فكرة واحدة على هذا المسار: تستطيع لعبة المتجر حراسة التحقّق فقط إن كانت قابلة لإعادة التشغيل على الخادم. حين يبتلع المفهرِس لعبتك يشغّل فحصًا ذاتيًّا لإعادة التشغيل: يحمّل أداة run بلا واجهة في عازل مختوم ويؤكّد أنها تنتج حُكمًا صالحًا.
- يجتاز الفحص الذاتي ← اللعبة قابلة لإعادة التشغيل: تُعاد جولة لاعب حقيقي على الخادم للوصول إلى القرار، فتستطيع اللعبة حراسة مفتاح موقع.
- يفشل الفحص الذاتي ← تُظهر اللعبة غير قابلة للإعادة. ما زالت مدرَجة وقابلة للتضمين، لكن كتجربة استخدام فقط (لا بوّابة أمان) حتى تنشر نسخة تجتاز. المواقع التي على نسخة أقدم قابلة لإعادة التشغيل تبقي تلك اللقطة بالضبط.
لهذا الحتمية ليست صقلًا اختياريًّا: إنها الخطّ بين لعبة تستطيع حراسة مفتاح موقع وأخرى زخرفية فحسب.
كيف تختلف لعبة المتجر عن لعبة مخصّصة
| لعبة المتجر | لعبة مخصّصة | |
|---|---|---|
| من يستطيع تضمينها | أي أحد، بمعرّف اللعبة | أنت وحدك |
| الاستضافة | مثبَّتة من المنصّة من GitHub / npm خاصتك | تستضيف الحزمة (game-src) |
| مخطّط التخصيص | مُعلَن في caputchin.json | مُعلَن على لوحة التحكّم |
| أداة إعادة التشغيل | مفهرَسة من run في البيان | مرفوعة على لوحة التحكّم |
| الاكتشاف | المتجر قابل للتصفّح | لا شيء |
من أين تبدأ
إن لم تبنِ لعبة Caputchin قطّ، فاقرأ ابنِ لعبة المتجر من أعلى إلى أسفل، ثم عقد إعادة التشغيل. حين تكون جاهزًا للشحن، اتبع انشر إلى المتجر. عدّة المحرّك اختيارية ويمكن تخطّيها كليًّا.
انظر أيضًا
- ابنِ لعبة المتجر: درس البناء.
- عقد إعادة التشغيل: ما الذي يجعل لعبة قابلة لإعادة التشغيل.
- انشر إلى المتجر: وسِم، وافهرس، وأتمِت.
- تطوير لعبة مخصّصة: البديل المستضاف ذاتيًّا، لمفاتيحك-فقط.