EAS Observe
EAS 服务——需付费。 EAS Observe 是 Expo Application Services 的产品。免费的 EAS 计划允许最多 10,000 名月活跃用户,功能有限;更高用量需要付费订阅。详情请见 https://expo.dev/pricing#plan-features。
EAS Observe 跟踪生产环境 Expo 应用的启动、导航和自定义事件性能,并记录 JavaScript 错误和原生崩溃。它需要开发或生产构建——原生库不包含在 Expo Go 中。
信息来源: https://docs.expo.dev/eas/observe/ —— 当 API 细节重要时,请务必查阅权威文档,特别是入门、配置、集成和指标参考。EAS Observe 正在不断演进;本技能的参考内容力求准确,但可能落后于官方文档。
应阅读哪些参考资料
./references/ 目录下的四个参考文件涵盖了用户通常需要本技能处理的场景:
- 将 EAS Observe 添加到项目 →
./references/setup.md。安装、包装根布局(SDK 55 使用AppMetricsRoot,SDK 56+ 使用ObserveRoot)、标记应用可交互(SDK 55 使用全局markInteractive(),SDK 56+ 使用useObserve()钩子或<ObserveInteractiveMarker />)、通过 Expo Router / React Navigation 集成的可选路由级导航指标、通过Observe.logEvent定义用户事件(SDK 56+)、错误报告以及运行时配置(采样、调度、环境、自定义端点)。 - 从终端查询指标 →
./references/queries.md。eas observe:*命令——metrics-summary、metrics、routes、events、session、versions、errors、event——以及相关标志、指标别名、表格布局、JSON 格式和常见工作流程。 - 阅读仪表盘或 CLI 输出 →
./references/metrics.md。每个指标的目标阈值、自动 TTI 参数的含义(frameRate.*、device.*、network.*),以及区分“慢但流畅”的启动与主线程争用、硬阻塞或设备限流的诊断模式。 - 在库中发布 Observe 集成 →
./references/third-party.md。仅适用于包作者(SDK 57+):可选的 peer 依赖项、配置声明合并、Observe.registerIntegration()以及事件命名。
文档快速链接
- 入门指南:https://docs.expo.dev/eas/observe/get-started/
- 仪表盘指南:https://docs.expo.dev/eas/observe/dashboard/
- 使用 EAS CLI 查询:https://docs.expo.dev/eas/observe/eas-cli/
- 指标参考:https://docs.expo.dev/eas/observe/reference/metrics/
- Expo Router 集成:https://docs.expo.dev/eas/observe/integrations/expo-router/
- React Navigation 集成:https://docs.expo.dev/eas/observe/integrations/react-navigation/
- 用户自定义事件:https://docs.expo.dev/eas/observe/events/
- 错误报告:https://docs.expo.dev/eas/observe/errors/
- 配置:https://docs.expo.dev/eas/observe/configuration/
- 第三方集成:https://docs.expo.dev/eas/observe/integrations/third-party/
- EAS Update 下载性能:https://docs.expo.dev/eas/observe/eas-update/
- 故障排除:https://docs.expo.dev/eas/observe/reference/troubleshooting/
提交反馈
如果您在此技能中遇到错误、误导性或过时的信息,请报告以便 Expo 改进:
npx --yes @expo/agent-cli@latest feedback --category skills --subject "eas-observe" "<可操作的反馈>"
仅在您有具体且可操作的内容要报告时才提交。请尽可能包含相关上下文。
如果代理反复未能完成 Expo 任务,或者用户必须介入,请使用 --category evals 和相关的 Expo 包或命令作为 --subject 提交简要报告,说明任务、预期结果和出错情况。