Paquetes
Paquetes
Copiar página
El Lia SDK como paquetes npm. Un puente tipado, un SDK árbol-shakeable y enlaces para React, Preact, Vue, Svelte, Solid, Angular y componentes web.
El etiqueta script es el camino más rápido. Si su aplicación tiene un paso de construcción, los paquetes npm le dan el mismo SDK con TypeScript tipos, importaciones que puede tree-shakear, estado que se adapta a su framework, y un Lia falso para construir fuera de la aplicación.
#¿Qué paquete
| Paquete | Úsalo para |
|---|---|
@lia-labs/sdk | Cualquier app con un bundler, con o sin framework. |
@lia-labs/sdk-react | React: ganchos como useInit, useMainButton, useBackButton. |
@lia-labs/sdk-preact | Preact: los mismos ganchos. |
@lia-labs/sdk-vue | Vue 3: componibles que devuelven refs. |
@lia-labs/sdk-svelte | Svelte 4 y 5: stores. |
@lia-labs/sdk-solid | Sólido: accesores y create* primitivos. |
@lia-labs/sdk-angular | Angular 17 y posteriores: inject* funciones y señales. |
@lia-labs/elements | Cualquier página, sin framework: <lia-main-button> y amigos. |
@lia-labs/bridge | Los mensajes de bajo nivel, para construir tu propia capa. |
Cada paquete del framework reexporta todo el SDK, por lo que una sola importación es suficiente:
npm install @lia-labs/sdk @lia-labs/sdk-reactimport { pay, useInit, useMainButton } from '@lia-labs/sdk-react';#Cómo encajan
- @lia-labs/bridgemensajes de marco de Lia, escritos:
request('pay', { productId }),on('theme', …). YmockLia(), un Lia ficticio para construir en un navegador de escritorio. - @lia-labs/sdkCada característica como una exportación con nombre (
init,pay,mainButton,cloudStorage…), con las mismas comprobaciones y códigos de error que la etiqueta script. Su estado (tema, idioma, viewport…) es un conjunto de pequeños valores observables. - Paquetes de frameworkDelgado: convierten esos valores en ganchos, referencias, almacenes o señales, y vinculan los botones de Lia a tus componentes, mostrados mientras están montados y ocultos después.
#Estado que puedes ver
El SDK's estado es un conjunto de Readable valores: get() lee ahora uno, y subscribe(listener) escucha cada cambio (con el nuevo y el valor antiguo) y devuelve una función que deja de escuchar. Se actualizan desde Lia'los eventos después de init().
| Valor | Tipo |
|---|---|
player | { id, name } o null antes init() |
mode | "test", "live" o null |
language, rtl | La persona's idioma en Lia, y si se lee de derecha a izquierda |
colorScheme, themeParams | "light" o "dark", y Lia's colores |
viewport | { height, expanded } |
safeArea, contentSafeArea | { top, bottom, left, right } en px |
display, isFullscreen | Cómo se abrió la aplicación, y si'de borde a borde |
startParam | Lo que lo abrió, mantenido actual mientras estaba abierto |
soundOn, notificationsAllowed, notificationsAvailable | La persona's opciones |
initialized | Si init() ha respondido |
Cada paquete del framework tiene un gancho, compuesto, almacén o señal correspondiente para cada uno.
#La etiqueta script aún funciona
https://api.lialabs.org/sdk/lia-apps-v1.js (el global Lia) no cambia. Úselo o los paquetes en una página, no ambos: ambos escuchan Lia's respuestas en el mismo canal, y la segunda que carga puede't.
#Versiones
Los paquetes usan el protocolo del SDK 1.8.0. Una versión de Lia anterior a una función responde unknown_method; ver la registro de cambios.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés