LiaPengembang

Paketan

Buat aplikasi Lia dengan setup terminal yang terarah, login yang disetujui browser, dan pendaftaran aplikasi pribadi otomatis. Pilih dari sembilan integrasi framework.

#Buat proyek

npm create @lia-labs/app@latest

Lia Developer Studio memandu Anda melalui proyek, framework, starter, setup, dan akun Anda. Gunakan tombol panah untuk memilih framework Anda dan Pemula atau lapangan kerja SDK. Direkomendasikan pengaturan mengaktifkan simulasi browser lokal dan menginstal dependensi dengan manajer paket yang Anda gunakan. Kustomisasi memungkinkan Anda mengubah aplikasi publik ID, manajer paket, simulasi lokal, dan preferensi instalasi. Setup memvalidasi direktori Anda sebelum membuat file, menunjukkan kemajuan instalasi, dan mencetak perintah pemulihan jika instalasi gagal. Tekan Ctrl+C untuk membatalkan. Folder yang sudah ada dan tidak kosong tidak pernah dihapus.

Gunakan versi Node LTS yang didukung: versi Node 22.12+ atau 24+ direkomendasikan. Starter memilih versi kerangka kerja yang kompatibel dengan ikatan Lia saat ini, termasuk Preact 10 dan Solid 1.

cd my-lia-app
npm install
npm run dev

Lewati npm install jika dependensi sudah terpasang. Gunakan perintah yang sesuai untuk manajer paket yang Anda pilih.

#Sambungkan akun Lia Anda

Setelah membuat file Anda, pilih Sambungkan & daftar untuk membuka Lia Developers di browser Anda. Masuk dengan akun Lia Anda, bandingkan kode yang ditampilkan di terminal, dan setujui permintaan. Aplikasi Anda dibuat sebagai daftar uji pribadi di dashboard pengembang Anda. Pilih Terus bangun secara lokal, atau lewati --local, untuk mendaftar nanti.

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

Sudah memiliki proyek yang dihasilkan? Daftarkan dari direktori proyek:

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

Anda juga dapat membuat dan mendaftar dalam satu perintah:

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

Pendaftaran tidak memerlukan hosting saat ini. Sampai Anda menambahkan HTTPS URL yang di-deploy di dashboard, membuka daftar menampilkan placeholder setup. Gunakan --url https://your-app.example saat mendaftar jika hosting siap. Mendaftarkan aplikasi ID yang sudah Anda miliki menghubungkan proyek ke daftar tersebut tanpa mengeditnya; ID yang dimiliki oleh orang lain ditolak. Kelola perubahan URL, seni, penguji, dan ulasan di dashboard.

Aplikasi publik ID disimpan di lia.config.json dan konfigurasi kerangka yang dihasilkan. Pendaftaran menambahkan informasi dashboard dan hostname ke file tersebut. Kredensial akun disimpan terpisah di komputer Anda; mereka tidak pernah ditulis ke dalam proyek atau kode browser yang dihasilkan.

Kode persetujuan browser berlaku selama sepuluh menit. Akses terminal berlangsung hingga tiga puluh hari dan dapat mendaftarkan aplikasi Anda, membuat daftar uji pribadi, dan menghubungkan pratinjau lokal ke aplikasi uji pribadi Anda. Ini tidak dapat menerbitkan aplikasi, membaca kunci server, atau melakukan pembayaran. Gunakan Terminal yang terhubung di dashboard untuk membatalkan terminal secara langsung, atau keluar dari baris perintah:

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

Hanya setujui kode yang Anda mulai sendiri. Persyaratan akses pengembang yang sudah ada masih berlaku; login terminal tidak melewati proses undangan. Jika browser tidak dapat dibuka secara otomatis, gunakan login --no-browser dan buka tautan yang dicetak sendiri. Permintaan yang ditolak atau kedaluwarsa dapat dicoba ulang dengan login.

#Pratinjau aplikasi lokal Anda di Lia

Dari proyek yang terdaftar, jalankan:

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

The CLI memulai server pengembangan kerangka kerja Anda, membuka Terowongan Cloudflare sementara dan menghubungkannya ke daftar uji pribadi Anda. Buka aplikasi lagi di Lia di bawah Aplikasi → Pengujian. Perubahan berikutnya menggunakan live reload framework Anda, sehingga Anda dapat terus menguji di ponsel Anda sambil mengubah file lokal. Tidak diperlukan akun Cloudflare atau konfigurasi DNS.

Jika Cloudflare Tunnel tidak terinstal, Lia mengunduh bantuan resmi ke cache pengguna Anda dan memeriksa checksum rilisnya sebelum menjalankannya. Ini tidak menginstal layanan latar belakang. Pilih port lain dengan --port 4201, atau manajer paket dengan --pm pnpm.

Panel hidup menunjukkan server lokal Anda, Terowongan HTTPS dan aplikasi Lia yang terhubung. Tekan o membuka tautan aplikasi, d untuk dashboard-nya, atau q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.

Page URL permanen Anda tetap tidak berubah. Menghentikan akan menghapus koneksi pratinjau, dan koneksi akan kedaluwarsa dalam dua menit jika terminal hilang. Pratinjau lokal hanya berfungsi dengan aplikasi uji pribadi dan tidak dapat menggantikan aplikasi yang sedang berjalan. Deploy HTTPS hosting permanen sebelum mengirim untuk ditinjau.

Terowongan sementara URL bersifat publik bagi siapa pun yang memiliki itu, sementara daftar Lia tetap terbatas pada penguji Anda yang sudah ada. Jangan masukkan rahasia produksi dan data pelanggan pribadi ke dalam pratinjau browser lokal. Terowongan Cepat adalah infrastruktur pengembangan dengan tidak ada jaminan ketersediaan.

#Preferensi Terminal

Antarmuka menyesuaikan diri dengan terminal yang lebih kecil. Atur NO_COLOR=1 untuk warna polos, LIA_NO_MOTION=1 untuk mengurangi animasi kemajuan, atau ACCESSIBLE=1 untuk pesan teks standar. CI dan output yang diarahkan tetap statis. CLI melaporkan langkah pengaturan nyata daripada persentase yang disimulasikan.

#Pilih kerangka kerja

FrameworkPerintahLia integrasi
Biasa TypeScriptnpm create @lia-labs/app@latest my-app -- --framework vanillaPanggilan SDK bertipe dan status yang dapat diamati.
Reactnpm create @lia-labs/app@latest my-app -- --framework reactuseInit, usePlayer, useLanguage, useMainButton.
Preactnpm create @lia-labs/app@latest my-app -- --framework preactPreact hooks dan pengikatan Lia Preact.
Vuenpm create @lia-labs/app@latest my-app -- --framework vueComposables, refs dan pembersihan komponen.
Sveltenpm create @lia-labs/app@latest my-app -- --framework svelteSvelte menyimpan dan mengontrol komponen berbasis skop.
Solidnpm create @lia-labs/app@latest my-app -- --framework solidAccessors, createInit dan createMainButton.
Angularnpm create @lia-labs/app@latest my-app -- --framework angularAplikasi Angular yang mandiri dengan sinyal yang diinjeksikan.
Komponen webnpm create @lia-labs/app@latest my-app -- --framework elements<lia-app>, <lia-main-button> dan tipe SDK.
Jembatan tingkat rendahnpm create @lia-labs/app@latest my-app -- --framework bridgeTyped lanjutan request, send dan contoh acara.

Angular menggunakan pembangun aplikasinya. Starter lain menggunakan Vite. Semua starter menggunakan TypeScript; file komponen khusus kerangka kerja disertakan sehingga Anda dapat menyesuaikan integrasi secara langsung.

#Mulai dengan demo SDK yang berjalan

Tambahkan --template demo untuk katalog fitur interaktif dalam kerangka kerja Anda:

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

Demo Framework mencakup dialog, haptik, identitas, pembaruan sesi, pembelian uji coba, iklan yang dibayar/interstisial/banner/native, berbagi, penyimpanan, pengambilan media, biometrik, pemindaian QR, kontrol layar, pengingat, dan skor. Setiap tindakan memiliki kode, umpan balik pemuatan, dan laporan respons. Fitur yang tidak didukung dan pembatalan izin ditangani tanpa crash. Token sesi dan konten file dihilangkan dari laporan.

Demo jembatan lanjutan fokus pada pesan bertipe kasar. Demo kerangka kerja menggunakan ikatan masing-masing untuk identitas pemain reaktif, bahasa, dan kontrol asli; mereka berbagi contoh fitur bertipe, bukan iframe yang membungkus demo JavaScript biasa.

Kamu juga dapat membuka Demo SDK di dalam Lia di bawah Aplikasi → Pengujian. Setiap pengembang yang terdaftar memiliki akses tanpa izin penguji terpisah. Tur selamat datang dan dashboard portal menghubungkannya.

#Simulasi browser dan pengujian nyata

Instalasi pengembangan lokal mockLia() hanya di luar Lia. Pembayaran, iklan, dan hadiah disimulasikan; tidak ada sesi atau pembayaran nyata yang dibuat. Pembuatan produksi menghilangkan mock pengembangan. Angular mengganti modul pengembangannya; starter Vite menggunakan bendera pengembangan dari build.

Nonaktifkan simulasi dengan --no-mock. Untuk proyek Vite, Anda juga dapat mengatur VITE_LIA_MOCK=false dalam file lingkungan pengembangan lokal. Izin dan perangkat keras native masih perlu diuji di dalam Lia.

  1. Jalankan npm run build dan menyimpan output di atas HTTPS (dist/, atau dist/browser/ untuk Angular).
  2. Daftar melalui CLI atau buat aplikasi di portal pengembang. Atur HTTPS URL yang dideploy sebelum menguji. Aplikasi ID dalam kode saja tidak mendaftarkan listing atau mengautentikasi permintaan.
  3. Kamu dan hingga lima penguji tambahan menemukannya di bawah Aplikasi → Pengujian, terlepas dari kategori penerbitannya.
  4. Untuk contoh pembelian, buatlah demo-coins uji produk di portal.
  5. Simpan aplikasi uji dengan Pengaturan → Arsipkan aplikasi. Ia menghilang dari daftar aplikasi bawaan semua orang dan dapat dipulihkan tanpa menghapus konfigurasi atau data uji.

Rilis publik memerlukan tinjauan. Akses pengembang terbuka direncanakan untuk Q1 2027; CLI tidak melewati persyaratan undangan atau publikasi saat ini.

#Pertahankan keputusan bernilai tinggi di server Anda

Jangan pernah mempercayai panggilan balik klien, skor, nilai penyimpanan lokal atau peristiwa penutup iklan untuk memberikan mata uang, item, atau hadiah. Jaga kunci server dan rahasia webhook di luar kode browser dan semua VITE_* variabel.

Starter tidak meniru verifikasi server atau menyertakan titik akhir pengiriman yang tidak aman. Pembelian demo dan pengiriman skor dibatasi pada mode uji. Tambahkan backend yang memverifikasi sesi, memeriksa setiap tagihan aplikasi, pemain, produk, mode, dan status, mengirimkan sekali dan mengakui pengiriman. Pisahkan akuntansi uji dan akuntansi live.

#Manajer paket dan otomatisasi

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

Untuk skrip atau CI:

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

Setup non-interop tetap lokal kecuali Anda melewatinya --register; pendaftaran tanpa prompt memerlukan login terminal yang sudah ada. Gunakan --install untuk menginstal secara otomatis. --help mencantumkan opsi. Jika instalasi gagal, file yang dihasilkan tetap tersedia dan CLI mencetak perintah untuk mencoba kembali.

#Tambahkan backend yang aman

Jalankan npx @lia-labs/create-app@latest backend untuk proyek server terpisah di TypeScript/JavaScript, Python, PHP atau Go. Pilih Node/Express, FastAPI/Django, PHP HTTP atau Go HTTP. Starter ini mencakup sesi pemain yang diverifikasi, webhook yang ditandatangani, pemeriksaan pembayaran, dan inventaris yang tetap dengan bukti unik. Jaga rahasia server Anda jauh dari frontend Anda. Lihat paket backend dan panduan integrasi framework.

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris

Ketik untuk mencari setiap halaman, metode, dan titik akhir.