LiaDéveloppeurs

Guides

Essayez tout avant le lancement. Testeurs, clés de test et faux $LIA, exécutant votre page depuis votre ordinateur, le SDK démo, et trouvant des problèmes à l'intérieur de Lia.

#Mode test

Les nouvelles applications commencent en test. Tant qu'elles le sont :

  • Seulement vous et vos testeurs pouvez ouvrir l'application. Demandez à l'équipe Lia d'ajouter des testeurs par leurs noms d'utilisateur Lia.
  • Lia'en-tête dit Test à côté de votre nom de développeur.
  • Les paiements et les récompenses utilisent des $LIA fictifs ; personne'votre solde se déplace.
  • Utilisez votre clé de test sur votre serveur. Il ne voit que les sessions de test, les charges et les joueurs.

Voir Test et live pour tout ce qui'différents.

#Exécutez-le depuis votre ordinateur

Lia n'ouvre que les pages https de votre application'son adresse, donc une page sur localhost peut'ne pas s'ouvrir directement dans Lia. Placez-le derrière un tunnel https, et demandez à l'équipe Lia de pointer votre application de test vers le tunnel'son adresse :

npx vite --port 5173
cloudflared tunnel --url http://localhost:5173

Un tunnel nommé (ou toute adresse https fixe) évite de demander une nouvelle adresse chaque fois.

#Dans un navigateur normal

En dehors de Lia, Lia.available est false et chaque appel échoue avec not_in_lia. Pour travailler sur la mise en page dans un navigateur de bureau, un petit substitut aide :

dev-lia.js
// Only when not inside Lia, and only in development.
if (!window.Lia.available && location.hostname === "localhost") {
  const fake = { player: { id: "p_dev000000000000000000", name: "you" }, session: "dev", exp: Date.now() + 9e5, mode: "test", language: "en", rtl: false, platform: "web" };
  window.Lia = Object.assign(Object.create(window.Lia), {
    init: async () => fake,
    ready() {},
    session: async () => ({ session: "dev", exp: Date.now() + 9e5 }),
    toast: async (text) => console.log("toast:", text),
    haptic: async () => null,
    pay: async (productId) => ({ chargeId: "ch_dev", productId }),
  });
}

Votre serveur a gagné'vérifier "dev" sessions, donc gardez un chemin de développement là-bas aussi, ou testez les flux du serveur dans Lia.

#La démo SDK

Lia'son propre démo application essaie chaque SDK appel et montre ce qui revient : https://api.lialabs.org/sdk/demo. Elle s'ouvre à l'intérieur de Lia pour les personnes que l'équipe ajoute comme testeurs ; demandez si vous'aimeriez essayer. Son code source est une bonne référence pour chaque appel.

#Rechercher des problèmes à l'intérieur de Lia

Lia'côté, les magasins ne'ne permet pas d'attacher un inspecteur web à votre page. À la place :

  • Afficher les erreurs à l'écran pendant les tests : un petit panneau de journal que vos testeurs peuvent prendre en photo.
  • Envoyer les erreurs à votre serveur avec l'identifiant du joueur, Lia.version, Lia.platform et l'erreur's code.
  • Vérifiez chaque rejet's code, pas seulement son message.
window.addEventListener("error", function (event) { report({ message: event.message, at: event.filename + ":" + event.lineno }); });
window.addEventListener("unhandledrejection", function (event) { report({ code: event.reason && event.reason.code, message: String(event.reason) }); });

#Avant de lancer

  • Paiements : acheter chaque produit, fermer la feuille sans payer, recharger pendant le paiement et vérifier Lia.charges() la trouve, et rembourse une.
  • Webhooks : un achat de test atteint votre gestionnaire, sa signature est vérifiée, et une deuxième livraison ne fait rien.
  • Récompenses : une clé dupliquée ne paie rien ; pool_empty et daily_limit sont gérés.
  • Notifications : demandez, envoyez, cliquez sur l'une avec votre application fermée et avec celle-ci ouverte.
  • Apparence : claire et sombre, une langue de droite à gauche (arabe), un petit téléphone, et plein écran si vous l'utilisez.
  • Votre serveur passe au clé en direct en production, et rien de vos données de test ne fuit vers le vivant.

Ensuite, demandez à l'équipe Lia de passer votre application en direct.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais

Tapez pour rechercher sur toutes les pages, méthodes et points de terminaison.