expo-observe

EAS Observe

EAS Observe 用于追踪生产环境中 Expo 应用的启动、导航和自定义事件性能。

唯一权威来源： https://docs.expo.dev/eas/observe/ — API 详情至关重要时，请务必查阅官方文档，尤其是入门、配置、集成和指标参考部分。EAS Observe 仍在不断发展；本技能中的参考资料力求保持准确，但可能落后于文档。

应该阅读哪份参考资料

./references/ 中的三个参考文件涵盖了人们通常需要本技能处理的三类事项：

• 在项目中添加 EAS Observe → ./references/setup.md。安装、包装根布局（SDK 55 上使用 AppMetricsRoot，SDK 56+ 上使用 ObserveRoot）、调用 markInteractive()（SDK 55 上为全局函数，SDK 56+ 上通过 useObserve() 钩子调用）、通过 Expo Router / React Navigation 集成添加可选的逐路由导航指标，以及通过 Observe.logEvent 定义用户事件（SDK 56+）。
• 在终端查询指标 → ./references/queries.md。五个 eas observe:* 命令——metrics-summary、metrics、routes、events、versions——及其标志、表格布局、JSON 格式和常见工作流。
• 查看仪表板或 CLI 输出 → ./references/metrics.md。各项指标的目标阈值、TTI frameRate.* 参数的含义，以及用于区分缓慢但流畅的启动、主线程争用或硬阻塞的诊断模式。

文档快捷链接

• 入门：https://docs.expo.dev/eas/observe/get-started/
• 仪表板指南：https://docs.expo.dev/eas/observe/dashboard/
• 指标参考：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/configuration/