LiaDesarrolladores

Paquetes

Crea una app Lia con configuración guiada del terminal, inicio de sesión aprobado por el navegador y registro automático de la app privada. Elige entre nueve integraciones de frameworks.

#Crear un proyecto

npm create @lia-labs/app@latest

Lia Developer Studio te guía a través de tu proyecto, framework, plantilla, configuración y cuenta. Usa las teclas de flecha para elegir tu framework y Inicio o SDK área de prueba. Recomendado configuraciones habilitan la simulación del navegador local e instalan las dependencias con el gestor de paquetes que estás utilizando. Personalizar le permite cambiar la aplicación pública ID, gestor de paquetes, simulación local y preferencia de instalación. La configuración valida su directorio antes de crear archivos, muestra el progreso de la instalación e imprime comandos de recuperación si falla la instalación. Presione Ctrl+C para cancelar. Los directorios existentes no vacíos nunca se sobrescriben.

Usa una versión de Node LTS compatible: se recomienda Node 22.12+ o 24+. Los iniciadores seleccionan versiones de framework compatibles con las ligaduras actuales de Lia, incluyendo Preact 10 y Solid 1.

cd my-lia-app
npm install
npm run dev

Saltar npm install si ya se instalaron las dependencias. Use los comandos correspondientes para su gestor de paquetes seleccionado.

#Conecta tu cuenta Lia

Después de crear tus archivos, elige Conectar & registrar para abrir Lia Developers en tu navegador. Inicia sesión con tu cuenta Lia, compara el código mostrado en el terminal y aprueba la solicitud. Tu aplicación se crea como un listado privado de prueba en tu panel de desarrollador. Elige Sigue construyendo localmente, o pasar --local, para registrarse más tarde.

npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest apps

¿Ya tienes un proyecto generado? Regístralo desde el directorio del proyecto:

npx @lia-labs/create-app@latest register --name "My game" --kind game

También puedes crear y registrar en un solo comando:

npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind game

El registro no requiere alojamiento aún. Hasta que agregues un HTTPS URL desplegado en el panel de control, abrir la lista muestra un marcador de posición de configuración. Usa --url https://your-app.example al registrarse si el alojamiento está listo. Registrar una aplicación ID que ya posees vincula el proyecto a ese listado sin editarla; un ID propiedad de otra persona es rechazado. Gestiona los cambios de URL, arte, probadores y revisión en el panel.

La aplicación pública ID se guarda en lia.config.json y la configuración del marco generado. El registro agrega información de tablero y nombre de host a ese archivo. Las credenciales de la cuenta se almacenan por separado en tu computadora; nunca se escriben en el proyecto o en el código de navegador generado.

Un código de aprobación de navegador expira después de diez minutos. El acceso terminal dura hasta treinta días y puede listar sus aplicaciones, crear listados privados de prueba y conectar previas locales a sus aplicaciones de prueba privadas. No puede publicar aplicaciones, leer claves del servidor o realizar pagos. Use Terminales conectados en el panel de control para revocar un terminal inmediatamente, o iniciar sesión desde la línea de comandos:

npx @lia-labs/create-app@latest logout

Solo apruebes un código que hayas comenzado tú mismo. Las exigencias de acceso para desarrolladores existentes siguen aplicando; el inicio de sesión desde terminal no evita el proceso de invitación. Si el navegador no se abre automáticamente, usa login --no-browser y abre el enlace impreso tú mismo. Las solicitudes rechazadas o caducadas se pueden reintentar con login.

#Vista previa de tu aplicación local dentro de Lia

Desde su proyecto registrado, ejecute:

npx @lia-labs/create-app@latest dev

El CLI inicia el servidor de desarrollo de tu framework, abre un túnel Cloudflare temporal y lo conecta a tu lista de prueba privada. Abre la aplicación nuevamente en Lia bajo Apps → Pruebas. Las ediciones posteriores usan el recarga en vivo de su framework, por lo que puede seguir probando en su teléfono mientras cambia archivos locales. No se necesita cuenta Cloudflare ni configuración DNS.

Si Cloudflare Tunnel no está instalado, Lia descarga el asistente oficial en su caché de usuario y comprueba la suma de verificación de la versión antes de ejecutarlo. No instala un servicio en segundo plano. Elija otro puerto con --port 4201, o un gestor de paquetes con --pm pnpm.

El panel en vivo muestra tu servidor local, el túnel HTTPS y la aplicación Lia conectada. Presiona o para abrir el enlace de la aplicación, d para su panel de control, o q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.

Tu página permanente URL sigue sin cambios. Detenerla elimina la conexión de vista previa, y un terminal perdido expira su conexión en dos minutos. Las vistas previas locales solo funcionan con aplicaciones de prueba privadas y no pueden reemplazar una aplicación en vivo. Implementa un alojamiento permanente HTTPS antes de enviar para revisión.

El túnel temporal URL es público para cualquiera que lo tenga, mientras que la lista Lia permanece restringida a tus probadores existentes. Mantén secretos de producción y datos privados de clientes fuera de las vistas previas en el navegador local. Los túneles rápidos son infraestructura de desarrollo sin garantía de disponibilidad.

#Preferencias de terminal

La interfaz se adapta a terminales más pequeños. Establece NO_COLOR=1 para colores planos, LIA_NO_MOTION=1 para reducir la animación de progreso, o ACCESSIBLE=1 para mensajes de texto estándar. CI y la salida redirigida permanecen estáticas. El CLI informa los pasos reales de configuración en lugar de un porcentaje simulado.

#Elija un framework

MarcoComandoLia integración
Plano TypeScriptnpm create @lia-labs/app@latest my-app -- --framework vanillaLlamadas a SDK con tipos definidos y estado observable.
Reactnpm create @lia-labs/app@latest my-app -- --framework reactuseInit, usePlayer, useLanguage, useMainButton.
Preactnpm create @lia-labs/app@latest my-app -- --framework preactHooks de Preact y las ligaduras Lia de Preact.
Vuenpm create @lia-labs/app@latest my-app -- --framework vueComposables, refs y limpieza de componentes.
Sveltenpm create @lia-labs/app@latest my-app -- --framework svelteAlmacenes de Svelte y controles con ámbito de componente.
Sólidonpm create @lia-labs/app@latest my-app -- --framework solidAccesores, createInit y createMainButton.
Angularnpm create @lia-labs/app@latest my-app -- --framework angularUna aplicación Angular independiente con señales inyectadas.
Componentes webnpm create @lia-labs/app@latest my-app -- --framework elements<lia-app>, <lia-main-button> y el SDK tipado.
Puente de nivel inferiornpm create @lia-labs/app@latest my-app -- --framework bridgeTipado avanzado request, send y ejemplos de eventos.

Angular usa su constructor de aplicaciones. Otros inicios usan Vite. Todos los inicios usan TypeScript; los archivos de componentes específicos del framework se incluyen para que puedas adaptar la integración directamente.

#Empieza con un demo de SDK funcional

Añadir --template demo para un catálogo de características interactivas en su marco:

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 demo

Las demostraciones del Framework incluyen diálogos, vibraciones, identidad, renovación de sesión, compras de prueba, anuncios recompensados / intersticiales / de banner / nativos, compartición, almacenamiento, captura de medios, biométricos, escaneo de QR, controles de pantalla, recordatorios y puntuaciones. Cada acción tiene código, retroalimentación de carga y un informe de respuesta. Las funciones no compatibles y las cancelaciones de permisos se manejan sin que se produzca un fallo. Los tokens de sesión y el contenido de los archivos se omiten del informe.

El demo avanzado del puente se centra en mensajes con tipos definidos. Los demos de framework usan sus respectivas ligaduras para identidad de jugador reactiva, idioma y controles nativos; comparten ejemplos de características con tipos, no un iframe que envuelva el demo de JavaScript sin procesar.

También puedes abrir el SDK demo dentro de Lia bajo Apps → Pruebas. Cada desarrollador registrado tiene acceso sin necesidad de un permiso separado para pruebas. El recorrido de bienvenida del portal y el enlace del tablero lo llevan allí.

#Simulación en navegador y pruebas reales

Instalaciones de desarrollo local mockLia() solo fuera de Lia. Los pagos, anuncios y recompensas están simulados; no se crea ninguna sesión o pago real. Las construcciones de producción omiten el mock de desarrollo. Angular reemplaza su módulo de desarrollo; los inicios de Vite usan la bandera de desarrollo de la construcción.

Desactivar la simulación con --no-mock. Para proyectos Vite, también puedes configurar VITE_LIA_MOCK=false en un entorno de desarrollo local. Los permisos nativos y el hardware aún necesitan pruebas dentro de Lia.

  1. Ejecutar npm run build y alojar la salida sobre HTTPS (dist/, o dist/browser/ para Angular).
  2. Regístrate a través de CLI o crea la aplicación en portal de desarrollador. Establezca su HTTPS URL desplegado antes de probarlo. Una aplicación ID en código solo no registra un listado o autentica solicitudes.
  3. Tú y hasta cinco testers adicionales lo encontrarán bajo Apps → Pruebas, independientemente de su categoría de publicación.
  4. Para el ejemplo de compra, cree un demo-coins probar el producto en el portal.
  5. Guarda una aplicación de prueba con Configuración → Archivar aplicación. Desaparece de la lista de aplicaciones nativas de todos y se puede restaurar sin eliminar la configuración ni los datos de prueba.

La liberación pública requiere revisión. El acceso para desarrolladores abiertos está planeado para el trimestre 1 2027; el CLI no evita los requisitos actuales de invitación o publicación.

#Mantenga las decisiones valiosas en su servidor

Nunca confíes en llamadas de retorno del cliente, puntajes, valores de almacenamiento local o eventos de cierre de anuncios para otorgar moneda, artículos o recompensas. Mantén las claves del servidor y los secretos de webhook fuera del código del navegador y todos VITE_* variables.

El iniciador no finge la verificación del servidor ni incluye un punto de entrega inseguro. Las compras de demo y las entregas de puntuación están restringidas al modo de prueba. Añade un backend que verifica sesiones, comprueba cada cargo de la aplicación, jugador, producto, modo y estado, entrega una vez y confirma la entrega. Mantenga separados los registros de prueba y de producción.

#Gestores de paquetes y automatización

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 solid

Para scripts o CI:

npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --local

La configuración no interactiva permanece local a menos que lo indiques --register; registrarse sin mensajes de aviso requiere un inicio de sesión existente en terminal. Use --install para instalar automáticamente. --help lista las opciones. Si la instalación falla, los archivos generados permanecen disponibles y CLI imprime el comando para reintentar.

#Añadir un backend seguro

Ejecutar npx @lia-labs/create-app@latest backend para un proyecto de servidor separado en TypeScript/JavaScript, Python, PHP o Go. Elija Node/Express, FastAPI/Django, PHP HTTP o Go HTTP. Estos inicios incluyen sesiones de jugador verificadas, webhooks firmados, verificaciones de cargos pagados e inventarios persistentes con recibos únicos. Mantenga los secretos del servidor fuera de su frontend. Vea paquetes de backend y guías de integración del framework.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés

Escribe para buscar en cada página, método y punto final.