jq, rg & Logs JSON

Q: jq vs python -m json.tool?

json.tool apenas imprime formatado - sem filtragem. jq seleciona campos, mapeia arrays e sai com erros para guardas de CI.

Q: Como obtenho JSON para um ID de build específico?

eas build:view --json Combine com jq '.artifacts.buildUrl'

Q: rg não encontrado no GitHub ubuntu-latest?

sudo apt-get install -y ripgrep ou cargo install ripgrep. Muitas equipes adicionam uma etapa de configuração uma vez por fluxo de trabalho.

Q: jq pode analisar a saída do eas submit?

eas submit:list --json - mesmos padrões para status de submissão e links ASC/Play.

Q: Como busco logs do Metro na CI?

Salve a saída do Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log. Combine com falhas de npx expo export registradas em wrappers JSON.

jq e rg (ripgrep) são a camada de inspeção rápida para JSON de CI e EAS - extraia URLs de artefatos de eas build:list, busque logs JSONL por Gradle failure e conecte saídas do GitHub Actions sem um script Node descartável. Nas equipes do Expo SDK 57, essas duas ferramentas transformam metadados de build na nuvem em bash que você pode registrar no repositório.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# Última URL de APK Android de produção finalizada
eas build:list --platform android --status finished --limit 1 --json \
  | jq -r '.[0].artifacts.buildUrl // empty'
 
# Download de .app de simulador iOS + ID do bundle do mesmo blob JSON
eas build:list --platform ios --status finished --limit 1 --json \
  | jq -r '.[0] | "\(.applicationArchiveUrl // .artifacts.buildUrl)\t\(.buildDetails?.buildConfiguration ?? "n/a")"'
 
# Busca no log JSON exportado do EAS/GitHub por assinatura de falha
rg -n '"level":"error"|Gradle failure|pod install' ./artifacts/build-logs.jsonl
 
# GitHub Actions: define saída para etapa de instalação downstream
echo "apk_url=$(jq -r '.[0].artifacts.buildUrl' build.json)" >> "$GITHUB_OUTPUT"

Quando usar isso:

A CI precisa da última URL de build verde após eas build --wait.
Você está triando um arquivo de log EAS de 40 MB para a primeira linha de error.
Um script precisa ramificar com base em buildProfile ou gitCommitHash do JSON.
Você deseja consultas portáteis que rodem identicamente em agentes macOS e Linux.
Bots de PR comentam com links de build de pré-visualização analisados de eas build:list.

Exemplo de Trabalho

GitHub Actions: espera pelo EAS, extrai URL do APK, instala no emulador, busca logs em caso de falha.

#!/usr/bin/env bash
# scripts/ci/fetch-latest-apk.sh - executa após eas build --wait
set -euo pipefail
 
PLATFORM="${1:-android}"
PROFILE="${2:-preview}"
OUT_JSON="${3:-./eas-last-build.json}"
 
eas build:list \
  --platform "$PLATFORM" \
  --buildProfile "$PROFILE" \
  --status finished \
  --limit 1 \
  --json > "$OUT_JSON"
 
# Falha ruidosamente se não houver artefato
APK_URL=$(jq -er '.[0].artifacts.buildUrl' "$OUT_JSON")
BUILD_ID=$(jq -er '.[0].id' "$OUT_JSON")
GIT_SHA=$(jq -r '.[0].gitCommitHash // "unknown"' "$OUT_JSON")
 
echo "build_id=$BUILD_ID" >> "${GITHUB_OUTPUT:-/dev/null}"
echo "apk_url=$APK_URL" >> "${GITHUB_OUTPUT:-/dev/null}"
echo "git_sha=$GIT_SHA" >> "${GITHUB_OUTPUT:-/dev/null}"
 
curl -fsSL "$APK_URL" -o ./artifacts/app.apk
adb install -r ./artifacts/app.apk

Em caso de falha - baixa logs e ripgrep:

# O EAS imprime a URL do log no JSON de build quando disponível
LOG_URL=$(jq -r '.[0].logFiles[]? // empty' eas-last-build.json | head -1)
curl -fsSL "$LOG_URL" -o ./artifacts/build.log
 
rg -n --max-count 5 'FAILURE|error:|❌|Gradle failure|pod install' ./artifacts/build.log
jq -r 'select(.level=="error") | .message' ./artifacts/build.jsonl 2>/dev/null || true

O que isso demonstra:

jq -er - sai com código de erro não zero quando o campo está ausente; a CI falha em vez de instalar uma URL vazia.
Filtros eas build:list - platform, buildProfile, status restringem ao artefato que você pretende.
curl -fsSL - falha silenciosa em páginas de erro HTML 404 que se disfarçam de artefatos.
rg --max-count - as primeiras cinco linhas de falha sem rolar megabytes.
GitHub $GITHUB_OUTPUT - etapas downstream adb install ou Maestro consomem campos analisados.

Mergulho Profundo

Como Funciona

EAS CLI pode emitir JSON (--json) para build:list, build:view, submit:list e similares - estável para scripts.
jq é uma linguagem de consulta JSON - filtros rodam em milissegundos em arquivos de tamanho de CI.
rg busca recursivamente texto com padrões sensatos - mais rápido que grep -R, respeita .gitignore.
JSONL (um objeto JSON por linha) aparece em telemetria exportada - jq lê linha por linha com -c ou inputs.

Mapa de Campos do EAS build:list

Caminho jq	Significado
`.[0].id`	UUID de build para `eas build:view`
`.[0].status`	`finished`, `errored`, `canceled`, `in-progress`
`.[0].platform`	`ios` ou `android`
`.[0].buildProfile`	`development`, `preview`, `production`
`.[0].gitCommitHash`	Commit que o EAS construiu
`.[0].artifacts.buildUrl`	Artefato instalável (APK/AAB/IPA/simulador)
`.[0].applicationArchiveUrl`	Link alternativo de arquivo em alguns perfis
`.[0].logFiles[]`	URLs de log remotas quando presentes

# Imprime formatado o último build completo
eas build:list --limit 1 --json | jq '.[0]'
 
# Tabela dos últimos 10 builds
eas build:list --limit 10 --json \
  | jq -r '.[] | [.id[0:8], .platform, .buildProfile, .status, .createdAt] | @tsv'
 
# Encontra o último build de produção Android com erro
eas build:list --platform android --status errored --limit 1 --json \
  | jq '.[0] | {id, error: .error.message}'

Padrões jq para CI

# Padrão seguro com operador //
jq -r '.[0].artifacts.buildUrl // "none"'
 
# Requer campo ou sai com 1
jq -er '.[0].artifacts.buildUrl' build.json > apk.url
 
# Mapeia todas as URLs de artefatos (builds de matriz)
jq -r '.[] | select(.status=="finished") | .artifacts.buildUrl'
 
# Extrai configuração Expo aninhada de metadados personalizados (se seu pipeline a adicionar)
jq -r '.[0].metadata | fromjson? | .updateGroup // empty'
 
# Lê array JSON de um arquivo sem pipe stdin
jq -r '.[0].id' < eas-last-build.json

Padrões rg para Logs

# Primeiro Gradle OOM no log EAS Android
rg -m 1 'OutOfMemoryError|Java heap space' artifacts/android-build.log
 
# Falha de resolução do CocoaPods (iOS)
rg -n 'CocoaPods could not find compatible versions|pod install' artifacts/ios-build.log
 
# JSONL: linhas contendo nível de erro (ripgrep literal)
rg '"level":"error"' artifacts/telemetry.jsonl
 
# Busca pasta CI mas apenas markdown/json
rg -g '*.{json,jsonl,log}' 'buildProfile' .github/
 
# Linhas de contexto ao redor da correspondência (como grep -C)
rg -C 3 'Metro bundler' artifacts/expo-start.log

Pipelines: Comenta PR com Links de Pré-visualização

# Após eas build no GitHub Actions
eas build:list --buildProfile preview --status finished --limit 3 --json > previews.json
 
jq -r '
  .[] | "- [\(.platform) \(.buildProfile)](\(.artifacts.buildUrl)) - `\(.gitCommitHash[0:7])`"
' previews.json >> "$GITHUB_STEP_SUMMARY"

Notas do Bash

# Instala em imagens de CI macOS / Linux
# brew install jq ripgrep   # macOS
# apt-get install -y jq     # Debian; rg da release do GitHub ou cargo
 
# Valida JSON antes do jq - captura erros de autenticação do EAS CLI retornados como texto
jq empty < eas-last-build.json
 
# Evita que o progresso do curl seja canalizado para o jq
curl -fsSL "$URL" -o artifact.apk
 
# JSONL grande - transmite com inputs do jq
jq -c 'select(.level=="error")' < huge.jsonl | head -20

Armadilhas

Analisar eas build:list sem --json - a tabela humana não é legível por máquina. Correção: sempre passe --json; fixe a versão eas-cli na CI.
jq em array vazio - .[0] é null; implantações ruins silenciosas. Correção: jq -er '.[0].artifacts.buildUrl'.
Baixar IPA quando a CI precisa de APK - filtro platform errado. Correção: --platform android e verifique buildProfile.
grep -R node_modules - lento e barulhento. Correção: rg com globs -g ou limites de caminho.
Assumir que a URL do log sempre existe - builds mais antigos podem omitir logFiles. Correção: fallback eas build:view --json por id.
Segredos em logs JSON - EXPO_TOKEN ecoado em etapas de depuração. Correção: busque artefatos com rg antes de fazer upload; mascare segredos na CI.

Alternativas

Alternativa	Use Quando	Não Use Quando
`eas build:view --json`	Você já tem o UUID do build	Listar "o último verde" entre perfis
Script Node `JSON.parse`	Transformações complexas que precisam de bibliotecas npm	Extração de um único campo - `jq` é mais simples
TUI `jless` / `fx`	Exploração interativa local	Runners headless do GitHub Actions
UI do painel Expo	Navegação de builds para QA humano	Pipelines de instalação automatizados

FAQs

jq vs python -m json.tool?

json.tool apenas imprime formatado - sem filtragem.
jq seleciona campos, mapeia arrays e sai com erros para guardas de CI.

Como obtenho JSON para um ID de build específico?

eas build:view <BUILD_ID> --json
Combine com jq '.artifacts.buildUrl'

rg não encontrado no GitHub ubuntu-latest?

sudo apt-get install -y ripgrep ou cargo install ripgrep.
Muitas equipes adicionam uma etapa de configuração uma vez por fluxo de trabalho.

jq pode analisar a saída do eas submit?

eas submit:list --json - mesmos padrões para status de submissão e links ASC/Play.

Como busco logs do Metro na CI?

Salve a saída do Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log.
Combine com falhas de npx expo export registradas em wrappers JSON.

Relacionados

Noções Básicas de CLI para RN - flags eas build:list e --json
adb & Dispositivos Android - instala APK a partir da URL analisada
xcrun simctl & Simuladores iOS - instala .app de simulador a partir da URL
Noções Básicas do EAS Build - perfis que moldam artefatos JSON
GitHub Actions + EAS - conecte EXPO_TOKEN e etapas de build
Noções Básicas de CI/CD Mobile - onde a análise JSON se encaixa nas lanes de PR vs. release

Versões do Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# Última URL de APK Android de produção finalizada
eas build:list --platform android --status finished --limit 1 --json \
  | jq -r '.[0].artifacts.buildUrl // empty'
 
# Download de .app de simulador iOS + ID do bundle do mesmo blob JSON
eas build:list --platform ios --status finished --limit 1 --json \
  | jq -r '.[0] | "\(.applicationArchiveUrl // .artifacts.buildUrl)\t\(.buildDetails?.buildConfiguration ?? "n/a")"'
 
# Busca no log JSON exportado do EAS/GitHub por assinatura de falha
rg -n '"level":"error"|Gradle failure|pod install' ./artifacts/build-logs.jsonl
 
# GitHub Actions: define saída para etapa de instalação downstream
echo "apk_url=$(jq -r '.[0].artifacts.buildUrl' build.json)" >> "$GITHUB_OUTPUT"

Quando usar isso:

A CI precisa da última URL de build verde após eas build --wait.
Você está triando um arquivo de log EAS de 40 MB para a primeira linha de error.
Um script precisa ramificar com base em buildProfile ou gitCommitHash do JSON.
Você deseja consultas portáteis que rodem identicamente em agentes macOS e Linux.
Bots de PR comentam com links de build de pré-visualização analisados de eas build:list.

Exemplo de Trabalho

GitHub Actions: espera pelo EAS, extrai URL do APK, instala no emulador, busca logs em caso de falha.

#!/usr/bin/env bash
# scripts/ci/fetch-latest-apk.sh - executa após eas build --wait
set -euo pipefail
 
PLATFORM="${1:-android}"
PROFILE="${2:-preview}"
OUT_JSON="${3:-./eas-last-build.json}"
 
eas build:list \
  --platform "$PLATFORM" \
  --buildProfile "$PROFILE" \
  --status finished \
  --limit 1 \
  --json > "$OUT_JSON"
 
# Falha ruidosamente se não houver artefato
APK_URL=$(jq -er '.[0].artifacts.buildUrl' "$OUT_JSON")
BUILD_ID=$(jq -er '.[0].id' "$OUT_JSON")
GIT_SHA=$(jq -r '.[0].gitCommitHash // "unknown"' "$OUT_JSON")
 
echo "build_id=$BUILD_ID" >> "${GITHUB_OUTPUT:-/dev/null}"
echo "apk_url=$APK_URL" >> "${GITHUB_OUTPUT:-/dev/null}"
echo "git_sha=$GIT_SHA" >> "${GITHUB_OUTPUT:-/dev/null}"
 
curl -fsSL "$APK_URL" -o ./artifacts/app.apk
adb install -r ./artifacts/app.apk

Em caso de falha - baixa logs e ripgrep:

# O EAS imprime a URL do log no JSON de build quando disponível
LOG_URL=$(jq -r '.[0].logFiles[]? // empty' eas-last-build.json | head -1)
curl -fsSL "$LOG_URL" -o ./artifacts/build.log
 
rg -n --max-count 5 'FAILURE|error:|❌|Gradle failure|pod install' ./artifacts/build.log
jq -r 'select(.level=="error") | .message' ./artifacts/build.jsonl 2>/dev/null || true

O que isso demonstra:

jq -er - sai com código de erro não zero quando o campo está ausente; a CI falha em vez de instalar uma URL vazia.
Filtros eas build:list - platform, buildProfile, status restringem ao artefato que você pretende.
curl -fsSL - falha silenciosa em páginas de erro HTML 404 que se disfarçam de artefatos.
rg --max-count - as primeiras cinco linhas de falha sem rolar megabytes.
GitHub $GITHUB_OUTPUT - etapas downstream adb install ou Maestro consomem campos analisados.

Mergulho Profundo

Como Funciona

EAS CLI pode emitir JSON (--json) para build:list, build:view, submit:list e similares - estável para scripts.
jq é uma linguagem de consulta JSON - filtros rodam em milissegundos em arquivos de tamanho de CI.
rg busca recursivamente texto com padrões sensatos - mais rápido que grep -R, respeita .gitignore.
JSONL (um objeto JSON por linha) aparece em telemetria exportada - jq lê linha por linha com -c ou inputs.

Mapa de Campos do EAS build:list

Caminho jq	Significado
`.[0].id`	UUID de build para `eas build:view`
`.[0].status`	`finished`, `errored`, `canceled`, `in-progress`
`.[0].platform`	`ios` ou `android`
`.[0].buildProfile`	`development`, `preview`, `production`
`.[0].gitCommitHash`	Commit que o EAS construiu
`.[0].artifacts.buildUrl`	Artefato instalável (APK/AAB/IPA/simulador)
`.[0].applicationArchiveUrl`	Link alternativo de arquivo em alguns perfis
`.[0].logFiles[]`	URLs de log remotas quando presentes

# Imprime formatado o último build completo
eas build:list --limit 1 --json | jq '.[0]'
 
# Tabela dos últimos 10 builds
eas build:list --limit 10 --json \
  | jq -r '.[] | [.id[0:8], .platform, .buildProfile, .status, .createdAt] | @tsv'
 
# Encontra o último build de produção Android com erro
eas build:list --platform android --status errored --limit 1 --json \
  | jq '.[0] | {id, error: .error.message}'

Padrões jq para CI

# Padrão seguro com operador //
jq -r '.[0].artifacts.buildUrl // "none"'
 
# Requer campo ou sai com 1
jq -er '.[0].artifacts.buildUrl' build.json > apk.url
 
# Mapeia todas as URLs de artefatos (builds de matriz)
jq -r '.[] | select(.status=="finished") | .artifacts.buildUrl'
 
# Extrai configuração Expo aninhada de metadados personalizados (se seu pipeline a adicionar)
jq -r '.[0].metadata | fromjson? | .updateGroup // empty'
 
# Lê array JSON de um arquivo sem pipe stdin
jq -r '.[0].id' < eas-last-build.json

Padrões rg para Logs

# Primeiro Gradle OOM no log EAS Android
rg -m 1 'OutOfMemoryError|Java heap space' artifacts/android-build.log
 
# Falha de resolução do CocoaPods (iOS)
rg -n 'CocoaPods could not find compatible versions|pod install' artifacts/ios-build.log
 
# JSONL: linhas contendo nível de erro (ripgrep literal)
rg '"level":"error"' artifacts/telemetry.jsonl
 
# Busca pasta CI mas apenas markdown/json
rg -g '*.{json,jsonl,log}' 'buildProfile' .github/
 
# Linhas de contexto ao redor da correspondência (como grep -C)
rg -C 3 'Metro bundler' artifacts/expo-start.log

Pipelines: Comenta PR com Links de Pré-visualização

# Após eas build no GitHub Actions
eas build:list --buildProfile preview --status finished --limit 3 --json > previews.json
 
jq -r '
  .[] | "- [\(.platform) \(.buildProfile)](\(.artifacts.buildUrl)) - `\(.gitCommitHash[0:7])`"
' previews.json >> "$GITHUB_STEP_SUMMARY"

Notas do Bash

# Instala em imagens de CI macOS / Linux
# brew install jq ripgrep   # macOS
# apt-get install -y jq     # Debian; rg da release do GitHub ou cargo
 
# Valida JSON antes do jq - captura erros de autenticação do EAS CLI retornados como texto
jq empty < eas-last-build.json
 
# Evita que o progresso do curl seja canalizado para o jq
curl -fsSL "$URL" -o artifact.apk
 
# JSONL grande - transmite com inputs do jq
jq -c 'select(.level=="error")' < huge.jsonl | head -20

Armadilhas

Analisar eas build:list sem --json - a tabela humana não é legível por máquina. Correção: sempre passe --json; fixe a versão eas-cli na CI.
jq em array vazio - .[0] é null; implantações ruins silenciosas. Correção: jq -er '.[0].artifacts.buildUrl'.
Baixar IPA quando a CI precisa de APK - filtro platform errado. Correção: --platform android e verifique buildProfile.
grep -R node_modules - lento e barulhento. Correção: rg com globs -g ou limites de caminho.
Assumir que a URL do log sempre existe - builds mais antigos podem omitir logFiles. Correção: fallback eas build:view --json por id.
Segredos em logs JSON - EXPO_TOKEN ecoado em etapas de depuração. Correção: busque artefatos com rg antes de fazer upload; mascare segredos na CI.

Alternativas

Alternativa	Use Quando	Não Use Quando
`eas build:view --json`	Você já tem o UUID do build	Listar "o último verde" entre perfis
Script Node `JSON.parse`	Transformações complexas que precisam de bibliotecas npm	Extração de um único campo - `jq` é mais simples
TUI `jless` / `fx`	Exploração interativa local	Runners headless do GitHub Actions
UI do painel Expo	Navegação de builds para QA humano	Pipelines de instalação automatizados

FAQs

jq vs python -m json.tool?

json.tool apenas imprime formatado - sem filtragem.
jq seleciona campos, mapeia arrays e sai com erros para guardas de CI.

Como obtenho JSON para um ID de build específico?

eas build:view <BUILD_ID> --json
Combine com jq '.artifacts.buildUrl'

rg não encontrado no GitHub ubuntu-latest?

sudo apt-get install -y ripgrep ou cargo install ripgrep.
Muitas equipes adicionam uma etapa de configuração uma vez por fluxo de trabalho.

jq pode analisar a saída do eas submit?

eas submit:list --json - mesmos padrões para status de submissão e links ASC/Play.

Como busco logs do Metro na CI?

Salve a saída do Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log.
Combine com falhas de npx expo export registradas em wrappers JSON.

Relacionados

Noções Básicas de CLI para RN - flags eas build:list e --json
adb & Dispositivos Android - instala APK a partir da URL analisada
xcrun simctl & Simuladores iOS - instala .app de simulador a partir da URL
Noções Básicas do EAS Build - perfis que moldam artefatos JSON
GitHub Actions + EAS - conecte EXPO_TOKEN e etapas de build
Noções Básicas de CI/CD Mobile - onde a análise JSON se encaixa nas lanes de PR vs. release

Versões do Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).

jq, rg & Logs JSON

Buscar na documentação

jq, rg & Logs JSON