SuperAPI AI 工具集

eas-observe

测试与质量

查看项目

更新于 10-27 02:30

技能介绍

用途:本技能是针对 Expo Application Services(EAS)的性能监控产品 EAS Observe 的上游指引合集,适合在用户目标与该工作流匹配时参考使用。

主要能力与内容组织:技能附带的四个参考文件分别覆盖常见使用需求。1)接入项目(setup.md):安装、包裹根布局(SDK 55 用 AppMetricsRoot,SDK 56+ 用 ObserveRoot)、标记应用可交互(SDK 55 用全局 markInteractive(),SDK 56+ 用 useObserve() hook 或 <ObserveInteractiveMarker />)、可选的按路由导航指标(通过 Expo Router / React Navigation 集成)、用户自定义事件(SDK 56+ 的 Observe.logEvent)、错误上报,以及运行时配置(采样、分发、环境、自定义端点)。2)终端查询指标(queries.md):六个 eas observe:* 命令——metrics-summary、metrics、routes、events、session、versions,含参数、指标别名、表格布局、JSON 结构和常见工作流。3)解读输出(metrics.md):各指标目标阈值、自动 TTI 参数(frameRate.、device.、network.*)的含义,以及区分“慢但流畅的启动”与主线程争用、硬阻塞、设备降频等情况的诊断模式。4)库集成(third-party.md):仅面向包作者(SDK 57+),涉及可选 peer 依赖、配置声明合并、Observe.registerIntegration() 和事件命名。

使用方式与授权隐私:启用采集、发送事件或启动付费构建前,需确认现有 EAS 账号/项目、遥测数据政策和当前计划。添加埋点可能传输路由、标识符、错误信息/堆栈和请求主机;不得采集密钥或不必要的个人数据,应使用合成测试数据,启用集成前审查路由过滤,并在已安装的 SDK 上验证行为;未经授权不得将遥测重定向到自定义端点。准备集成并不等于授权创建 EAS 项目、进行依赖级修复、构建或提交反馈。反馈命令会下载并执行一个包并向外部发送数据,仅在明确要求时使用,且需对内容做脱敏。

适用场景:为生产环境 Expo 应用采集启动、导航和自定义事件性能数据;在终端查询指标;解读仪表盘或 CLI 输出;为库提供 Observe 集成。

限制:EAS Observe 是 EAS 产品,会产生费用;免费 EAS 计划每月活跃用户上限 10,000,功能有限,更高用量需付费订阅(详见 https://expo.dev/pricing#plan-features)。需要开发或生产构建,Expo Go 中不含该原生库。资料以 https://docs.expo.dev/eas/observe/ 为准,涉及 API 细节(入门、配置、集成、指标参考)时应查阅官方文档;技能参考可能滞后于文档。资料记录了基于 eas-cli 21.8.0 和 expo-observe 57.0.9 的已知差异(属上游快照观察,非即时验证):六个 CLI 命令中旧版文档只列四个;导航指标别名为 nav_cold_ttr、nav_warm_ttr、nav_tti;排序用 --sort <slowest|fastest|newest|oldest>,无 --order;ObserveErrorBoundary、Observe.reportError、configure({ errorHandlingEnabled }) 已导出但未写入文档;Observe 仍无崩溃报告,需用 Sentry 或 BugSnag。反馈可通过 npx --yes submit-expo-feedback@latest --category skills --subject "eas-observe" "<actionable feedback>" 提交,仅在有具体可操作问题时使用。本技能为导入的上游技能,执行前应核实凭据、权限和安全边界,不替代特定环境的验证、测试或维护者审查。