Quando Usar

• Use quando este fluxo de trabalho anterior corresponder ao objetivo declarado do usuário.
• Use quando a tarefa exigir os procedimentos documentados nesta habilidade.

EAS Observe

Serviço EAS - custos se aplicam. O EAS Observe é um produto do Expo Application Services. O plano gratuito do EAS permite até 10.000 usuários ativos mensais, com um conjunto limitado de recursos; uso mais elevado requer uma assinatura paga. Para detalhes, veja https://expo.dev/pricing#plan-features.

O EAS Observe rastreia o desempenho de inicialização, navegação e eventos personalizados de aplicativos Expo em produção. Ele precisa de uma build de desenvolvimento ou produção — a biblioteca nativa não está no Expo Go.

Fonte da verdade: https://docs.expo.dev/eas/observe/ — sempre consulte a documentação canônica quando detalhes da API forem importantes, especialmente para começar, configuração, integrações e a referência de métricas. O EAS Observe está em evolução; as referências desta habilidade são escritas para permanecerem precisas, mas podem ficar desatualizadas em relação à documentação.

Qual referência ler

Os quatro arquivos de referência em ./references/ cobrem o que as pessoas tipicamente precisam desta habilidade para:

• Adicionar EAS Observe a um projeto → [./references/setup.md]. Instale, envolva o layout raiz (AppMetricsRoot no SDK 55, ObserveRoot no SDK 56+), marque o aplicativo como interativo (markInteractive() global no SDK 55, o hook useObserve() ou <ObserveInteractiveMarker /> no SDK 56+), métricas de navegação opcionais por rota através das integrações Expo Router / React Navigation, eventos definidos pelo usuário via Observe.logEvent (SDK 56+), relatórios de erros e configuração em tempo de execução (amostragem, despacho, ambientes, endpoint personalizado).
• Consultar métricas do terminal → [./references/queries.md]. Os seis comandos eas observe:* — metrics-summary, metrics, routes, events, session, versions — com flags, aliases de métricas, layouts de tabela, formatos JSON e fluxos de trabalho comuns.
• Ler um painel ou saída do CLI → [./references/metrics.md]. Limiares alvo por métrica, o que os parâmetros automáticos de TTI significam (frameRate.*, device.*, network.*) e padrões de diagnóstico para distinguir inicialização lenta, mas suave, de contenção da thread principal, bloqueios rígidos ou dispositivos com desempenho limitado.
• Publicar uma integração Observe em uma biblioteca → [./references/third-party.md]. Apenas para autores de pacotes (SDK 57+): dependência peer opcional, mesclagem de declaração de configuração, Observe.registerIntegration() e nomenclatura de eventos.

Links rápidos para a documentação

• Começar: https://docs.expo.dev/eas/observe/get-started/
• Guia do painel: https://docs.expo.dev/eas/observe/dashboard/
• Consultando com EAS CLI: https://docs.expo.dev/eas/observe/eas-cli/
• Referência de métricas: https://docs.expo.dev/eas/observe/reference/metrics/
• Integração com Expo Router: https://docs.expo.dev/eas/observe/integrations/expo-router/
• Integração com React Navigation: https://docs.expo.dev/eas/observe/integrations/react-navigation/
• Eventos definidos pelo usuário: https://docs.expo.dev/eas/observe/events/
• Configuração: https://docs.expo.dev/eas/observe/configuration/
• Integrações de terceiros: https://docs.expo.dev/eas/observe/integrations/third-party/
• Desempenho de download do EAS Update: https://docs.expo.dev/eas/observe/eas-update/
• Solução de problemas: https://docs.expo.dev/eas/observe/reference/troubleshooting/

Lacunas conhecidas entre a documentação e o código publicado

Verificado contra eas-cli 21.8.0 e expo-observe 57.0.9. Confie nas referências desta habilidade em vez da documentação nesses pontos, mas verifique novamente com --help e o pacote instalado antes de confiar nelas:

• Todos os seis comandos CLI estão na página Consultando com EAS CLI. Builds de documentação mais antigas listam apenas quatro e omitem observe:routes e observe:session.
• Os aliases de métricas de navegação são nav_cold_ttr, nav_warm_ttr e nav_tti. Não há aliases cold_ttr / warm_ttr puros no CLI.
• A ordenação usa --sort <slowest|fastest|newest|oldest>. Não há flag --order.
• ObserveErrorBoundary, Observe.reportError e configure({ errorHandlingEnabled }) são exportados, mas não documentados. O Observe ainda não tem relatórios de falhas; use Sentry ou BugSnag para isso.

Envio de Feedback

Se você encontrar erros, informações enganosas ou desatualizadas nesta habilidade, relate para que o Expo possa melhorar:

npx --yes submit-expo-feedback@latest --category skills --subject "eas-observe" "<actionable feedback>"

Envie apenas quando tiver algo específico e acionável para relatar. Inclua o máximo de contexto relevante possível.

…