@buoy-gg/ 外部同步
连接一个 React Environment app的Buoy工具到Buoy桌面或MCP. 这个包提供了设备侧套接字连接,适配器同步,以及远程动作处理. 大部分应用程序通过配置 FloatingDevTools 从 @buoy-gg/core。 。 。 .
Capacitor / Ionic (Beta) 通过此软件包 /web。 。 。 .
见 设置指南 用于步骤和限制.
安装
npm install @buoy-gg/core @buoy-gg/external-sync @buoy-gg/network
账户设置
开始开发建设。 你需要一个免费或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不会自己装入文件。 用你的应用软件的套装把信使递过来 将菜单保存在您的应用程序使用的供应商内部 。 安装软件包后重新启动开发服务器 。 见 快速启动 用于完整的根组件.
连接您的应用程序
在账户初始化后将菜单挂载在您现有的根组件中 :
import { FloatingDevTools } from "@buoy-gg/core";
<FloatingDevTools />;
打开桌面并签名 在开发中,应用程序通常从Metro获得经纪人地址. 如果您的网络或博览会隧道设置需要明确地址,请将上面的菜单替换为:
<FloatingDevTools
externalSync={{ socketURL: "http://YOUR_COMPUTER_LAN_IP:42831" }}
/>;
socketURL 有大写 URL。 设备必须能够到达该地址;地铁隧道不会自动暴露经纪人. 对于飞过USB的Android,请遵循该机的左上方指示 桌面指南。 。 。 .
在桌面中选择设备, 在应用程序中触发一个新的 HTTP 请求, 并检查它是否出现在 Network 中 。 如果没有设备出现,请检查账户的状态、经纪人地址和网络连接。 如果设备出现但面板为空,则检查工具的安装并捕获路径.
无头和放行
<FloatingDevTools headless /> 保持连接集成而不使用浮动菜单。 它仍然需要账户访问和配置的工具.
发布同步默认被禁用 。 对于带有Pro的已授权内部发布架构,请明确配置:
<FloatingDevTools
headless
externalSync={{
enableInRelease: true,
socketURL: "http://YOUR_COMPUTER_LAN_IP:42831",
}}
/>;
在启动此集成前应用您的应用程序的授权检查 。 启用同步不会使只开发工具在发行中发挥作用.
自定义集成
公共出口包括: useExternalSyncSocket, (中文(简体) ), useExternalSync, (中文(简体) ), ToolSyncAdapter, URL 帮助器,同步状态订阅器, 以及崩溃模糊帮助器 。 一个适配器提供快照,订阅和命名动作. 大桥根据仪表表板状态和节流器更新来订阅;它还强制设备账户的录入.
优先选择核心集成, 除非你正在建立自定义主机 。 直接钩子集成必须管理套接字和设备身份,账户初始化,适配器生命周期,以及动作授权. 使用导出选项类型和 自定义工具指南。 。 。 .
桌面和MCP
反应原生连接需要 @buoy-gg/external-sync。跟踪 桌面连接指南,然后确认所选设备. MCP 磁共振 使用来自 buoy login 在你的电脑上。 自由拥有基本的MCP. Pro增加了完整的MCP.
设备数据可以通过您的局域网前往配置的经纪人. 账户验证会提出网络请求. 见 遥测 用于数据流动细节.