Packages
Packages
Kopya ang pahina
Ang Lia SDK bilang npm packages. Isang typed bridge, isang tree-shakeable SDK, at bindings para sa React, Preact, Vue, Svelte, Solid, Angular at web components.
Ang tag ng script ay ang pinaka-madaliang paraan. Kung ang iyong app ay may isang build step, ang npm packages ay magbibigay sa iyo ng parehong SDK na may TypeScript types, imports na maaaring tree-shake, state na tumutugma sa iyong framework, at isang pare-pareho Lia para magawa ang paggawa nang labas ng app.
#Anong package
| Package | Gamitin ito para sa |
|---|---|
@lia-labs/sdk | Anumang app na may bundler, mayroon o walang framework. |
@lia-labs/sdk-react | React: hooks tulad ng useInit, useMainButton, useBackButton. |
@lia-labs/sdk-preact | Preact: ang parehong hooks. |
@lia-labs/sdk-vue | Vue 3: composables na nagbabalik ng refs. |
@lia-labs/sdk-svelte | Svelte 4 at 5: stores. |
@lia-labs/sdk-solid | Solid: accessors at create* mga primitibo. |
@lia-labs/sdk-angular | Angular 17 at mas bago: inject* functions at signals. |
@lia-labs/elements | Anumang pahina, walang framework: <lia-main-button> at mga kaibigan. |
@lia-labs/bridge | Ang mga mensahe sa mababang antas, para magawa ang iyong sariling layer. |
Bawat package ng framework ay re-exports ang buong SDK, kaya ang isang import ay sapat na:
npm install @lia-labs/sdk @lia-labs/sdk-reactimport { pay, useInit, useMainButton } from '@lia-labs/sdk-react';#Paano sila kumpleto
- @lia-labs/bridgeMga mensahe ng frame ng Lia, na sinulat:
request('pay', { productId }),on('theme', …). AtmockLia(), isang pangarap na Lia para sa paggawa sa isang desktop browser. - @lia-labs/sdkBawat feature bilang isang named export (
init,pay,mainButton,cloudStorage…), kasama ang parehong mga pagsusuri at error codes tulad ng script tag. Ang kanyang estado (tema, wika, viewport…) ay isang hanay ng maliit na observable na mga halaga. - Mga package ng frameworkMaliit: sila ay nagbabago ng mga halaga sa mga hook, refs, stores o signals, at nakakabit ng mga button ng Lia sa iyong mga component, na ipinapakita habang naka-mount at itinatago pagkatapos.
#State na maaari mong tingnan
Ang SDK'ang state ay isang hanay ng Readable mga halaga: get() basa ngayon, at subscribe(listener) narinig ang bawat pagbabago (kasama ang bagong at lumang halaga) at bumalik ng isang function na tumigil sa pagsubaybay. Sila ay nagsisimula mula sa Lia'ang mga event pagkatapos init().
| Halaga | Uri |
|---|---|
player | { id, name } o null bago init() |
mode | "test", "live" o null |
language, rtl | Ang tao'ng wika sa Lia, tulad ng |
colorScheme, themeParams | "light" o "dark", at Lia'na mga kulay |
viewport | { height, expanded } |
safeArea, contentSafeArea | { top, bottom, left, right } sa px |
display, isFullscreen | Paano ang app ay buksan, at kung ano ang'ang edge to edge |
startParam | Ano ang nagsimula nito, na naiayos habang bukas |
soundOn, notificationsAllowed, notificationsAvailable | Ang tao'na mga pagpili |
initialized | Kung init() ay sumagot |
Bawat package ng framework ay may kasamang hook, composable, store o signal para sa bawat isa.
#Ang script tag ay patuloy na gumagana
https://api.lialabs.org/sdk/lia-apps-v1.js (ang global Lia) ay pareho. Gamitin ito o ang packages sa isang pahina, hindi pareho: pareho ang pagpakinig para sa Lia's sagot sa parehong channel, at ang pangalawang isa na mag-load ay maaari't.
#Mga Bersyon
Ang mga package ay nagsasalita ng protocol ng SDK 1.8.1. A Lia app na mas bata kaysa sa isang tampok na sagot unknown_method; tingnan ang changelog.
Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles