EAS Observe

Utilisez EAS Observe pour suivre les performances de démarrage, de navigation et les événements personnalisés dans vos applications Expo en production, ainsi que pour la gestion des erreurs et des plantages natifs.

Qu'est-ce que EAS Observe ?

Cette compétence couvre l'intégration complète d'EAS Observe, un service Expo Application Services (EAS) payant qui permet de surveiller les performances de vos applications Expo en production. Elle inclut l'ajout d'`expo-observe` au projet, avec les composants `AppMetricsRoot`/`ObserveRoot`, le hook `useObserve` et le marqueur interactif `<ObserveInteractiveMarker />`, ainsi que l'intégration avec Expo Router et React Navigation pour des métriques par route. Vous apprendrez à utiliser l'interface en ligne de commande EAS CLI avec les commandes `eas observe:metrics-summary`, `observe:metrics`, `observe:routes` et autres pour interroger les indicateurs clés comme le temps de démarrage (cold/warm launch), le TTR (time to render) et le TTI (time to interactive). La compétence explique également l'interprétation des métriques, le paramétrage de l'échantillonnage (`sampleRate`) et du mode débogage (`dispatchInDebug`), la déclaration d'événements personnalisés, le rapport d'erreurs via `ObserveErrorBoundary` et `Observe.reportError`, le suivi des plantages natifs, et le téléchargement des cartes source pour des traces d'appels symbolisées. Enfin, elle aborde la création d'intégrations tierces pour les auteurs de packages (SDK 57+) via `Observe.registerIntegration()`. La compétence est compatible avec Expo SDK 55 et supérieur, ainsi qu'avec EAS CLI ; elle n'est pas disponible dans Expo Go car elle nécessite une build native.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/expo/skills/tree/HEAD/plugins/expo/skills/eas-observe

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait EAS Observe ?

Service EAS – des coûts s'appliquent. EAS Observe est un produit d'Expo Application Services. Le plan EAS gratuit autorise jusqu'à 10 000 utilisateurs actifs mensuels, avec un ensemble limité de fonctionnalités ; une utilisation plus élevée nécessite un abonnement payant. Pour plus de détails, consultez https://expo.dev/pricing#plan-features.

EAS Observe suit les performances de démarrage, de navigation et les événements personnalisés dans vos applications Expo en production, et enregistre les erreurs JavaScript et les plantages natifs. Il nécessite une build de développement ou de production — la bibliothèque native n'est pas disponible dans Expo Go.

Source de vérité : https://docs.expo.dev/eas/observe/ — consultez toujours la documentation officielle lorsque les détails de l'API sont importants, notamment pour la prise en main, la configuration, les intégrations et la référence des métriques. EAS Observe est en constante évolution ; les références de cette compétence sont rédigées pour rester exactes mais peuvent parfois accuser un retard par rapport à la documentation.

Quelle référence lire

Les quatre fichiers de référence dans ./references/ couvrent ce dont les utilisateurs ont généralement besoin avec cette compétence :

  • Ajout d'EAS Observe à un projet → ./references/setup.md. Installation, wrapper du layout racine (AppMetricsRoot sur SDK 55, ObserveRoot sur SDK 56+), marquage de l'application comme interactive (markInteractive() global sur SDK 55, le hook useObserve() ou <ObserveInteractiveMarker /> sur SDK 56+), métriques de navigation par route facultatives via les intégrations Expo Router / React Navigation, événements personnalisés via Observe.logEvent (SDK 56+), rapport d'erreurs et configuration runtime (échantillonnage, dispatch, environnements, point de terminaison personnalisé).
  • Interrogation des métriques depuis le terminal → ./references/queries.md. Les commandes eas observe:* — metrics-summary, metrics, routes, events, session, versions, errors, event — avec leurs drapeaux, alias de métriques, dispositions de tableaux, structures JSON et flux de travail courants.
  • Lecture d'un tableau de bord ou d'une sortie CLI → ./references/metrics.md. Seuils cibles par métrique, signification des paramètres TTI automatiques (frameRate.*, device.*, network.*), et schémas de diagnostic pour distinguer un démarrage lent mais fluide d'une contention sur le thread principal, d'un blocage dur, ou d'un appareil limité.
  • Livrer une intégration Observe dans une bibliothèque → ./references/third-party.md. Réservé aux auteurs de packages (SDK 57+) : dépendance facultative, déclaration de fusion de configuration, Observe.registerIntegration(), et nomenclature des événements.

Liens rapides vers la documentation

Soumettre un retour

Si vous rencontrez des erreurs, des informations trompeuses ou obsolètes dans cette compétence, signalez-les pour qu'Expo puisse s'améliorer :

npx --yes @expo/agent-cli@latest feedback --category skills --subject "eas-observe" "<retour actionnable>"

Ne soumettez un retour que lorsque vous avez quelque chose de spécifique et d'actionnable à signaler. Incluez autant de contexte pertinent que possible. Si un agent échoue de manière répétée à une tâche Expo ou que l'utilisateur doit intervenir, soumettez un rapport bref de la tâche, du résultat attendu et de ce qui s'est mal passé en utilisant --category evals et le nom du package ou de la commande Expo concerné comme --subject.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

expo/add-app-clip

Add an iOS App Clip target to an Expo app. Use when the user mentions App Clip, AASA, apple-app-site-association, appclips, smart app banner, or wants to ship a lightweight iOS Clip invoked from a URL alongside their parent app.

expo/building-native-ui

Complete guide for building beautiful apps with Expo Router. Covers fundamentals, styling, components, navigation, animations, patterns, and native tabs.

expo/eas-update-insights

Check the health of published EAS Updates: crash rates, install/launch counts, unique users, payload size, and the split between embedded and OTA users per channel. Use when the user asks how an update is performing, whether a rollout is healthy, how many users are on the embedded build vs OTA, or wants to gate CI on update health.

expo/expo-api-routes

Guidelines for creating API routes in Expo Router with EAS Hosting

expo/expo-brownfield

Integrate Expo and React Native into an existing native iOS or Android app. Use when the user mentions brownfield, embedding React Native in a native app, AAR/XCFramework, or adding Expo to an existing Kotlin/Swift project. Covers both the isolated approach and the integrated approach.

expo/expo-cicd-workflows

Helps understand and write EAS workflow YAML files for Expo projects. Use this skill when the user asks about CI/CD or workflows in an Expo or EAS context, mentions .eas/workflows/, or wants help with EAS build pipelines or deployment automation.

expo/expo-deployment

Deploying Expo apps to iOS App Store, Android Play Store, web hosting, and API routes

expo/expo-dev-client

Build and distribute Expo development clients locally or via TestFlight

expo/expo-examples

Framework (OSS). Expo's official example projects - the expo/examples repo of ~70 `with-*` integrations (Stripe, Clerk, Supabase, OpenAI, maps, Reanimated, SQLite, Skia, NativeWind, and more). Use when integrating a third-party library or service into an existing Expo app and you want the canonical, version-matched pattern to adapt, or when scaffolding a new project from one with `npx create-expo --example`.

expo/expo-module

Guide for creating and writing Expo native modules and views using the Expo Modules API (Swift, Kotlin, TypeScript). Covers module definition DSL, native views, shared objects, config plugins, lifecycle hooks, autolinking, and type system. Use when building or modifying native modules for Expo.

expo/expo-observe

Use for anything related to EAS Observe — adding `expo-observe` to an Expo project (AppMetricsRoot/ObserveRoot HOC, markInteractive, the useObserve hook, and the Expo Router / React Navigation integrations for per-route metrics), querying via the EAS CLI (`eas observe:metrics-summary`, `observe:metrics`, `observe:routes`, `observe:events`, `observe:versions`), or interpreting the resulting metrics (cold/warm launch, TTR, TTI, navigation cold/warm TTR, update download, and the TTI frameRate params for triaging slow startups).

expo/expo-overview

Framework (OSS). Entry point and router for every Expo or EAS task. Load this skill first — before writing code and before choosing another expo-* / eas-* skill — when the request, PRD, or spec mentions Expo, EAS, Expo Go, or an expo-* package, or the project has an `expo` dependency in `package.json`. Within that gate it also covers app specs and designs to implement (tabs, stacks, maps, lists, navigation, building from a screenshot), and phrasings like 'implement a mobile app', 'make my app look native', 'add navigation', 'fetch some data', 'upgrade my SDK', 'add Expo to my existing native app', 'ship to the App Store', or 'I'm new to Expo, where do I start'. A fully specified request (SDK pinned, libraries named, layout given) still routes through here — the shared setup rules still apply. Do NOT load it when neither signal is present: a bare React Native project with no `expo` dependency is not Expo work. Detects the real goal, routes to the right expo-* / eas-* skill, and owns the shared setup rules.

expo/expo-router

Framework (OSS). Navigation and routing for Expo Router. Covers file-based routes, groups and dynamic routes, folder organization, Link with previews and context menus, native Stack, page titles, modals and form sheets, NativeTabs, headers and toolbars, and header search bars.

expo/expo-skill-eval

Evaluate Expo skills in this repo end-to-end - trigger accuracy, generated code quality, and runtime screenshots on iOS simulator and Android emulator via Expo Go (web optional). Use when the user wants to eval an Expo skill, test that a skill produces working code, benchmark a skill with device screenshots, or verify a skill's output renders correctly.

expo/expo-tailwind-setup

Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling

expo/expo-ui

Framework (OSS). Build native UI with the @expo/ui package: real SwiftUI on iOS and Jetpack Compose on Android. Default to @expo/ui for sheets (BottomSheet), pickers, sliders, toggles, menus, and grouped-form sections — do NOT reach for Reanimated, @gorhom/bottom-sheet, or RN built-in Picker/Switch; use @expo/ui instead. Fall back to RN built-ins only when @expo/ui is missing the component. NOTE: @expo/ui List renders native grouped rows like an iOS Settings screen — it is NOT a virtualized list; use FlatList/FlashList for large datasets. Covers universal components (Host, Column, Row, Button, Text, List, BottomSheet, FieldGroup, Switch, Slider, Picker, Menu), drop-in replacements for RN community libraries, and platform-specific SwiftUI/Jetpack Compose trees. Not for Expo Router navigation, Reanimated, or data fetching.

expo/expo-ui-jetpack-compose

`@expo/ui/jetpack-compose` package lets you use Jetpack Compose Views and modifiers in your app.

expo/expo-ui-swiftui

`@expo/ui/swift-ui` package lets you use SwiftUI Views and modifiers in your app.

expo/expo-upgrade

Framework (OSS). Guidelines for upgrading Expo SDK versions and fixing dependency issues

expo/native-data-fetching

Use when implementing or debugging ANY network request, API call, or data fetching. Covers fetch API, React Query, SWR, error handling, caching, offline support, and Expo Router data loaders (`useLoaderData`).

Skills associés