Paquets
Ensembles de démarrage & SDK démos
Copier la page
Créez une application Lia avec une configuration du terminal guidée, une connexion approuvée par le navigateur et une inscription automatique de l'application privée. Choisissez parmi neuf intégrations de framework.
#Créer un projet
npm create @lia-labs/app@latestLia Developer Studio vous guide dans votre projet, votre framework, votre modèle de départ, votre configuration et votre compte. Utilisez les touches fléchées pour choisir votre framework et Démarrage ou SDK zone de test. Recommandé paramètres permettent de simuler le navigateur local et d'installer les dépendances avec le gestionnaire de paquets que vous utilisez. Personnaliser vous permet de modifier l'application publique ID, le gestionnaire de paquets, les préférences de simulation locale et d'installation. L'installation vérifie votre répertoire avant de créer les fichiers, affiche la progression de l'installation et imprime les commandes de récupération si l'installation échoue. Appuyez sur Ctrl+C pour annuler. Les dossiers existants non vides ne sont jamais écrasés.
Utilisez une version Node LTS prise en charge : Node 22.12+ ou 24+ est recommandé. Les starters sélectionnent les versions de framework compatibles avec les liaisons Lia actuelles, y compris Preact 10 et Solid 1.
cd my-lia-app
npm install
npm run devIgnorer npm install si les dépendances sont déjà installées. Utilisez les commandes correspondantes pour votre gestionnaire de paquets sélectionné.
#Connectez votre compte Lia
Après avoir créé vos fichiers, choisissez Connectez-vous & enregistrer pour ouvrir Lia Developers dans votre navigateur. Connectez-vous avec votre compte Lia, comparez le code affiché dans le terminal, et approuvez la demande. Votre application est créée comme une liste privée de test dans votre tableau de bord développeur. Choisissez Continuez à développer localement, ou passer --local, pour s'enregistrer plus tard.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsAvez-vous déjà un projet généré ? Enregistrez-le à partir du répertoire du projet :
npx @lia-labs/create-app@latest register --name "My game" --kind gameVous pouvez également créer et enregistrer en une seule commande :
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameL'inscription ne nécessite pas encore d'hébergement. Jusqu'à ce que vous ajoutiez un HTTPS URL déployé dans le tableau de bord, l'ouverture de l'annonce affiche un espace réservé de configuration. Utilisez --url https://your-app.example lors de l'enregistrement si l'hébergement est prêt. L'enregistrement d'une application ID que vous possédez déjà relie le projet à cette liste sans le modifier ; un ID appartenant à quelqu'un d'autre est rejeté. Gérez les modifications URL, l'artwork, les testeurs et la revue dans le tableau de bord.
L'application publique ID est sauvegardée dans lia.config.json et la configuration du framework générée. L'enregistrement ajoute des informations sur le tableau de bord et le nom d'hôte à ce fichier. Les identifiants du compte sont stockés séparément sur votre ordinateur ; ils ne sont jamais écrits dans le projet ou dans le code du navigateur généré.
Un code d'approbation du navigateur expire après dix minutes. L'accès terminal dure jusqu'à trente jours et peut lister vos applications, créer des listes de tests privées et connecter des aperçus locaux à vos applications de test privées. Il ne peut pas publier d'applications, lire des clés de serveur ou effectuer des paiements. Utilisez Terminaux connectés sur le tableau de bord pour révoquer un terminal immédiatement, ou se déconnecter depuis la ligne de commande :
npx @lia-labs/create-app@latest logoutApprouvez uniquement un code que vous avez commencé vous-même. Les exigences existantes pour l'accès développeur s'appliquent toujours ; la connexion via le terminal ne contourne pas le processus d'invitation. Si le navigateur ne s'ouvre pas automatiquement, utilisez login --no-browser et ouvrir vous-même le lien imprimé. Les demandes refusées ou expirées peuvent être réessayées avec login.
#Prévisualisez votre application locale dans Lia
À partir de votre projet enregistré, exécutez :
npx @lia-labs/create-app@latest devLe CLI lance le serveur de développement de votre framework, ouvre un tunnel Cloudflare temporaire et le connecte à votre liste de test privée. Ouvrez l'application à nouveau dans Lia sous Apps → Tests. Les éditions suivantes utilisent le rechargement en direct de votre framework, vous pouvez donc continuer à tester sur votre téléphone tout en modifiant les fichiers locaux. Aucun compte Cloudflare ou configuration DNS n'est nécessaire.
Si Cloudflare Tunnel n'est pas installé, Lia télécharge l'assistant officiel dans votre cache utilisateur et vérifie sa somme de vérification de version avant de l'exécuter. Il ne installe pas de service en arrière-plan. Choisissez un autre port avec --port 4201, ou un gestionnaire de packages avec --pm pnpm.
Le panneau en direct affiche votre serveur local, le tunnel HTTPS et l'application Lia connectée. Appuyez sur o pour ouvrir le lien de l'application, d pour son tableau de bord, ou q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Votre Page permanente URL reste inchangée. L'arrêt supprime la connexion de prévisualisation, et une fenêtre de terminal perdue expire sa connexion après deux minutes. Les prévisualisations locales ne fonctionnent qu'avec des applications de test privées et ne peuvent pas remplacer une application en direct. Déployez un hébergement permanent HTTPS avant de soumettre pour examen.
Le tunnel temporaire URL est public pour quiconque en dispose, tandis que la liste Lia reste restreinte à vos testeurs existants. Gardez vos secrets de production et vos données clients privées hors des prévisualisations dans le navigateur local. Les tunnels rapides sont une infrastructure de développement sans garantie de disponibilité.
#Préférences du terminal
L'interface s'adapte aux terminaux plus petits. Définissez NO_COLOR=1 pour les couleurs simples, LIA_NO_MOTION=1 pour réduire l'animation de progression, ou ACCESSIBLE=1 pour les invites de texte standard. CI et la sortie redirigée restent statiques. Le CLI rapporte les étapes réelles de configuration plutôt qu'un pourcentage simulé.
#Choisir un framework
| Cadre | Commande | Lia intégration |
|---|---|---|
| Simple TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Appels SDK typés et état observable. |
| React | npm create @lia-labs/app@latest my-app -- --framework react | useInit, usePlayer, useLanguage, useMainButton. |
| Preact | npm create @lia-labs/app@latest my-app -- --framework preact | Les hooks Preact et les liaisons Lia Preact. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Composables, refs et nettoyage des composants. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Les magasins Svelte et les contrôles à portée de composant. |
| Solide | npm create @lia-labs/app@latest my-app -- --framework solid | Accesseurs, createInit et createMainButton. |
| Angular | npm create @lia-labs/app@latest my-app -- --framework angular | Une application Angular autonome avec des signaux injectés. |
| Composants web | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> et le SDK typé. |
| Pont de bas niveau | npm create @lia-labs/app@latest my-app -- --framework bridge | Typed avancé request, send et des exemples d'événements. |
Angular utilise son constructeur d'application. Les autres starters utilisent Vite. Tous les starters utilisent TypeScript ; les fichiers de composants spécifiques au framework sont inclus afin que vous puissiez adapter l'intégration directement.
#Commencez par un exemple SDK fonctionnel
Ajouter --template demo pour un catalogue interactif de fonctionnalités dans votre framework :
npm create @lia-labs/app@latest my-react-demo -- --framework react --template demo
npm create @lia-labs/app@latest my-vue-demo -- --framework vue --template demo
npm create @lia-labs/app@latest my-angular-demo -- --framework angular --template demoLes démonstrations du Cadre incluent des dialogues, des rétroactions haptiques, l'identité, le rafraîchissement de session, les achats tests, les publicités récompensées/interstitielles/bannière/natives, le partage, le stockage, la capture multimédia, les biométriques, la numérisation QR, les contrôles d'écran, les rappels et les scores. Chaque action dispose de code, de feedback de chargement et d'un résumé de réponse. Les fonctionnalités non prises en charge et les annulations de permissions sont gérées sans plantage. Les jetons de session et le contenu des fichiers sont omis du résumé.
Le démo avancé du pont se concentre sur les messages typés bruts. Les démos de framework utilisent leurs liaisons respectives pour l'identité du joueur réactif, la langue et les contrôles natifs ; elles partagent des exemples de fonctionnalités typées, mais pas un iframe entourant le démo JavaScript simple.
Vous pouvez également ouvrir le SDK démo à l'intérieur de Lia sous Apps → Tests. Tout développeur enregistré a accès sans avoir besoin d'une autorisation séparée pour les testeurs. La visite guidée et le tableau de bord du portail y mènent.
#Simulation du navigateur et tests réels
Installations de développement local mockLia() seulement à l'extérieur de Lia. Les paiements, les publicités et les récompenses sont simulés ; aucun véritable session ou paiement n'est créé. Les versions de production omettent le mock de développement. Angular remplace son module de développement ; les projets Vite utilisent le drapeau de développement de la build.
Désactiver la simulation avec --no-mock. Pour les projets Vite, vous pouvez également définir VITE_LIA_MOCK=false dans un environnement de développement local. Les autorisations natives et le matériel doivent encore être testés à l'intérieur de Lia.
- Exécuter
npm run buildet héberger la sortie sur HTTPS (dist/, oudist/browser/pour Angular). - Inscrivez-vous via le CLI ou créez l'application dans l' portail développeur. Définissez son HTTPS URL déployé avant de tester. Une application ID dans le code seul ne permet pas de s'inscrire ou d'authentifier les demandes.
- Vous et jusqu'à cinq autres testeurs le trouvez sous Apps → Tests, quel que soit sa catégorie de publication.
- Pour l'exemple d'achat, créez un
demo-coinstester le produit dans le portail. - Rangez une application de test avec Paramètres → Archiver l'application. Il disparaît de la liste des applications natives de tout le monde et peut être restauré sans supprimer la configuration ou les données de test.
La publication publique nécessite une revue. L'accès développeur ouvert est prévu pour le trimestre 1 2027 ; le CLI ne contourne pas les exigences actuelles d'invitation ou de publication.
#Gardez les décisions importantes sur votre serveur
Ne jamais faire confiance aux rappels clients, aux scores, aux valeurs du stockage local ou aux événements de fermeture des publicités pour accorder de la monnaie, des objets ou des récompenses. Gardez les clés du serveur et les secrets des webhooks hors du code du navigateur et de tous les VITE_* variables.
Le starter ne falsifie pas la vérification du serveur ni n'inclut de point de terminaison de livraison non sécurisé. Les achats de démo et les soumissions de score sont restreints au mode de test. Ajoutez un backend qui vérifie les sessions, vérifie chaque charge, l'application, le joueur, le produit, le mode et l'état, livre une fois et confirme la livraison. Gardez séparés les comptes de test et de production.
#Gestionnaires de paquets et automatisation
pnpm create @lia-labs/app my-app --framework vue --template demo
yarn create @lia-labs/app my-app --framework svelte
bun create @lia-labs/app my-app --framework solidPour les scripts ou CI :
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localLa configuration non interactive reste locale à moins que vous ne passiez --register; l'enregistrement sans invites nécessite une connexion terminale existante. Utilisez --install pour l'installation automatique. --help liste les options. Si l'installation échoue, les fichiers générés restent disponibles et CLI affiche la commande pour réessayer.
#Ajouter un backend sécurisé
Exécuter npx @lia-labs/create-app@latest backend pour un projet de serveur séparé dans TypeScript/JavaScript, Python, PHP ou Go. Choisissez Node/Express, FastAPI/Django, PHP HTTP ou Go HTTP. Ces starters incluent des sessions de joueur vérifiées, des webhooks signés, des vérifications de paiement et des inventaires persistants avec des reçus uniques. Gardez les secrets de serveur hors de votre interface frontale. Voir paquets de backend et guides d'intégration du framework.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais