什么是 PageSpy?
PageSpy 是一款兼容 Web / 小程序 / React Native / 鸿蒙 App 等平台项目的开源调试平台。基于对原生 API 的封装,它将调用原生方法时的参数进行过滤、转化,整理成一定格式的消息供调试端消费;调试端收到消息数据后,提供类似本地控制台的功能界面将数据呈现出来。
npm install -g @huolala-tech/page-spy-api@latest && page-spy-api
docker run -d --restart=always -v ./log:/app/log -v ./data:/app/data -p 6752:6752 --name="pageSpy" ghcr.io/huolalatech/page-spy-web:latest
执行完成后,打开浏览器访问 http://localhost:6752 即可访问服务。
何时使用?
任何无法在本地使用控制台调试的场景,都是 PageSpy 可以大显身手的时候! 一起来看下面的几个场景案例:
- 本地调试 H5、Webview 应用:以往有些产品提供了可以在 H5 上查看信息的面板,但移动端屏幕太小操作不便、显示不友好,以及信息被截断等问题;
- 远程办公、跨地区协同:传统沟通方式如邮件、电话、视频会议等,沟通效率不高、故障信息不全面,容易误解误判;
- 用户终端上出现白屏问题:传统定位问题的方式包括数据监控、日志分析等,这些方式依赖排障人员要理解业务需求场景、技术实现;
PageSpy 的目标,就是为包括以上场景的人员提供帮助。
主要构成
PageSpy 由以下三个模块组成:
- 调试端:对应 HuolalaTech/page-spy-web 仓库,主要供开发者使用,提供各类调试功能面板,包括在线调试、离线回放等;
- SDK:对应 HuolalaTech/page-spy 仓库,负责将用户项目在运行时产生的数据发送给服务端,并由服务端转发给调试端;
- 服务端:对应 HuolalaTech/page-spy-api 仓库,主要负责中转两端的消息、存储数据等。
什么是 spy-debugger
一站式页面调试、抓包工具。远程调试任何手机浏览器页面,任何手机移动端webview(如:微信,HybridApp等)。支持HTTP/HTTPS,无需USB连接设备。
# 安装命令
npm install spy-debugger -g
# 启动命令
spy-debugger -w true