Morpeh World Browser使用教程：实时调试与远程调试ECS实体的利器

Morpeh World Browser使用教程实时调试与远程调试ECS实体的利器【免费下载链接】morpeh ECS Framework for Unity Game Engine and .Net Platform项目地址: https://gitcode.com/gh_mirrors/mo/morpehMorpeh World Browser 是 Morpeh ECS 框架内置的实体实时调试工具让你在 Unity 播放模式中实时追踪、搜索实体Entity及其组件还能直接添加、移除组件并支持远程连接真机构建Build进行调试是排查 ECS 架构问题的利器。World Browser 是什么与传统的打日志、断点不同World Browser 提供了一个可视化的ECS 实体浏览器核心能力包括实时追踪播放模式下实时显示所有匹配查询的实体组件搜索使用与核心Filter完全相同的过滤逻辑With/Without➕组件增删选中实体后可直接添加或移除组件远程调试可连接手机、PC 上运行的 Debug 构建入口非常简单在 Unity 编辑器菜单栏选择Tools - Morpeh - WorldBrowser即可打开对应源码为 WorldBrowserWindow.cs。快速上手搜索你的第一个 ECS 实体第 1 步创建一个组件先按Create/ECS/Component新建一个组件例如HealthComponent它就是你之后搜索的目标。第 2 步为 GameObject 添加 ProviderWorld Browser 只能看到真实存在的实体。给场景中的 GameObject 挂一个对应的MonoProviderT它就会自动关联到一个 ECS 实体。第 3 步打开 World Browser 并查询点击播放打开 World Browser窗口由搜索栏 实体层级列表 属性检查器三部分组成。在搜索栏中输入组件名即可实时过滤查询语法含义示例组件名With 条件包含该组件HealthComponent!组件名Without 条件不包含该组件!DummyComponentid:实体ID按实体 ID 精确搜索id:25 id:145几个实用细节✨ 输入组件名时会出现自动补全建议点击即可补全也可以直接从组件列表中点选⚠️id:搜索会覆盖所有组件查询条件ℹ️ ID 为 0 的实体不存在框架中 0 是保留的无效实体查询解析逻辑实现在 SearchHandler.cs。选择要搜索的 World点击层级面板顶部带W图标的下拉框可勾选要搜索的 World默认选中World.Default。如果你创建了多个自定义 World这里就能分别查看。相关实现见 HierarchyToolbar.cs。实时添加与移除组件选中左侧列表中的实体后右侧 Inspector 会显示它的全部组件及字段值。点击Add Component按钮从下拉菜单中搜索并选择组件即可为实体实时添加组件——修改会立即反映在 Filter 匹配中非常适合验证添加某个组件后系统是否正确响应这类问题。远程调试连接真机上的 ECS 实体Editor 播放模式之外的另一大场景把 App 装到手机或另一台设备上运行时直接连接它的 ECS 数据。该功能目前为实验特性仅支持 Development 构建按以下四步配置 通过 Package Manager 安装 Unity Serialization 官方包Unity.Serialization️ 在Project Settings - Player - Scripting Define Symbols中添加MORPEH_REMOTE_BROWSER 重启 Unity Editor重新构建并运行应用启用前构建的包不支持远程调试重启后World Browser 顶部会出现Connect to Remote连接栏和 IP 输入框见 RemoteToolbar.cs连接地址按平台填写Android / iOS与设备连同一 WiFi在设备设置 - WiFi中查看 IP填入如192.168.1.100Windows / macOS / Linux直接使用127.0.0.1可选指定端口格式如127.0.0.1:22005⚠️ 远程模式相比 Editor 播放模式有一些限制组件中的Unity.Object字段以只读模式展示只能看到 Type / Name / InstanceID无法查看Unity.Object字段详情部分组件若序列化失败会标记[NotSerialized]且不渲染进阶配合 Morpeh Metrics 一起用World Browser 负责看实体而 Morpeh 还提供 Metrics 功能在 Unity Profiler 中显示实体数、原型数、Filter 数、System 数、Commit 与迁移次数等统计数据需定义MORPEH_METRICS两者配合可以从数据总量 单个实体两个维度定位性能与逻辑问题。小结需求操作查看某组件的所有实体搜索栏输入组件名排除某类实体搜索栏输入!组件名精确定位实体输入id:实体ID实时改实体状态Inspector 中 Add / Remove 组件调试真机构建开启MORPEH_REMOTE_BROWSER后连接设备 IPWorld Browser 让你不再依赖日志猜测实体状态无论是 Editor 播放还是真机远程都能快速看清 ECS 世界的真面目。【免费下载链接】morpeh ECS Framework for Unity Game Engine and .Net Platform项目地址: https://gitcode.com/gh_mirrors/mo/morpeh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考