This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
EAS 观察简介
EAS Observe 是一项性能监控服务，可跟踪你的应用在真实设备和各种条件下的生产环境中的表现。
重要 EAS Observe 正处于开放测试。前 10,000 名每月活跃用户免费。使用更多请联系 sales@expo.dev。
EAS Observe 是 Expo 提供的一项性能监控服务，用于跟踪你的应用在生产环境中的表现。它让你能够了解在不同设备、网络和条件下的真实启动时间、渲染性能和用户体验。
在 React Native 中，调试性能传统上仅限于开发工具。EAS Observe 关注于生产环境，在那里性能特性与开发过程中看到的有显著不同。
🌐 Debugging performance in React Native has traditionally been limited to development tools. EAS Observe focuses on production, where performance characteristics differ significantly from what you see during development.
查看 EAS Observe 如何从你的生产应用中，在不同设备、网络和条件下揭示真实世界的启动和渲染性能。
快速开始
🌐 Quick start
# Install the library- npx expo install expo-observe用 AppMetricsRoot 组件（SDK 55）或 ObserveRoot 组件（SDK 56 及更高版本）封装你的根布局，并在应用准备好接受用户输入时调用 markInteractive()。完整的设置指南请参见 入门。
🌐 Wrap your root layout with the AppMetricsRoot component (SDK 55) or the ObserveRoot component (SDK 56 and later) and call markInteractive() when your app is ready for user input. See Get started for the full setup guide.
为什么观察EAS
🌐 Why EAS Observe
传统的开发时性能分析工具显示你的应用在你的机器上的表现。EAS Observe 显示它在真实用户中的表现：
🌐 Traditional development-time profiling tools show how your app performs on your machine. EAS Observe shows how it performs for real users:
- 生产性能数据：跟踪来自各种设备的真实用户会话中的启动时间、渲染性能和包加载时间
- 版本比较：查看应用版本和 OTA 更新之间指标的变化，以便及早发现回归问题
- 会话调查：深入分析单个用户会话，以了解为什么某些设备或条件导致性能较慢
- CLI 和仪表板访问：通过
eas observe:命令在终端查询指标，或在 EAS 仪表板中查看它们
何时使用 EAS Observe
🌐 When to use EAS Observe
| 场景 | 建议 |
|---|---|
| 在生产环境中监控应用启动性能 | |
| 比较不同版本和 OTA 更新的性能 | |
| 调查特定设备上的慢速会话 | |
| 从 CLI 查询性能指标 | |
| 开发时的性能分析和调试 | |
| 崩溃报告和错误跟踪 | |
| 自定义分析和事件追踪 |
开发时分析和调试：使用 React Native DevTools 进行调试，使用 Expo Atlas 进行包检查。
崩溃报告和错误跟踪：这是未来计划为 EAS Observe 添加的功能。在此期间，我们建议使用诸如 Sentry 或 BugSnag 的崩溃报告服务。
自定义分析和事件跟踪：这是未来计划为 EAS Observe 添加的功能。在此期间，请从 React Native 分析指南 中选择一个分析提供商，例如 PostHog、Amplitude 或 Firebase Analytics。
常见问题
🌐 Frequently asked questions (FAQ)
EAS Observe 跟踪哪些指标？
EAS Observe 关注启动指标：冷启动时间、热启动时间、首次渲染时间、可交互时间和包加载时间。有关每个指标的详细描述，请参见 指标参考。
🌐 EAS Observe focuses on startup metrics: cold launch time, warm launch time, time to first render, time to interactive, and bundle load time. See the Metrics reference for detailed descriptions of each metric.
支持哪些平台？
EAS Observe 支持 Android 和 iOS。指标从生产版本中收集，并且可以在仪表板和命令行接口中按平台过滤。
🌐 EAS Observe supports Android and iOS. Metrics are collected from production builds and can be filtered by platform in both the dashboard and CLI.
EAS Observe 在 Expo Go 中可用吗？
不。EAS Observe 依赖于 expo-observe 原生库，而 Expo Go 并未包含该库。要使用它，请创建一个 开发构建 或生产构建。
🌐 No. EAS Observe relies on the expo-observe native library, which is not included in Expo Go. To use it, create a development build or a production build.
EAS Observe 是否收集可识别个人身份的信息？
不。用户通过每次应用安装唯一的匿名 ID 进行识别。该 ID 不属于个人可识别信息，如果用户卸载并重新安装应用，该 ID 会被重置。更多详情请参见 Metrics reference: User。
🌐 No. Users are identified by an anonymous ID that is unique per app installation. This ID is not personally identifiable and is reset if the user uninstalls and reinstalls the app. See Metrics reference: User for more details.
当设备离线时会发生什么？
离线收集的指标会存储在设备本地。当应用进入后台且有可用连接时，它们会自动发送。你也可以使用 dispatchEvents() 手动刷新事件。
🌐 Metrics collected while offline are stored locally on the device. They are automatically dispatched when the app moves to the background and connectivity is available. You can also flush events manually using dispatchEvents().
我可以在开发过程中测试指标吗？
默认情况下，从调试版本收集的指标不会被发送。你可以通过 configure() 将 dispatchInDebug 设置为 true 来进行测试时发送它们。详细信息请参见 配置。
🌐 By default, metrics collected from debug builds are not dispatched. You can dispatch them anyway for testing by setting dispatchInDebug to true via configure(). See Configuration for details.
开始使用
🌐 Get started
安装该库并开始从你的生产应用收集指标。
查看指标，按平台或版本筛选，并调查单个会话。
控制环境、调度和开发模式设置。
每个指标、概念和数据处理的详细描述。