Packages

Ang Lia SDK para sa apps na may build step. Bawat tampok bilang typed, tree-shakeable export, na may parehong checks at error codes tulad ng script tag, at state na maaaring i-watch.

npm install @lia-labs/sdk

#Simulan

import { init, isLia, mockLia, ready } from '@lia-labs/sdk';

if (!isLia()) mockLia(); // building in a desktop browser

const me = await init();
render(me);
ready();

init(options?) tawag Lia isang beses at sumagot sa parehong resulta na Lia.init(); pag-uulit nito ay magbibigay ng unang resulta. Ito din:

• panatilihin ang --lia-* CSS variables kasalukuyan sa iyong pahina (i-off sa { cssVars: false }, o tumawag bindCssVars() sarili mo),
• naka-ayos ang iyong pahina's lang at dir mula sa tao'ng wika at tema, at higit pa. Kapag ang iyong pahina ay inilipat, tawagan ang { documentLanguage: false }),
• panatilihin ang SDK's estado kasalukuyan mula sa Lia'ang mga event.

#Mula sa script tag hanggang sa imports

Ang lahat sa script tag's Lia ang object ay isang named export dito, na may parehong mga argumento, sagot at error codes. I-import lamang ang mga bagay na kailangan mo; ang iba ay hindi kasama sa iyong bundle.

Bawat paraan'na mga argumento, sagot at error ay nasa SDK reference.

#Pananood na estado

import { colorScheme, language, viewport } from '@lia-labs/sdk';

language.get(); // "en"
const stop = colorScheme.subscribe((scheme, previous) => repaint(scheme));
viewport.subscribe(({ height }) => resizeCanvas(height));

Isang listener ay nakikinig lamang ng mga pagbabago (hindi kailanman sa subscribe) at subscribe ibabalik ang kanyang sariling stop function. Maaari mong gumawa ng iyong sariling gamit signal(initial) at computed(sources, fn).

#Mga pindutan

Ang mga button ay gumagana tulad ng sa script tag, at dinidikta rin ang kanilang estado:

import { mainButton } from '@lia-labs/sdk';

mainButton.setParams({ text: 'Buy for 5 LIA', isVisible: true });
const stop = mainButton.onClick(buy);
mainButton.state.subscribe((s) => console.log(s.isProgressVisible));

setParams kumukuha ng camelCase mga pangalan: text, color, textColor, isVisible, isActive, isProgressVisible, hasShineEffect, position. onClick ibabalik ang isang function na tumigil sa pagpakinig. backButton.isVisible at settingsButton.isVisible maka sundan din.

Upang ipakita ang isang button lamang habang ang bahagi ng iyong pahina ay nasa screen, controlBottomButton(button, options) at controlHeaderButton(button, onClick) magbibigay sa iyo update(…) at dispose() (dispose ito ay inililipat). Ang mga framework packages ay gumagamit dito.

#Mga error

Bawat pagkabigo ay isang LiaError kasama ang code, ang parehas na mga code bilang ang tag ng script. isLiaError(error, 'cancelled') nag-check ng isang.

import { isLiaError, pay } from '@lia-labs/sdk';

try {
  await pay('extra-lives', { idempotencyKey: orderId });
} catch (error) {
  if (isLiaError(error, 'cancelled')) return;
  throw error;
}

Ang mga argumento ay sinuri bago anumang bagay ay makarating sa Lia, at ang mga pagsusuri ay i-reject ang pangako (o i-throw, para sa ilang mga kalls na walang)'hindi maaabot bumalik ng isang).

#Wala ang isang bundler

Ang package ay mayroon din isang script build na naglalagay ng lahat sa window.liaSdk:

<script src="https://unpkg.com/@lia-labs/sdk/dist/index.global.js"></script>
<script>
  liaSdk.init().then(function (me) { liaSdk.ready(); });
</script>

Gamitin ang ito o ang orihinal na script tag sa isang pahina, hindi pareho.

#TypeScript

Ang lahat ay may type, kabilang ang bawat paraan'ang iyong params at sagot, bawat event'ang data (Methods, Events, InitResult, ThemeParams, Charge, AdResult at ang natitira ay inilabas).

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles