Packages
Starter kits & SDK mga demo
Kopya ang pahina
Lumikha ng isang app na Lia na may gabay na terminal setup, browser-approved login at awtomatikong pribadong pagpaparehistro ng app. Pumili mula sa siyam na integrasyon ng framework.
#Lumikha ng isang proyekto
npm create @lia-labs/app@latestLia Developer Studio ang gagabay sa iyo sa iyong proyekto, framework, starter, setup at account. Gamitin ang mga pindutan ng arrow para pumili ng iyong framework at Starter o SDK playground. Rekomendado ang mga setting ay nagpapayagan ang lokal na simulation ng browser at i-install ang mga dependency gamit ang package manager na ginagamit mo. I-customize nagbibigay-daan sa iyo na baguhin ang publikong app ID, package manager, lokal na simulasyon at pagpili sa pag-install. Ang Setup ay nag-validate ng iyong direktoryo bago lumikha ng mga file, ipinapakita ang pag-unlad ng pag-install at ipinapakita ang mga command para sa pagbawi kung ang pag-install ay nabigo. Pindutin ang Ctrl+C para i-cancel. Ang mga umiiral na hindi empty na folder ay hindi kailanman ina-overwrite.
Gamitin ang isang suportadong Node LTS version: ang Node 22.12+ o 24+ ay inirerekomenda. Ang starters ay pumipili ng framework versions na kompatibleng kasama ang kasalukuyang Lia bindings, kabilang ang Preact 10 at Solid 1.
cd my-lia-app
npm install
npm run devLaktawan npm install kung ang setup ay nai-install na ang mga dependency. Gamitin ang mga angkop na command para sa iyong napiling package manager.
#Kumonekta ang iyong Lia account
Pagkatapos mag-imbist ng iyong mga file, pumili Kumonekta & mag-rehistro upang buksan ang Lia Developers sa iyong browser. Mag-sign in gamit ang iyong Lia account, ihambing ang code na ipinakita sa terminal, at i-approve ang kahilingan. Ang iyong app ay nilikha bilang isang pribadong pagsubok na listing sa iyong developer dashboard. Piliin Magpatuloy sa paggawa nang lokal, o iwan --local, para magrehistro nang huli.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsMayroon nang generated na proyekto? I-rehistro ito mula sa direktoryo ng proyekto:
npx @lia-labs/create-app@latest register --name "My game" --kind gameMaaari mo rin itakda at mag-rehistro sa isang command:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameAng pagpaparehistro ay walang kailangan ng hosting pa. Hanggang sa magdagdag ka ng isang inilabas na HTTPS URL sa dashboard, ang pagbubukas ng listing ay nagpapakita ng isang placeholder para sa setup. Gamitin ang --url https://your-app.example kapag nag-rehistro kung ang hosting ay handa na. Ang pag-rehistro ng isang app ID na iyo nang may-ari ay nakakonekta ang proyekto sa listing na iyon nang walang pagbabago; isang ID na ikinakaloob ng iba ay tinatanggihan. Pamahalaan ang mga pagbabago sa URL, artwork, testers at pagsusuri sa dashboard.
Ang pampublikong app ID ay nai-save sa lia.config.json at ang inilikha na konfigurasyon ng framework. Ang pag-rehistro ay idinagdag ang impormasyon ng dashboard at hostname sa file na iyon. Ang mga kredensyal ng account ay naka-imbak nang hiwalay sa iyong kompyuter; sila ay hindi kailanman isinulat sa proyekto o sa inilikha na browser code.
Ang isang code para sa pag-apruba ng browser ay mag-expire pagkatapos ng sampung minuto. Ang terminal access ay maaaring tumagal ng hanggang tatlong araw at maaaring mag-lista ng iyong mga app, lumikha ng pribadong mga pagsubok na listahan at mag-ugnay ng lokal na mga preview sa iyong pribadong mga app para sa pagsubok. Hindi ito maaaring mag-publish ng mga app, basahin ang mga server key o gumawa ng mga pagbabayad. Gamitin Nakonekta ang mga terminal sa dashboard para i-revoke ang terminal nang agad, o mag-sign out mula sa command line:
npx @lia-labs/create-app@latest logoutI-approve lamang ang code na iyong nagsimula mismo. Ang mga panuntunan para sa existing developer access ay nananatili; ang terminal login ay hindi nagbypass sa proseso ng pagtawag. Kung ang browser ay hindi magsisimula nang awtomatiko, gamitin login --no-browser at buksan ang iprint na link nang sarili mo. Ang mga inaprubang o nangungutya na kahilingan ay maaaring i-retry gamit ang login.
#Panoorin ang iyong lokal na app sa loob ng Lia
Mula sa iyong nakarehistrong proyekto, i-run ang:
npx @lia-labs/create-app@latest devNagsisimula ang CLI ang development server ng iyong framework, buksan ang isang temporaryong Cloudflare Tunnel at kumonekta ito sa iyong pribadong test listing. Buksan muli ang app sa Lia sa ilalim ng Apps → Pagsubok. Ang mga susunod na pagbabago ay gumagamit ng live reload ng iyong framework, kaya maaari mong patuloy na subukan sa iyong telepono habang nagbabago ang lokal na mga file. Walang kinakailangan na Cloudflare account o DNS konfigurasyon.
Kung ang Cloudflare Tunnel ay hindi nai-install, ang Lia ay i-download ang opisyal na helper sa iyong user cache at suriin ang checksum ng release nito bago ito mag-ugnay. Hindi ito nai-install ang isang background service. Pumili ng iba pang port na may --port 4201, o isang package manager na may --pm pnpm.
Ang live panel ay nagpapakita ng iyong lokal na server, HTTPS tunnel, at nakonektang Lia app. Pindutin o upang buksan ang link ng app, d para sa kanyang dashboard, o q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Ang iyong permanenteng Page URL ay hindi nabago. Ang pagpahinto ay aalisin ang preview connection, at ang isang nawalang terminal ay mag-expire ng kanyang connection sa loob ng dalawang minuto. Ang mga lokal na preview ay gumagana lamang sa pribadong test apps at hindi maaaring palitan ang isang live app. I-deploy ang permanenteng HTTPS hosting bago isumite para sa review.
Ang temporaryong tunnel URL ay pampubliko para sa sinumang mayroon ito, habang ang Lia listing ay nananatiling limitado sa iyong mga existing testers. Panatilihin ang production secrets at pribadong data ng customer sa labas ng local browser previews. Ang mga Quick Tunnels ay infrastructure ng pag-unlad na walang garantiya ng uptime.
#Mga paborito sa Terminal
Ang interface ay sumasayon sa mas maliit na terminals. I-set ang NO_COLOR=1 para sa madilim na kulay, LIA_NO_MOTION=1 upang mabawasan ang animation ng pag-unlad, o ACCESSIBLE=1 para sa karaniwang teksto. CI at ang redirected output ay nananatiling pareho. Ang CLI ay nag-uulat ng tunay na mga hakbang sa pag-ayos kaysa sa isang sinimulang porsyento.
#Pumili ng framework
| Pamamaraan | Komando | Lia pagkakasunod-sunod |
|---|---|---|
| Plain TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Typed SDK calls at observable state. |
| 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 | Preact hooks at ang Lia Preact bindings. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Composables, refs at paglilinis ng component. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Mga svelte store at component-scoped controls. |
| Solid | npm create @lia-labs/app@latest my-app -- --framework solid | Mga Accessor, createInit at createMainButton. |
| Angular | npm create @lia-labs/app@latest my-app -- --framework angular | Isang nakapag-iisang app ng Angular na may inilagay na signals. |
| Mga web component | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> at ang tinyped na SDK. |
| Mababang antas na kargador | npm create @lia-labs/app@latest my-app -- --framework bridge | Advanced typed request, send at mga halimbawa ng event. |
Gumagamit ang Angular ng application builder nito. Ang iba pang starters ay gumagamit ng Vite. Lahat ng starters ay gumagamit ng TypeScript; ang mga file ng component na nakasalalay sa framework ay kasama para makapag-ayos ka nang direkta.
#Magsimula sa isang gumaganang SDK demo
Idagdag --template demo para sa interaktibong katalógong feature sa iyong 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 demoAng mga demo ng Framework ay kasama ang mga usapan, haptics, identidad, pag-refresh ng sesyon, pagsusubok ng pagbili, inaantabayang/nakatapat/panlabas/natibong mga ad, pagbahagi, imbakan, pagkukuha ng media, biometrics, QR scanning, kontrol sa screen, mga paalala at mga puntos. Ang bawat aksyon ay may code, feedback sa paglod, at isang pagbasa ng tugon. Ang mga hindi suportadong tampok at pagkansela ng pahintulot ay naka-handle nang walang crash. Ang mga session token at nilalaman ng file ay inalis mula sa pagbasa.
Ang advanced bridge demo ay nakatuon sa raw typed messages. Ang framework demos ay gumagamit ng kanilang sariling bindings para sa reactive player identity, language at native controls; sila ay nagbabahagi ng typed feature examples, hindi isang iframe na wrapping ang plain JavaScript demo.
Maaari rin ninyong buksan ang hosted SDK demo sa loob ng Lia sa ilalim Apps → Pagsubok. Ang bawat nakarehistrong developer ay may access nang walang kailangan ng karagdagang grant para sa tester. Ang welcome tour ng portal at ang dashboard link dito.
#Simulasyon ng browser at tunay na pagsubok
Pagsakop sa lokal na pag-unlad mockLia() lamang sa labas ng Lia. Ang mga pagbabayad, ads at mga reward ay sinimula; walang tunay na sesyon o pagbabayad ang nilikha. Ang mga production builds ay ikinokonsidera ang development mock. Ang Angular ay nagpapalit ng kanyang development module; ang Vite starters ay gumagamit ng development flag ng build.
Pumutol ang simulasyon gamit ang --no-mock. Para sa mga proyekto ng Vite, maaari mo ring itakda VITE_LIA_MOCK=false sa isang lokal na environment file. Ang mga native na pahintulot at hardware ay kailangang subukan pa rin sa loob ng Lia.
- I-run
npm run buildat i-host ang output sa pamamagitan ng HTTPS (dist/, o isang ref o getter (dist/browser/para sa Angular). - Magrehistro sa CLI o lumikha ng app sa developer portal. I-set ang inilabas na HTTPS URL bago mag-test. Ang isang app ID sa code lamang ay hindi mag-rehistro ng listing o mag-authenticate ng mga kahilingan.
- Kayo at hanggang lima pang karagdagang nangungutya ay nasa ilalim ng Apps → Pagsubok, kahit ano man ang kategorya ng paglulunsad nito.
- Para sa halimbawa ng pagbili, lumikha ng aktibong
demo-coinssubukan ang produkto sa portal. - Ilagay ang isang test app sa gilid na kasama Mga Setting → I-archive ang app. Nakakalimot sa listahan ng native Apps ng lahat at maaari itong maibalik nang walang pagbura ng konfigurasyon o datos ng pagsusulit.
Ang publikong paglabas ay kailangan ng pagsusuri. Ang open developer access ay inaasahang magaganap sa Q1 2027; ang CLI ay hindi nagbypass sa kasalukuyang mga panata o mga requirement sa pagpapalabas.
#Panatilihin ang mahahalagang desisyon sa iyong server
Huwag kapani-paniwala ang mga callback ng kliyente, mga marka, mga halaga ng lokal na imbakan o mga pangyayari ng pagbubukas ng ad upang bigyan ng salapi, mga item o parangal. Panatilihin ang mga pribadong susi ng server at mga lihim ng webhook sa labas ng kodigo ng browser at lahat VITE_* mga variable.
Ang starter ay hindi naglalabas ng server verification o kasama ang isang insecure delivery endpoint. Ang demo purchases at score submissions ay limitado sa test mode. Magdagdag ng backend na nagveripika ang mga sesyon, sinuri ang bawat pagbabayad ng app, manlalaro, produkto, mode at estado, isinilang nang isang beses at kinilala ang paghahatid. Ihiwalay ang pagsusuri ng pagsubok at aktwal.
#Mga mananakop ng package at awtomatiko
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 solidPara sa mga script o CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localAng noninteractive setup ay nananatili nang lokal maliban kung ikaw ang magpapasa --register; ang pag-rehistro nang walang mga prompt ay nangangailangan ng isang umiiral na terminal login. Gamitin --install para i-install nang awtomatiko. --help naglalista ng mga opsyon. Kung ang pag-install ay nabigo, ang mga nilikha na file ay mananatili sa availability at ang CLI ay ipapakita ang command para subukan muli.
#Magdagdag ng isang mapagkakatiwalaang backend
I-run npx @lia-labs/create-app@latest backend para sa isang hiwalay na server project sa TypeScript/JavaScript, Python, PHP o Go. Pumili ng Node/Express, FastAPI/Django, PHP HTTP o Go HTTP. Ang mga ito ay naglalaman ng verified player sessions, signed webhooks, paid-charge checks at persistent inventories na may unique receipts. Panatilihin ang mga server secrets sa iyong frontend. Tingnan backend packages at mga gabay sa integrasyon ng framework.
Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles