DeHub › الوثائق

حل مشكلات المطوّرين في DeHub

أكثر المشكلات شيوعًا وكيف تحلّها. يخبرك المدقّق في dehub.io/apps/dev بكلمات بسيطة أي حقل خاطئ، لذا ابدأ من هناك.

مشكلات ملف البيان

الرسالة	الحل
غير موجود في /.well-known/dehub.json	انشر الملف على هذا المسار بالضبط عبر https. كثير من الاستضافات تخفي المجلدات التي تبدأ بنقطة؛ اسمح بـ `.well-known`.
موجود، لكنه ليس JSON صالحًا	الصق الملف في مدقّق JSON. الفواصل الزائدة في النهاية هي السبب المعتاد.
يجب أن يكون homeUrl على نطاقك	`homeUrl` يجب أن يكون على النطاق نفسه الذي يقدّم ملف البيان.
ownership.signature: موقّع من 0x…، لا من 0x…	وقّع بالمحفظة نفسها التي وضعتها في `ownership.address`، أو استخدم زر «توقيع» في /apps/dev.
يجب تقديم التطبيق عبر https	لا يعمل localhost وhttp إلا في معاينة المطوّر (تشغيل في /apps/dev)، وليس عند الإرسال.

عند تشغيل التطبيق

المشكلة	الحل
شاشة البداية تبقى 8 ثوانٍ	استدعِ `dehub.ready()` بمجرد ظهور شاشتك الأولى.
`Not running inside dehub`	فُتحت الصفحة منفردة. افحص `dehub.isInDehub()` واعرض نسخة ويب عادية.
`signin` خطأ	الشخص لم يسجّل الدخول إلى DeHub. اطلب منه تسجيل الدخول، أو دعه يستخدم تطبيقك كضيف.
`unsupported` في pay أو addApp	لا يمكن لمعاينات المطوّر استقبال المدفوعات ولا إضافتها. أرسل التطبيق أولًا.
يبدو التطبيق ممطوطًا على الحاسوب	لا ينبغي ذلك: يشغّل DeHub التطبيقات المصغّرة في عمود بعرض الهاتف. صمّم لعرض 375–430 بكسل.
الروابط لا تفعل شيئًا	استخدم `dehub.actions.openUrl(url)` للروابط الخارجية؛ لا تستطيع التطبيقات المصغّرة التنقل في تبويب DeHub.

على خادمك

المشكلة	الحل
يفشل الرمز بخطأ في الجمهور (audience)	اضبط `audience` على نطاق تطبيقك بالضبط، دون `https://` ودون مسار.
يفشل الرمز بخطأ انتهاء الصلاحية	الرموز صالحة لساعة. استدعِ `dehub.auth.getToken()` مجددًا؛ تجدّده SDK.
تم تخطي الإشعارات بسبب `notAdded`	لا يتلقى الإشعارات إلا من أضاف تطبيقك. اطلب ذلك عبر `dehub.actions.addApp()`.
تم تخطي الإشعارات بسبب `rateLimited`	واحد كل 30 ثانية وعشرة يوميًا لكل شخص. اجمع التحديثات في إشعار واحد.
الخطأ 429 من واجهة REST	انتظر عدد الثواني في `x-ratelimit-reset-*` قبل إعادة المحاولة.

مدونة DeHub · الصفحة الرئيسية لـ dehub.io