包
入门套件 & SDK 演示
复制页面
通过引导式终端设置、浏览器批准的登录和自动私有应用注册创建一个Lia应用。选择九种框架集成。
#创建一个项目
npm create @lia-labs/app@latestLia 开发者工作室会引导您完成项目、框架、模板、设置和账户。使用箭头键选择您的框架,并 入门 或 SDK沙盒. 推荐 设置启用本地浏览器模拟并使用您使用的包管理器安装依赖项。 自定义 允许您更改公共应用 ID、包管理器、本地模拟和安装偏好。设置在创建文件前会验证您的目录,显示安装进度,并在安装失败时打印恢复命令。按 Ctrl+C 取消。现有非空文件夹不会被覆盖。
使用支持的 Node LTS 版本:推荐使用 Node 22.12+ 或 24+。入门模板选择与当前 Lia 绑定兼容的框架版本,包括 Preact 10 和 Solid 1.
cd my-lia-app
npm install
npm run dev跳过 npm install 如果已安装依赖项。请使用与您选择的包管理器匹配的命令。
#连接您的 Lia 账户
创建完文件后,选择 连接 & 注册 在浏览器中打开Lia 开发者。使用您的Lia 账户登录,比较终端中显示的代码,并批准请求。您的应用将作为私有测试列表创建在您的开发者仪表板中。选择 继续在本地进行开发,或跳过 --local,稍后注册。
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest apps已有生成的项目?从项目目录注册:
npx @lia-labs/create-app@latest register --name "My game" --kind game您也可以通过一条命令创建并注册:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind game注册不需要托管。在您将已部署的HTTPS URL添加到仪表板之前,打开列表将显示一个设置占位符。使用 --url https://your-app.example 在注册时如果托管已准备好。注册您已经拥有的ID 会将项目链接到该列表而不进行编辑;由他人拥有的ID 会被拒绝。在仪表板中管理URL 的更改、艺术作品、测试人员和审核。
公共应用ID已保存在 lia.config.json 和生成的框架配置。注册会将仪表板和主机名信息添加到该文件中。账户凭据在您的计算机上单独存储;它们永远不会写入项目或生成的浏览器代码中。
浏览器批准代码在十分钟后过期。终端访问最多持续三十天,可以列出你的应用,创建私有测试列表并将本地预览连接到你的私有测试应用。它不能发布应用、读取服务器密钥或进行付款。使用 已连接的终端 在仪表板上立即撤销终端,或从命令行注销:
npx @lia-labs/create-app@latest logout仅批准您自己启动的代码。现有的开发者访问要求仍然适用;终端登录不会绕过邀请流程。如果浏览器无法自动打开,请使用 login --no-browser 并自行打开打印的链接。被拒绝或过期的请求可以使用 login.
#在Lia中预览您的本地应用
从你注册的项目中,运行:
npx @lia-labs/create-app@latest devCLI 启动您框架的开发服务器,打开一个临时的Cloudflare 隧道并将其连接到您的私有测试列表。在Lia 下重新打开应用 应用 → 测试。后续的编辑会使用你框架的实时重新加载功能,因此你可以在更改本地文件的同时继续在手机上进行测试。不需要Cloudflare账户或DNS配置。
如果未安装Cloudflare隧道,Lia会将官方辅助工具下载到你的用户缓存中,并在运行前检查其发布校验和。它不会安装后台服务。使用另一个端口 --port 4201,或一个包管理器 --pm pnpm.
实时面板显示您的本地服务器、HTTPS 隧道和连接的Lia 应用。按下 o 打开应用链接, d 用于其仪表板,或者 q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
您的永久页面URL 保持不变。停止会移除预览连接,丢失的终端会在两分钟内使连接过期。本地预览仅适用于私有测试应用,不能替代正式应用。在提交审核之前,请先部署永久的HTTPS 托管。
临时隧道URL 对任何拥有它的人都是公开的,而Lia 列表则仅限于您现有的测试人员。请勿在本地浏览器预览中包含生产秘密和私有客户数据。快速隧道是无任何正常运行时间保证的开发基础设施。
#终端偏好设置
界面会适应较小的终端。设置 NO_COLOR=1 用于纯色, LIA_NO_MOTION=1 以减少进度动画,或 ACCESSIBLE=1 用于标准文本提示。CI 和重定向输出保持静态。CLI 报告实际的设置步骤,而不是模拟的百分比。
#选择一个框架
| 框架 | 命令 | Lia 集成 |
|---|---|---|
| 普通 TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | 类型化 SDK 调用和可观察状态。 |
| 反应 | 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 钩子和 Lia Preact 绑定。 |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | 组合式 API、响应式引用和组件清理。 |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Svelte 存储和组件作用域的控制。 |
| 稳固 | npm create @lia-labs/app@latest my-app -- --framework solid | 访问器, createInit 和 createMainButton. |
| 角度 | npm create @lia-labs/app@latest my-app -- --framework angular | 一个带有注入信号的独立Angular应用。 |
| 网页组件 | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> 以及类型的SDK。 |
| 低级桥接 | npm create @lia-labs/app@latest my-app -- --framework bridge | 高级类型 request, send 和事件示例。 |
Angular 使用其应用程序构建器。其他启动项使用 Vite。所有启动项都使用 TypeScript;包含框架特定的组件文件,以便您可以直接适应集成。
#从一个可运行的SDK演示开始
添加 --template demo 用于您框架中的交互式功能目录:
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框架演示包括对话框、触觉反馈、身份验证、会话刷新、测试购买、激励/全屏/横幅/原生广告、分享、存储、媒体捕获、生物识别、QR扫描、屏幕控制、提醒和分数。每个操作都有代码、加载反馈和响应读数。不支持的功能和权限取消不会导致崩溃。会话令牌和文件内容不会出现在读数中。
高级桥接演示重点在于原始类型的消息。框架演示使用各自的绑定来实现响应式玩家身份、语言和原生控制;它们共享类型化功能示例,而不是封装普通 JavaScript 演示的 iframe。
你也可以打开托管的 SDK 示例 在Lia下 应用 → 测试。每个注册的开发人员都可以访问,无需单独的测试人员授权。门户的欢迎指南和仪表板链接到它。
#浏览器模拟和实际测试
本地开发安装 mockLia() 仅在Lia外部。支付、广告和奖励是模拟的;不会创建真实会话或付款。生产构建会省略开发模拟。Angular 会替换其开发模块;Vite 起始项目使用构建的开发标志。
使用 --no-mock。对于Vite项目,您也可以设置 VITE_LIA_MOCK=false 在本地开发环境文件中。原生权限和硬件仍需在Lia内测试。
- 运行
npm run build并通过HTTPS托管输出(dist/,或者dist/browser/用于Angular)。 - 通过CLI注册或在应用中创建应用 开发者门户请在测试前设置其部署的 HTTPS URL。仅在代码中使用的应用 ID 不会注册列表或验证请求。
- 你和最多五个额外的测试者可以在 应用 → 测试,无论其发布类别如何。
- 对于购买示例,请创建一个活跃的
demo-coins在门户中测试产品。 - 将一个测试应用放在一边 设置 → 归档应用。它会从所有人的原生应用列表中消失,并且可以在不删除配置或测试数据的情况下恢复。
公开发布需要审查。开放开发者访问计划于 Q1 2027;CLI 不会绕过当前的邀请或发布要求。
#将有价值的决策保留在您的服务器上
永远不要相信客户端回调、分数、本地存储值或广告关闭事件来授予货币、物品或奖励。将服务器密钥和网络钩子密钥保留在浏览器代码之外,并且所有 VITE_* 变量。
该入门模板不模拟服务器验证或包含不安全的交付端点。演示购买和分数提交仅限于测试模式。添加一个后端, 验证会话,检查每个费用的应用程序、玩家、产品、模式和状态,交付一次并确认交付。保持测试和生产会计分开。
#包管理器和自动化
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对于脚本或CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --local非交互式设置保持本地状态,除非您传递 --register;无需提示的注册需要已有的终端登录。使用 --install 自动安装。 --help 列出选项。如果安装失败,生成的文件仍然可用,CLI会打印重试的命令。
#添加安全的后端
运行 npx @lia-labs/create-app@latest backend 用于 TypeScript/JavaScript 的独立服务器项目,Python,PHP 或 Go。选择 Node/Express,FastAPI/Django,PHP HTTP 或 Go HTTP。这些入门项目包括经过验证的玩家会话、签名的 Webhook、付费充值检查以及带有唯一收据的持久库存。将服务器密钥保留在前端之外。查看 后端包和框架集成指南中找到.
自动翻译。英语是真实来源。 阅读英文