Ralyoo dokumentasi developerSDK 1.1.0ralyoo.com

Changelog @ralyoo/sdk

Mengikuti semver. Aturan kompatibilitas antara versi SDK game dan platform ada di COMPATIBILITY.md.

1.1.0 (belum dirilis)

SDK jadi paket yang bisa dipasang di luar repo Ralyoo (AZKA-287).

Ditambahkan

  • Lisensi MIT.
  • Paket mandiri. Hasil build dist/ (ES module + deklarasi tipe), tanpa dependensi runtime. vite hanya peer dependency opsional untuk @ralyoo/sdk/vite.
  • Manifest lengkap (@ralyoo/sdk/manifest): title, description, controls, badge, author, dan media (icon, cover, color) di ralyoo.json. Batas teks mengikuti yang muat di lobi: title ≤ 22 karakter (satu baris), description ≤ 100 (dua baris). validateManifest() memeriksanya terhadap MANIFEST_SCHEMA; skema yang sama terbit sebagai @ralyoo/sdk/schema.json.
  • Kontrak katalog (@ralyoo/sdk/catalog): bentuk /catalog.json yang diterbitkan registry dan dibaca host-shell, plus readCatalog() yang membuang entri tidak valid satu per satu. Folder bundel boleh berupa path di origin host atau URL https: (bucket sendiri).
  • Aturan bundel (@ralyoo/sdk/bundle): isi wajib, tipe file yang boleh, batas ukuran, dan pemeriksaan skrip (checkBundle, checkScript).
  • Harness tes (@ralyoo/sdk/testing): createTestHost(game) menjalankan game terhadap runtime dan bridge yang asli tanpa browser, relay, atau HP.
  • ctx.gameId, ctx.locale, ctx.platformSdk.
  • BUTTON_BITS dan isDown(state, 'A') untuk membaca ctx.input(player).buttons.
  • Statistik frame untuk HUD performa: platform meminta (perf), SDK mengukur di dalam iframe dan melapor sekali per detik. Mati secara bawaan, jadi tanpa biaya saat main biasa.
  • @ralyoo/sdk/semver: satisfies(version, range) untuk rentang sdk di manifest.
  • @ralyoo/sdk/widgets dan @ralyoo/sdk/vendor: kontrak layout controller dan daftar pustaka bersama, sebelumnya paket internal.

Diubah

  • gameViteConfig() ikut menyalin ralyoo.json ke dist/, sehingga dist/ adalah isi bundel apa adanya.
  • defineGame() di luar browser (tes unit) mengembalikan definisinya tanpa mencari platform.

Kompatibilitas

Kontrak pesan tetap mayor 1. Game yang dibangun dengan 1.0.0 jalan di platform 1.1.0 tanpa perubahan, dan sebaliknya (lihat COMPATIBILITY.md).

1.0.0

Versi yang dipakai empat game pertama di monorepo: defineGame, ctx (pemain, controller, end/exit, audio, aset, storage, input, random, i18n), hook alur layar (onPause/onResume, end(…, { screen: 'game' }), opening, theme), dan ResolutionGovernor.

Halaman ini sebagai Markdown: changelog.md · semua halaman: llms.txt