什么是LayaTreeNano
产品定位与核心价值
LayaTreeNano 是 LayaTree 系列工具针对移动端场景推出的轻量化联调版本，核心目标是解决开发者在手机等移动设备上调试时的 “黑盒困境” 。通过支持直接在真机环境下进行直观调试，帮助开发者快速定位性能瓶颈、适配问题及交互异常，大幅提升移动端的开发效率与质量。
核心功能与技术亮点
真机直连，实时联调无门槛
- 无需复杂配置：开发者可通过手机扫码直连设备，打开工具即可实现实时同步的小游戏上的修改。
- 所见即所得调试：手机节点信息将实时同步至PC开发端，开发者可在Nano调试界面直接观察真机运行状态，告别 “猜问题” 模式。
- 支持私有化部署：开放 Nano 服务端源码与部署方案，开发者可将服务端部署在企业内网环境中，满足对数据安全、隐私保护及内网隔离的需求，尤其适配对信息安全要求较高的团队或企业场景。
轻量化设计，降低使用成本
- 无需安装厚重客户端：工具体积小巧，直接通过浏览器插件使用，减少对开发设备存储空间的占用。
- 无缝衔接 LayaTree：与 LayaTree 主版本共享项目配置与调试逻辑，开发者无需额外学习成本，即可快速上手移动端调试流程。
核心适用场景
- 移动游戏开发：解决真机运行时的性能瓶颈、触控交互异常等问题。
- 移动端 H5 应用开发：排查不同手机型号下的兼容性与适配问题。
- 快速原型验证：在真机环境下快速验证产品功能与用户体验，缩短迭代周期。
使用说明
微信小游戏接入nano
获取 LayaTreeNano 提供的nano.js核心脚本文件，将 nano.js 文件复制到微信小游戏项目的包内目录中（推荐路径：js/，可根据项目实际目录结构调整，需确保路径可被正确引用）。在项目入口文件 game.js 中，添加 nano.js 的加载代码，核心要求：确保在 Laya 引擎初始化完成后加载。
推荐代码示例：
setTimeout(()=> {
require("js/nano.js");
}, 2000)
代码说明：
- 延时加载的目的：
setTimeout延时 2000 毫秒（2 秒）是为了等待 Laya 引擎完成初始化（包括核心模块、渲染环境等准备工作）。
验证接入结果
加载成功时,真机屏幕上会显示 LayaTreeNano 的功能悬浮按钮,微信小游戏打开调试模式，点击按钮后可触发扫码联调入口，说明接入成功。
H5接入nano
获取 LayaTreeNano 提供的nano.js核心脚本文件,放进项目中导入为插件
加载成功时,真机屏幕上会显示 LayaTreeNano 的功能悬浮按钮，点击按钮后可输入连接字符串。连接字符串可以扫描Chrome的LayaTree插件中Nano显示的二维码,或者双击二维码可以获取。
LayaTreeNano调试
在 LayaTree 插件中打开 “Nano” 标签页，点击 “连接服务器” 按钮，待服务器启动成功后，标签页内将自动生成连接二维码；此时在手机真机上点击项目运行时显示的 Nano 悬浮按钮，通过弹出的扫码功能扫描电脑端二维码，即可完成开发端与真机的联调连接。若二维码无法正常显示，需优先检查电脑网络环境是否通畅（建议关闭防火墙或安全软件的网络限制），或进入 LayaTree 插件设置界面核对 “Nano 服务器地址” 配置是否正确；针对内网开发场景，可通过私有化部署 Nano 服务端的地址加入微信后台的许可域名中确保连接稳定性与数据安全性。
连接成功
若连接失败，针对微信小游戏场景，需检查微信开发者工具是否勾选 “不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书” 选项，或确认已将 Nano 服务端地址添加至微信公众平台后台的 “合法域名” 列表中；推荐通过私有化部署 Nano 服务端进一步保障连接稳定性与数据安全性。
Nano服务端私有化部署
获取 LayaTreeNano提供的 Nano服务端，其核心作用是作为中间服务器实现开发端与真机的消息转发；该服务端需在 Node 环境中运行，下载服务端文件后安装依赖
npm i
执行启动命令
node index.js
默认将开启 8080 端口（支持根据实际需求修改为其他端口）。服务端启动后，在 LayaTree 插件的设置界面中更新 Nano 服务器的配置地址（需与服务端实际运行地址一致），即可完成服务端与插件的关联配置。此外，Nano 服务端后期将支持接入 Mcp Server，为游戏运行时态的优化方案提供扩展能力。
