Insights do EAS Update

Consulte a saúde de EAS Updates publicados diretamente da CLI: lançamentos, lançamentos com falha, taxas de crash, usuários únicos, tamanho do payload, a divisão de usuários embarcados vs. OTA por canal e as atualizações mais populares por versão de runtime. Os dados são os mesmos que alimentam as páginas de detalhes de atualização e canal em expo.dev; esses comandos os expõem no terminal em formato legível e JSON.

Quando usar esta habilidade

Use quando o usuário quiser avaliar a saúde ou adoção de um EAS Update publicado: taxas de crash, contagem de instalações, usuários únicos, tamanho do bundle, ou a divisão entre usuários embarcados e OTA em um canal.

Exemplos de prompts:

• "Como está a última atualização?"
• "A última atualização está saudável?"
• "A nova versão está crashando mais que a anterior?"
• "Quantos usuários estão na última atualização em comparação com a build embarcada?"
• "Qual atualização é a mais popular na produção agora?"
• "Qual o tamanho do nosso bundle de atualização?"

Também se encaixa em: monitoramento de rollout pós-publicação e detecção de regressão.

Não use quando o usuário precisar de detalhes de crash por usuário ou relatórios em nível de dispositivo; esta habilidade apenas expõe métricas agregadas do EAS.

Pré-requisitos

• eas-cli instalado (npm install -g eas-cli).
• Logado: eas login.
• Para channel:insights: execute a partir de um diretório de projeto Expo (o comando resolve o ID do projeto a partir de app.json). update:insights só precisa de login.

Comandos em resumo

Todos esses suportam --json --non-interactive para análise programática.

Descobrindo IDs

Antes de consultar insights para um grupo de atualização, você precisa do seu ID group. Use eas update:list com --branch <name> (atualizações nesse branch) ou --all (atualizações em todos os branches). Sempre passe --json --non-interactive ao executar de forma não interativa; sem a flag de branch/--all, o comando solicitará uma seleção de branch:

# Latest group id across all branches
eas update:list --all --json --non-interactive | jq -r '.currentPage[0].group'

# Latest group id on a specific branch
eas update:list --branch production --json --non-interactive | jq -r '.currentPage[0].group'

A resposta JSON tem um array currentPage com uma entrada por grupo de atualização (ambas as plataformas da mesma publicação são colapsadas em uma entrada):

{
  "currentPage": [
    {
      "branch": "production",
      "message": "\"Fix checkout crash\" (1 week ago by someone)",
      "runtimeVersion": "1.0.6",
      "group": "03d5dfcf-736c-475a-8730-af039c3f4d06",
      "platforms": "android, ios",
      "isRollBackToEmbedded": false
    }
  ]
}

As entradas também carregam codeSigningKey e rolloutPercentage, mas apenas quando esses recursos estão em uso para o grupo (valores indefinidos são omitidos da saída JSON).

Quando chamado com --branch <name>, a resposta também inclui name (o nome do branch) e id (o ID do branch) no nível superior.

eas update:insights <groupId>

Mostra lançamentos, lançamentos com falha, taxa de crash, usuários únicos, contagem de ativos de lançamento e tamanho médio do payload para um único grupo de atualização, detalhado por plataforma (iOS, Android), além de um detalhamento diário de lançamentos e falhas.

Uso básico

eas update:insights 03d5dfcf-736c-475a-8730-af039c3f4d06

Flags

Formato da saída JSON

…