Les problèmes les plus fréquents et comment les résoudre. Le vérificateur de dehub.io/apps/dev vous dit en clair quel champ est faux : commencez par là.
Problèmes de manifeste
Message
Solution
Introuvable à /.well-known/dehub.json
Servez le fichier exactement à ce chemin en https. Beaucoup d’hébergeurs masquent les dossiers qui commencent par un point ; autorisez .well-known.
Trouvé, mais ce n’est pas un JSON valide
Collez le fichier dans un validateur JSON. Les virgules en trop à la fin sont la cause habituelle.
homeUrl doit être sur votre domaine
homeUrl doit être sur le même domaine que celui qui sert le manifeste.
ownership.signature : signé par 0x…, pas par 0x…
Signez avec le même portefeuille que celui indiqué dans ownership.address, ou utilisez le bouton Signer sur /apps/dev.
L’app doit être servie en https
Localhost et http ne fonctionnent qu’en aperçu développeur (Lancer sur /apps/dev), pas pour soumettre.
Quand l’app tourne
Problème
Solution
L’écran de démarrage reste 8 secondes
Appelez dehub.ready() dès que votre premier écran est affiché.
Not running inside dehub
La page a été ouverte seule. Vérifiez dehub.isInDehub() et affichez une version web normale.
signin erreur
La personne n’est pas connectée à DeHub. Demandez-lui de se connecter, ou laissez-la utiliser votre app en invitée.
unsupported sur pay ou addApp
Les aperçus développeur ne peuvent pas encaisser de paiements ni être ajoutés. Soumettez d’abord l’app.
L’app paraît étirée sur ordinateur
Ce ne devrait pas être le cas : DeHub affiche les mini-apps dans une colonne de la largeur d’un téléphone. Concevez pour 375 à 430 px de large.
Les liens ne font rien
Utilisez dehub.actions.openUrl(url) pour les liens externes ; les mini-apps ne peuvent pas naviguer dans l’onglet DeHub.
Sur votre serveur
Problème
Solution
Le jeton échoue avec une erreur d’audience
Réglez audience exactement sur le domaine de votre app, sans https:// et sans chemin.
Le jeton échoue avec une erreur d’expiration
Les jetons durent une heure. Rappelez dehub.auth.getToken() ; le SDK le renouvelle.
Notifications ignorées en tant que notAdded
Seules les personnes qui ont ajouté votre app reçoivent des notifications. Demandez-le avec dehub.actions.addApp().
Notifications ignorées en tant que rateLimited
Une toutes les 30 secondes et dix par jour et par personne. Regroupez les nouveautés en une seule notification.
429 de l’API REST
Attendez le nombre de secondes de x-ratelimit-reset-* avant de réessayer.
