أصلِح إخفاق نشر في المتجر

حين تعيد نافذة "انشر أو حدّث" خطأً، أو يصلك بريد منّا عن إخفاق نشر، جِد رمز خطئك أدناه واتبع الإصلاح. بمجرّد أن تدفع الإصلاح إلى مستودعك، انقر "انشر أو حدّث" مجدّدًا لإعادة الفحص فورًا، أو انتظر تشغيل المفهرِس اليوميّ التالي.

كل إخفاق مدرَج هنا شيء تستطيع إصلاحه في مستودعك. إن لم ترَ خطأك هنا، فافحص مرجع أخطاء النشر الكامل للرموز الأقلّ شيوعًا.

terms_accepted غير مضبوط

ترى هذا حين لا يحمل caputchin.json خاصتك "terms_accepted": true على المستوى الأعلى.

1. افتح caputchin.json في مستودعك.
2. اقرأ شروط تقديم المتجر.
3. أضف "terms_accepted": true على المستوى الأعلى للبيان.
4. التزِم وادفع.
5. انقر "انشر أو حدّث" مجدّدًا، أو انتظر تشغيل الفهرسة اليوميّ التالي.

يجب أن تكون القيمة البوليان true الحرفي بـ JSON. السلاسل ("true")، أو الأعداد (1)، أو حذف الحقل كلها تُحسَب غير مقبولة.

الرخصة ليست على القائمة الموافَق عليها

ترى هذا حين يكون license مفقودًا، أو مشوّهًا، أو يسمّي معرّفًا خارج قائمتنا الموافَق عليها.

1. اختر معرّف SPDX من القائمة الموافَق عليها يغطّي كودك وأصولك المضمَّنة فعلًا.
2. افتح caputchin.json واضبط حقل license على المستوى الأعلى، مثلًا "license": "MIT".
3. إن كان كودك مزدوج الترخيص، استخدم تعبير OR بـ SPDX (مثلًا "MIT OR Apache-2.0"). يجب أن يكون فرع واحد على الأقل على القائمة الموافَق عليها.
4. إن كان كودك MIT لكنه يضمّن أصول Creative Commons، استخدم AND (مثلًا "MIT AND CC-BY-4.0"). يجب أن يكون كل فرع على القائمة الموافَق عليها.
5. التزِم، وادفع، وأعد المحاولة.

إن اعتمد مشروعك على رخصة ليست على قائمتنا الموافَق عليها (الأشيع عائلة GPL، أو AGPL، أو LGPL)، فالإصلاح الوحيد إعادة الترخيص أو إزالة المكوّنات المتأثّرة. لا نستطيع منح استثناءات لكل مؤلّف.

تعذّر علينا إيجاد مستودعك

ترى هذا حين يعيد جلب بياننا 404.

أسباب وإصلاحات شائعة:

• مستودعك خاصّ. اجعله عامًّا، أو أزِل موضوع caputchin-game لتتوقّف عن الظهور في الفهرس.
• مستودعك ينقصه موضوع GitHub‏ caputchin-game. أضفه عبر قسم About في صفحة المستودع.
• مستودعك لا caputchin.json له في الجذر (أو، للألعاب الأبناء في مجموعة، لا caputchin.json في مجلّد الورقة).
• رابط المستودع الذي أدخلته خطأ. استخدم owner/name أو الرابط الكامل https://github.com/owner/name.

ادفع caputchin.json إلى مستودعك، ثم أعد المحاولة.

بنية البيان مشوّهة

ترى manifest-error يبدأ تفصيله باسم حقل مثل entry، أو npm، أو games، أو marketplace.support، أو run.modules[0].name.

يخبرك التفصيل بالضبط أيّ حقل خطأ:

• entry: entry must be a clean relative path: قيمة entry خاصتك تحوي اجتيازًا (../)، أو شُرَطًا مطلقة، أو سلاسل استعلام، أو فراغًا. استخدم مسارًا نسبيًّا نظيفًا للمستودع مثل dist/game.js.
• npm: npm package name is malformed: حقل npm خاصتك ليس إحداثي npm صالحًا. استخدم name أو @scope/name، أحرف وأرقام + شُرَط + نقاط + شُرَط سفلية فقط.
• games[i] must be a relative path inside the repo: مسار ابن في مصفوفة games لمجموعتك يهرب من المستودع. استخدم مسارات مثل packages/leaf-memory، لا ../external أو /abs/path.
• run.entry must be a clean relative path: قاعدة النظافة نفسها كـ entry، مطبَّقة على مدخل run المقسّم الاختياري.
• run.modules[i].name: يجب أن يطابق اسم الوحدة [a-zA-Z0-9_-]+\.(wasm|js)$ ولا يمكن أن يكون entry.js أو artifact.js.

حرّر الحقل المسمّى حسب القاعدة، والتزِم، وادفع، وأعد المحاولة.

marketplace.author بريد غير صالح

ترى هذا حين يوجد marketplace.author.email لكنه لا يطابق شكل بريد عاديّ (@ واحد، ونطاق منقّط، ولا فراغ).

1. افتح caputchin.json.
2. جِد marketplace.author.email.
3. إمّا أصلِح القيمة إلى عنوان بريد حقيقي (نستخدمه فقط لإشعارات إخفاق النشر) أو أزِل الحقل كليًّا.
4. التزِم، وادفع، وأعد المحاولة.

تستطيع أيضًا إزالة كتلة marketplace.author كلها إن لم ترِد استقبال إشعارات إخفاق نشر.

أداة run خاصتك غير حتمية

ترى هذا حين يشغّل اختبار المطابقة السريع دالة run(seed, trace) للعبتك ولا تنتج حُكمًا مطابقًا.

مهمّ: هذا ليس إخفاق نشر قاتلًا. لعبتك ما زالت مدرَجة في تصفّح المتجر وقابلة للتضمين. تُظهر فقط غير قابلة للإعادة ولا تستطيع حراسة مفتاح موقع حتى تُصلَح مشكلة الحتمية.

أسباب شائعة:

• محاكاتك تقرأ Date.now()، أو performance.now()، أو Math.random()، أو متغيّرات عامة أخرى غير حتمية.
• محاكاتك تقرأ حالة خارجية (DOM، شبكة، تخزين) لا نقدّمها وقت إعادة التشغيل.
• محاكاتك تعتمد على حساب فاصلة عائمة يختلف بين زمني التشغيل.

أصلِح المحاكاة لتكون دالة نقية للبذرة والأثر، وادفع، وأعد المحاولة. انظر عقد إعادة التشغيل لقاعدة الحتمية، وفكّر في عدّة المحرّك الاختيارية، التي تقدّم PRNG قابلًا للبذر حتميًّا وساعةً.

فشل جلب الحزمة

ترى هذا حين لا يمكن جلب رابط الحزمة المثبَّت بـ entry و/أو npm، أو يعيد غير 2xx، أو يتجاوز 12MB.

• إن دفعت نسخة جديدة للتوّ: قد لا يكون الـ CDN قد انتشر بعد. انتظر دقيقة وأعد المحاولة.
• إن كانت حزمتك فوق 12MB: قلّم الأصول، أو قسّم إلى وحدات عبر إعلان run، أو انقل الأصول الكبيرة إلى مسار تسليم مختلف.
• إن لم تُنشَر حزمة npm خاصتك بعد: انشرها أولًا؛ لا نستطيع جلب نسخ غير منشورة.

طلبات نشر كثيرة جدًّا

ترى هذا على نافذة النشر اليدوي حين تكون قد قدّمت أكثر من عشرة طلبات في الـ 60 ثانية الأخيرة.

انتظر 60 ثانية وأعد المحاولة. لا طريق لرفع الحدّ؛ يحمي نقطة الوصول من الإساءة.

إيقاف رسائل الإشعار

إن أردت إيقاف استقبال بريد إخفاق النشر، انظر شروط التقديم القسم 10. عنوان المستلِم هو marketplace.author.email خاصتك في البيان؛ إزالته أو تغييره يوقف الرسائل.

انظر أيضًا

• مرجع أخطاء النشر الكامل
• انشر إلى المتجر
• شروط تقديم المتجر