@buoy-gg/焦点检查器
在React Introduction TV应用中, Buoy桌面显示当前观测,方向历史,以及可能的焦点问题.
安装
npm install @buoy-gg/core @buoy-gg/external-sync @buoy-gg/focus-inspector
账户设置
开始开发建设。 你需要一个免费或ProBuoy账户。 从您的应用程序文件夹中签名 :
npx --package=@buoy-gg/core buoy login
你的浏览器打开了浮标.gg. 点击允许。 然后CLI写下 dev 符号. 它在德夫建筑工作30天.
在博览会, 信使进入 .env.development.localBuoy自己在dev建筑里读的 也可以自己传:
import { Buoy } from "@buoy-gg/core";
Buoy.init({ licenseKey: process.env.EXPO_PUBLIC_BUOY_KEY });
在回放原生CLI时,符号会输入 .env.local 作为 BUOY_KEY。React Industrial不会自己装入文件。 用你的应用软件的套装把信使递过来 将菜单保存在您的应用程序使用的供应商内部 。 安装软件包后重新启动开发服务器 。 见 快速启动 用于完整的根组件.
连接一个电视应用
使用兼容的反应- native-tvos app并跟踪 电视安装指南。在账户初始化后挂载核心集成:
import { FloatingDevTools } from "@buoy-gg/core";
<FloatingDevTools headless />;
保持电视应用无头,因此可聚焦开发者覆盖不会干扰其导航. 打开桌面,签入,选择设备,打开工具的面板. 电话建设不能代替测试电视行为.
观察已知的焦点路径
焦点巡视员需要电视叉和新建筑事件支持. 移动到一个短的已知路径,并将突出显示的元素与面板的过渡进行比较. 在观察到之前,一个方向仍然不明。 扫描屏幕,检查发现的仍未访问的元素.
听者观察焦点事件;存货扫描取决于仪表板表状态. 内部回放原生事件API可能会在版本之间发生变化. 如果该观察员无法出席,小组应报告该情况,而不应声称已完全捕获.
解释结论
旗帜识别出可能的死端,陷阱,隐形停止,焦点丢失,以及未访问的元素. 它们是诊断性休眠症,而不是一个元素无法接触的证据. 意向焦点指南可以约束tvOS和Android TV上的导航;评价陷阱Focus行为与TV叉版本的您应用的应用.
行动包括: rescan, (中文(简体) ), clearHistory, (中文(简体) ), setTracking,以及 focusElement({ nativeTag })。最后的动作改变焦点;它不等于用 D-pad 压出相同的路线.
校验您的路径、布局和电视叉版本, 包括如果怀疑测量干扰, 与已禁用捕获的比较 .
桌面和MCP
反应原生连接需要 @buoy-gg/external-sync。跟踪 桌面连接指南,然后确认所选设备. MCP 磁共振 使用来自 buoy login 在你的电脑上。 自由拥有基本的MCP. 从MCP读取这个工具需要Pro.
设备数据可以通过您的局域网前往配置的经纪人. 账户验证会提出网络请求. 见 遥测 用于数据流动细节.
网络支持(未释放)
浏览器捕捉测量出DOM可聚焦元素并观测出真正的焦点和键盘事件. 它使用现有的同步适配器进行远程检查. 浏览器构建在此取出中是可用的, 尚未发布 。 见 网络设置指南 用于注册、依赖和浏览器边界.