LiaGeliştiriciler

Paketler

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@latest

Lia 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 dev

Atla 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 apps

Zaten bir proje oluşturduysanız? Proje dizininden kaydedin:

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

Aynı anda oluşturabilir ve kaydolabilirsiniz:

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

Kayı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 logout

Sadece 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 dev

CLI , 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çeveKomutLia entegrasyonu
Basit TypeScriptnpm create @lia-labs/app@latest my-app -- --framework vanillaTürlü SDK çağrıları ve gözlemlenebilir durum.
Reactnpm create @lia-labs/app@latest my-app -- --framework reactuseInit, usePlayer, useLanguage, useMainButton.
Preactnpm create @lia-labs/app@latest my-app -- --framework preactPreact hooks ve Lia Preact bağlamaları.
Vuenpm create @lia-labs/app@latest my-app -- --framework vueComposables, refs ve bileşen temizliği.
Sveltenpm create @lia-labs/app@latest my-app -- --framework svelteSvelte depoları ve bileşen kapsamlı kontrolleri.
Katınpm create @lia-labs/app@latest my-app -- --framework solidErişimciler, createInit ve createMainButton.
Açısalnpm create @lia-labs/app@latest my-app -- --framework angularEnjekte edilmiş sinyallerle birlikte tek başına bir Angular uygulaması.
Web bileşenlerinpm 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.

  1. Çalıştır npm run build ve çıktıyı HTTPS üzerinde barındırın (dist/, veya dist/browser/ Angular için).
  2. 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.
  3. Ve beş ek testçi dahil olmak üzere bulun Uygulamalar → Test, yayın kategorisine bakılmaksızın.
  4. Alış veriş örneği için etkin bir demo-coins portal üzerinden ürününüzü test edin.
  5. 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 solid

Skriptler veya CI için:

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

Etkileş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

Her sayfa, yöntem ve uç noktayı aramak için yazın.