LiaPengembang

Panduan

Coba semua hal sebelum peluncuran. Tester, kunci uji, dan pura-pura $LIA, menjalankan halaman Anda dari komputer Anda, demo SDK, dan menemukan masalah di dalam Lia.

#Mode uji

Aplikasi baru dimulai dalam pengujian. Selama mereka:

  • Hanya Anda dan penguji Anda yang dapat membuka aplikasi. Minta tim Lia menambahkan penguji dengan nama pengguna Lia mereka.
  • Lia'header mengatakan Uji di samping nama pengembang Anda.
  • Pembayaran dan hadiah menggunakan $LIA palsu; tidak ada orang'saldo mereka berpindah.
  • Gunakan akun Anda kunci uji di server Anda. Hanya melihat sesi uji, biaya, dan pemain.

Lihat Uji dan live untuk semua yang'berbeda.

#Jalankan dari komputer Anda

Lia hanya membuka halaman https dari aplikasi Anda's alamat, jadi halaman di localhost dapat'tidak terbuka langsung di Lia. Letakkan di belakang tunnel https, dan minta tim Lia untuk mengarahkan aplikasi uji Anda ke tunnel tersebut's alamat:

npx vite --port 5173
cloudflared tunnel --url http://localhost:5173

Sebuah terowongan bernama (atau alamat https tetap apa pun) menyimpan pengajuan alamat baru setiap kali.

#Di browser biasa

Di luar Lia, Lia.available adalah false dan setiap panggilan gagal dengan not_in_lia. Untuk bekerja pada tata letak di browser desktop, sebuah stand in kecil membantu:

dev-lia.js
// Only when not inside Lia, and only in development.
if (!window.Lia.available && location.hostname === "localhost") {
  const fake = { player: { id: "p_dev000000000000000000", name: "you" }, session: "dev", exp: Date.now() + 9e5, mode: "test", language: "en", rtl: false, platform: "web" };
  window.Lia = Object.assign(Object.create(window.Lia), {
    init: async () => fake,
    ready() {},
    session: async () => ({ session: "dev", exp: Date.now() + 9e5 }),
    toast: async (text) => console.log("toast:", text),
    haptic: async () => null,
    pay: async (productId) => ({ chargeId: "ch_dev", productId }),
  });
}

Server Anda menang'verifikasi "dev" sesi, jadi pertahankan jalur pengembangan di sana juga, atau uji alur server di dalam Lia.

#The SDK demo

Lia'aplikasi demo sendiri mencoba setiap panggilan SDK dan menunjukkan apa yang kembali: https://api.lialabs.org/sdk/demo. Aplikasi ini terbuka di dalam Lia untuk orang-orang yang tim tambahkan sebagai pengujinya; tanyakan jika Anda'ingin mencobanya. Sumbernya adalah referensi yang baik untuk setiap panggilan.

#Mencari masalah di dalam Lia

Lia'toko s dibangun tidak't memungkinkan menghubungkan inspector web ke halaman Anda. Sebaliknya:

  • Tampilkan kesalahan di layar saat pengujian: panel log kecil yang dapat diambil screenshot oleh penguji Anda.
  • Kirim kesalahan ke server Anda dengan id pemain Lia.version, Lia.platform dan kesalahan's code.
  • Periksa setiap penolakan's code, bukan hanya pesannya.
window.addEventListener("error", function (event) { report({ message: event.message, at: event.filename + ":" + event.lineno }); });
window.addEventListener("unhandledrejection", function (event) { report({ code: event.reason && event.reason.code, message: String(event.reason) }); });

#Sebelum Anda meluncurkan

  • Pembayaran: beli setiap produk, tutup lembar tanpa membayar, muat ulang selama pembayaran dan periksa Lia.charges() menemukannya, dan mengembalikan satu.
  • Webhook: pembelian uji mencapai handler Anda, tanda tangan diverifikasi, dan pengiriman kedua tidak melakukan apa-apa.
  • Hadiah: kunci duplikat tidak membayar apa-apa; pool_empty dan daily_limit ditangani.
  • Notifikasi: tanyakan, kirim, ketuk satu dengan aplikasi tertutup dan dengan aplikasi terbuka.
  • Tampilan: terang dan gelap, bahasa dari kanan ke kiri (Arab), ponsel kecil, dan layar penuh jika Anda menggunakannya.
  • Server Anda beralih ke kunci langsung dalam produksi, dan tidak ada data uji Anda yang bocor ke lingkungan live.

Kemudian mintalah tim Lia untuk mengubah aplikasi Anda ke mode live.

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

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