Paketler
Başlangıç kiti & SDK demo
Sayfayı kopyala
Yönlendirilmiş terminal kurulumu, tarayıcı onaylı giriş ve otomatik özel uygulama kaydıyla Lia uygulaması oluşturun. Dokuz çerçeve entegrasyonundan seçim yapın.
#Bir proje oluştur
npm create @lia-labs/app@latestLia Geliştirici Stüdyosu, projeniz, çerçeve, başlangıç, kurulum ve hesabınız üzerinden size rehberlik eder. Çerçeveyi seçmek için ok tuşlarını kullanın ve Başlangıç veya SDK oyun alanı. Önerilen ayarlar, yerel tarayıcı simülasyonunu etkinleştirmek ve paket yöneticinizle bağımlılıkları kurmak için kullanılır. Özelleştir genel uygulama ID'yı, paket yöneticisini, yerel simülasyonu ve kurulum tercihinizi değiştirmenize olanak tanır. Kurulum, dosyaları oluşturmadan önce dizininizi doğrular, kurulum ilerlemesini gösterir ve bir kurulum başarısız olursa kurtarma komutları yazdırır. İptal etmek için Ctrl+C'ye basın. Var olan boş olmayan klasörler asla üzerine yazılır.
Desteklenen bir Node LTS sürümü kullanın: Node 22.12+ veya 24+ önerilir. Başlangıçlar, mevcut Lia bağlamalarıyla uyumlu çerçeve sürümlerini seçer, Preact 10 ve Solid 1. dahil olmak üzere.
cd my-lia-app
npm install
npm run devAtla npm install kurulumun zaten bağımlılıkları kurup kurmadığını. Seçtiğiniz paket yöneticisi için eşleşen komutları kullanın.
# Lia hesabınızı bağlayın
Dosyalarınızı oluşturduktan sonra seçin Bağlan & kayıt tarayıcınızda Lia Geliştiricileri açın. Lia hesabınızla oturum açın, terminaldeki kodu karşılaştırın ve isteği onaylayın. Uygulamanız, geliştirici dashboardsında özel bir test listesi olarak oluşturulur. Seçin Yerel olarak devam edin, veya geç --local, daha sonra kaydolun.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsZaten bir proje oluşturduysanız? Proje dizininden kaydedin:
npx @lia-labs/create-app@latest register --name "My game" --kind gameAynı anda oluşturabilir ve kaydolabilirsiniz:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameKayıt için şu anda barındırma gerekmez. Taşınmış HTTPS URL'i panodan eklediğiniz sürece, listeyi açmak bir kurulum yer tutucusu gösterir. Kullanın --url https://your-app.example konaklama hazır olduğunda kayıt. Zaten sahip olduğunuz ID uygulamasını kaydetmek, projeyi o listede düzenlemek yerine bağlar; başkasına ait bir ID reddedilir. Dashboard'ta URL değişikliklerini, sanat eserlerini, test kullanıcılarını ve incelemeyi yönetin.
Genel uygulama ID şu anda kaydedilir lia.config.json ve oluşturulan kavramsal yapı. Kayıt, bu dosyaya dashboards ve hostname bilgilerini ekler. Hesap kimlik bilgileri, bilgisayarınızda ayrı olarak saklanır; asla proje veya oluşturulan tarayıcı koduna yazılmaz.
Bir tarayıcı onay kodu on dakika sonra süresi dolar. Terminal erişimi en fazla otuz gün sürer ve uygulamalarınızı listelleyebilir, özel test listeleri oluşturabilir ve yerel ön izlemeleri özel test uygulamalarınıza bağlayabilir. Ancak uygulamaları yayımlayamaz, sunucu anahtarlarını okuyamaz veya ödemeler yapamaz. Kullanın Bağlı terminaller bir terminali hemen iptal etmek veya komut satırından oturumu kapatmak için:
npx @lia-labs/create-app@latest logoutSadece kendi başlattığınız kodu onaylayın. Mevcut geliştirici erişim gereksinimleri hala geçerlidir; terminal giriş, davet sürecini atlamaz. Tarayıcı otomatik olarak açılmazsa kullanın login --no-browser ve kendi yazdırılan bağlantıyı açabilirsiniz. Reddedilen veya süresi dolmuş istekler, tekrar denenebilir. login.
#Yerel uygulamanızı Lia içinde önizleme
Kayıtlı projenizden şu komutu çalıştırın:
npx @lia-labs/create-app@latest devCLI , framework'ünüzün geliştirme sunucusunu başlatır, geçici Cloudflare Tüneli açar ve bunu özel test listelenmesine bağlar. Uygulamayı Lia altında tekrar açın Uygulamalar → Test. Daha sonra yapılan düzenlemeler, frameworkünüzün canlı yeniden yükleme özelliğini kullanır, bu sayede yerel dosyaları değiştirirken cihazınızda test yapmaya devam edebilirsiniz. Cloudflare hesabı veya DNS yapılandırması gerekmez.
Eğer Cloudflare Tünel yüklü değilse, Lia resmi yardımcı programı kullanıcı önbelleğinize indirir ve çalıştırılmadan önce sürüm checksum'ını kontrol eder. Arka plan hizmeti yüklemez. Başka bir port seçin ile --port 4201, veya bir paket yöneticisi ile --pm pnpm.
Canlı panel, yerel sunucunuzu, HTTPS tünelinizi ve bağlı Lia uygulamanızı gösterir. Basın o uygulama bağlantısını açmak için, d dashboardsı için, veya q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Sabit Sayfa URL değişmeden kalır. Durdurma önizleme bağlantısını kaldırır ve kaybolan bir terminal, bağlantısını iki dakika içinde sona erdirir. Yerel önizlemeler yalnızca özel test uygulamaları ile çalışır ve canlı uygulamayı değiştiremez. İnceleme için sunucu dağıtımı yapmadan önce sabit HTTPS barındırma sunun.
Geçici tünel URL , bunu bilen herkese açıkken, Lia listesi mevcut testçilerine sınırlıdır. Üretim sır ve özel müşteri verilerini yerel tarayıcı önizlemelerinden uzak tutun. Hızlı Tüneller, hiçbir süreklilik garantisi olmayan geliştirme altyapısıdır.
#Terminal tercihleri
Arayüz daha küçük terminallere uyarlanır. Ayarla NO_COLOR=1 basit renkler için, LIA_NO_MOTION=1 ilerleme animasyonunu azaltmak için, veya ACCESSIBLE=1 standart metin istekleri için. CI ve yönlendirilen çıktı sabit kalır. CLI, simüle edilmiş bir yüzdelik oran yerine gerçek kurulum adımlarını raporlar.
#Bir çerçeve seçin
| Çerçeve | Komut | Lia entegrasyonu |
|---|---|---|
| Basit TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Türlü SDK çağrıları ve gözlemlenebilir durum. |
| 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 ve Lia Preact bağlamaları. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Composables, refs ve bileşen temizliği. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Svelte depoları ve bileşen kapsamlı kontrolleri. |
| Katı | npm create @lia-labs/app@latest my-app -- --framework solid | Erişimciler, createInit ve createMainButton. |
| Açısal | npm create @lia-labs/app@latest my-app -- --framework angular | Enjekte edilmiş sinyallerle birlikte tek başına bir Angular uygulaması. |
| Web bileşenleri | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> ve tür SDK. |
| Düşük seviyeli köprü | npm create @lia-labs/app@latest my-app -- --framework bridge | İleri seviye tür request, send ve olay örnekleri. |
Angular uygulama oluşturucuyu kullanır. Diğer başlangıçlar Vite kullanır. Tüm başlangıçlar TypeScript kullanır; framework özel bileşen dosyaları dahil edilmiştir böylece entegrasyonu doğrudan uyarlayabilirsiniz.
#Çalışan bir SDK demo ile başlayın
Ekle --template demo çerçevenizde etkileşimli bir özellik kataloğuna için:
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Çerçeve demo'ları, diyaloglar, dokunsal geri bildirim, kimlik, oturum yenileme, test alımları, ödüllü/ara sayfa/duyarlı/ana sayfa reklamları, paylaşım, depolama, medya yakalama, biyometrikler, QR tarama, ekran kontrolleri, hatırlatmalar ve puanlar içerir. Her eylem için kod, yükleme geri bildirimi ve bir yanıt okunması vardır. Desteklenmeyen özellikler ve izin iptalleri çökmeden işlenir. Oturum belirteçleri ve dosya içerikleri okunmadan çıkarılır.
Gelişmiş köprü demo'su, ham türlü mesajlara odaklanır. Çerçeve demo'ları, reaktif oyuncu kimliği, dil ve yerel kontroller için kendi bağlamalarını kullanır; türlü özellik örneklerini paylaşır, sadece düz JavaScript demo'sunu sarmalayan bir iframe değil.
Ayrıca barındırılan açabilirsiniz SDK demo Lia içinde altında Uygulamalar → Test. Kayıtlı her geliştirici, ayrı bir testçi izni olmadan erişim sağlar. Portalın tanıtım turu ve dashboardsu ona yönlendirir.
#Tarayıcı simülasyonu ve gerçek test
Yerel geliştirme kurulumları mockLia() sadece Lia dışında. Ödemeler, reklamlar ve ödüller simüle edilir; gerçek bir oturum veya ödeme oluşturulmaz. Üretim derlemeleri geliştirme mock'ını atlar. Angular, geliştirme modülünü değiştirir; Vite başlangıçları derleme geliştirme bayrağını kullanır.
Simülasyonu devre dışı bırak --no-mock. Vite projeleri için ayrıca ayarlayabilirsiniz VITE_LIA_MOCK=false yerel bir geliştirme ortamı dosyasında. Yerel izinler ve donanım hâlâ Lia içinde test edilmelidir.
- Çalıştır
npm run buildve çıktıyı HTTPS üzerinde barındırın (dist/, veyadist/browser/Angular için). - CLI üzerinden kaydolun veya uygulamayı oluşturun geliştirici portalı. Dağıtılmış HTTPS URL ayarlayın. Kodda sadece bir uygulama ID bir liste kaydı veya istekleri doğrulamaz.
- Ve beş ek testçi dahil olmak üzere bulun Uygulamalar → Test, yayın kategorisine bakılmaksızın.
- Alış veriş örneği için etkin bir
demo-coinsportal üzerinden ürününüzü test edin. - Bir test uygulamasını sakla ile Ayarlar → Uygulamayı Arşivle. Herkesin yerel Uygulamalar listesinden kaybolur ve yapılandırma veya test verilerini silmeden geri yüklenir.
Kamu salıverilmesi inceleme gerektirir. Açık geliştirici erişimi Q1 2027 için planlanmıştır; CLI mevcut davet veya yayın gerekliliklerini atlamaz.
#Değerli kararları sunucunuzda tutun
Para, eşya veya ödülleri vermek için istemci geri arama çağrılarını, puanları, yerel depolama değerlerini veya reklam kapatma olaylarını asla güvenme. Sunucu anahtarlarını ve webhook gizli anahtarlarını tarayıcı kodundan uzak tut ve tüm VITE_* değişkenler.
Başlangıç, sunucu doğrulamasını taklit etmez ve güvenli olmayan bir teslimat son noktası içermez. Demo satın almaları ve puan teslimatları test moduna kısıtlıdır. Bir arka uç ekleyin ki oturumları doğrular, her yüklemeyi uygulama, oyuncu, ürün, mod ve durumunu kontrol eder, bir kez teslim eder ve teslimatı onaylar. Test ve canlı hesaplamaları ayrı tut.
#Paket yöneticileri ve otomasyon
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 solidSkriptler veya CI için:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localEtkileşimli olmayan kurulum, size ait kod onaylanmadıkça yerel kalır --register; istemci onayları olmadan kaydolmak için zaten bir terminal oturumu açılmalıdır. Kullanın --install otomatik olarak kurmak için. --help seçenekleri listeler. Kurulum başarısız olursa, oluşturulan dosyalar hâlâ mevcut olur ve CLI yeniden denemek için komutu yazdırır.
#Güvenli bir arka uç ekleyin
Çalıştır npx @lia-labs/create-app@latest backend için TypeScript/JavaScript ayrı bir sunucu projesi, Python, PHP veya Go. Node/Express, FastAPI/Django, PHP HTTP veya Go HTTP. Bu başlangıçlar doğrulanmış oyuncu oturumları, imzalı webhook'lar, ödemeli ücret kontrolleri ve benzersiz faturalarla kalıcı envanterler içerir. Sunucu gizli bilgilerini frontend'inden uzak tut. Gör arka plan paketleri ve framework entegrasyon kılavuzları.
Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku