jq, rg y JSON Logs

Q: ¿jq vs python -m json.tool?

json.tool solo pretty-prints - sin filtrado. jq selecciona campos, mapea arrays, y sale con errores para guardias de CI.

Q: ¿Cómo obtengo JSON para un ID de compilación específico?

eas build:view --json Combina con jq '.artifacts.buildUrl'

Q: ¿rg no encontrado en ubuntu-latest de GitHub?

sudo apt-get install -y ripgrep o cargo install ripgrep. Muchos equipos añaden un paso de configuración una vez por workflow.

Q: ¿Puede jq analizar la salida de eas submit?

eas submit:list --json - mismos patrones para estado de envío y enlaces de ASC/Play.

Q: ¿Cómo busco registros de Metro en CI?

Guarda salida de Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log. Combina con fallos de npx expo export registrados en envoltorios JSON.

jq y rg (ripgrep) son la capa rápida de inspección para CI y JSON de EAS - extrae URLs de artefactos de eas build:list, grep en registros JSONL para fallos de Gradle, y conecta outputs de GitHub Actions sin un script de Node desechable. En equipos con Expo SDK 57, estas dos herramientas convierten metadatos de compilación en la nube en bash que puedes verificar en el repositorio.

Receta

Tarjeta de receta de referencia rápida - lista para copiar-pegar.

# URL del APK de Android de producción más reciente terminado
eas build:list --platform android --status finished --limit 1 --json \
  | jq -r '.[0].artifacts.buildUrl // empty'
 
# Descarga del simulador de iOS .app + bundle id del mismo blob JSON
eas build:list --platform ios --status finished --limit 1 --json \
  | jq -r '.[0] | "\(.applicationArchiveUrl // .artifacts.buildUrl)\t\(.buildDetails?.buildConfiguration ?? "n/a")"'
 
# Grep en registro JSON de EAS/GitHub para firma de fallo
rg -n '"level":"error"|Gradle failure|pod install' ./artifacts/build-logs.jsonl
 
# GitHub Actions: establece output para paso de instalación posterior
echo "apk_url=$(jq -r '.[0].artifacts.buildUrl' build.json)" >> "$GITHUB_OUTPUT"

Cuándo usarlo:

CI necesita la URL de compilación verde más reciente después de eas build --wait.
Estás triando un archivo de registro de EAS de 40 MB buscando la primera línea error.
Un script debe ramificarse en buildProfile o gitCommitHash desde JSON.
Quieres consultas portátiles que se ejecuten idénticamente en agentes de macOS y Linux.
Los bots de PR comentan con enlaces de compilación de vista previa analizados desde eas build:list.

Ejemplo Práctico

GitHub Actions: espera a EAS, extrae URL de APK, instala en emulador, grep en registros en caso de fallo.

#!/usr/bin/env bash
# scripts/ci/fetch-latest-apk.sh - ejecuta después de 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"
 
# Falla ruidosamente si no hay artefacto
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

En caso de fallo - descarga registros y ripgrep:

# EAS imprime la URL de registro en JSON de construcción cuando está disponible
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

Lo que esto demuestra:

jq -er - sale con código diferente a cero cuando falta el campo; CI falla en lugar de instalar URL vacía.
Filtros de eas build:list - platform, buildProfile, status se reducen al artefacto que pretendes.
curl -fsSL - fallo silencioso en páginas de error HTML 404 haciéndose pasar por artefactos.
rg --max-count - primeras cinco líneas de fallo sin desplazarse por megabytes.
$GITHUB_OUTPUT de GitHub - pasos posteriores de adb install o Maestro consumen campos analizados.

Análisis Profundo

Cómo Funciona

EAS CLI puede emitir JSON (--json) para build:list, build:view, submit:list y similares - estable para scripting.
jq es un lenguaje de consulta JSON - los filtros se ejecutan en milisegundos en archivos de tamaño de CI.
rg busca texto recursivamente con defaults sensatos - más rápido que grep -R, respeta .gitignore.
JSONL (un objeto JSON por línea) aparece en telemetría exportada - jq lee línea por línea con -c o inputs.

Mapa de Campos de eas build:list

ruta jq	Significado
`.[0].id`	UUID de compilación para `eas build:view`
`.[0].status`	`finished`, `errored`, `canceled`, `in-progress`
`.[0].platform`	`ios` o `android`
`.[0].buildProfile`	`development`, `preview`, `production`
`.[0].gitCommitHash`	Commit que EAS construyó
`.[0].artifacts.buildUrl`	Artefacto instalable (APK/AAB/IPA/simulador)
`.[0].applicationArchiveUrl`	Enlace de archivo alternativo en algunos perfiles
`.[0].logFiles[]`	URLs de registros remotos cuando están presentes

# Pretty-print de construcción más reciente completa
eas build:list --limit 1 --json | jq '.[0]'
 
# Tabla de las últimas 10 compilaciones
eas build:list --limit 10 --json \
  | jq -r '.[] | [.id[0:8], .platform, .buildProfile, .status, .createdAt] | @tsv'
 
# Busca la última construcción de Android de producción con error
eas build:list --platform android --status errored --limit 1 --json \
  | jq '.[0] | {id, error: .error.message}'

Patrones de jq para CI

# Default seguro con operador //
jq -r '.[0].artifacts.buildUrl // "none"'
 
# Requiere campo o sale con 1
jq -er '.[0].artifacts.buildUrl' build.json > apk.url
 
# Mapea todas las URLs de artefactos (construcciones de matriz)
jq -r '.[] | select(.status=="finished") | .artifacts.buildUrl'
 
# Extrae config de Expo anidado desde metadatos personalizados (si tu pipeline lo agrega)
jq -r '.[0].metadata | fromjson? | .updateGroup // empty'
 
# Slurp array JSON desde archivo sin pipe de stdin
jq -r '.[0].id' < eas-last-build.json

Patrones de rg para Registros

# Primer OOM de Gradle en registro de Android de EAS
rg -m 1 'OutOfMemoryError|Java heap space' artifacts/android-build.log
 
# Fallo de resolución de CocoaPods (iOS)
rg -n 'CocoaPods could not find compatible versions|pod install' artifacts/ios-build.log
 
# JSONL: líneas que contienen nivel de error (ripgrep literal)
rg '"level":"error"' artifacts/telemetry.jsonl
 
# Busca en carpeta de CI pero solo markdown/json
rg -g '*.{json,jsonl,log}' 'buildProfile' .github/
 
# Líneas de contexto alrededor de coincidencia (como grep -C)
rg -C 3 'Metro bundler' artifacts/expo-start.log

Pipelines: Comenta PR con Enlaces de Vista Previa

# Después de eas build en 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 de Bash

# Instala en imágenes de CI de macOS / Linux
# brew install jq ripgrep   # macOS
# apt-get install -y jq     # Debian; rg desde GitHub release o cargo
 
# Valida JSON antes de jq - detecta errores de autenticación de eas CLI devueltos como texto
jq empty < eas-last-build.json
 
# Evita piping progreso de curl en jq
curl -fsSL "$URL" -o artifact.apk
 
# JSONL grande - stream con jq inputs
jq -c 'select(.level=="error")' < huge.jsonl | head -20

Errores Comunes

Análisis de eas build:list sin --json - la tabla humana no es legible por máquina. Solución: siempre pasa --json; fija la versión eas-cli en CI.
jq en array vacío - .[0] es null; despliegues silenciosos malos. Solución: jq -er '.[0].artifacts.buildUrl'.
Descargar IPA cuando CI necesita APK - filtro platform incorrecto. Solución: --platform android y verifica buildProfile.
grep -R node_modules - lento y ruidoso. Solución: rg con globs -g o límites de ruta.
Asumir que la URL del registro siempre existe - las compilaciones más antiguas pueden omitir logFiles. Solución: fallback de eas build:view --json por id.
Secretos en registros JSON - EXPO_TOKEN echo en pasos de depuración. Solución: rg artefactos antes de cargar; enmascara secretos en CI.

Alternativas

Alternativa	Úsalo Cuando	No lo uses Cuando
`eas build:view --json`	Ya tienes UUID de compilación	Listado de "verde más reciente" en perfiles
Script de `JSON.parse` de Node	Transformaciones complejas necesitando libs de npm	Extracción de un campo - `jq` es más simple
TUI de `jless` / `fx`	Exploración local interactiva	Ejecutores de GitHub Actions sin encabezado
UI del panel de Expo	Exploración humana de QA de compilaciones	Pipelines de instalación automatizados

Preguntas Frecuentes

¿jq vs python -m json.tool?

json.tool solo pretty-prints - sin filtrado.
jq selecciona campos, mapea arrays, y sale con errores para guardias de CI.

¿Cómo obtengo JSON para un ID de compilación específico?

eas build:view <BUILD_ID> --json
Combina con jq '.artifacts.buildUrl'

¿rg no encontrado en ubuntu-latest de GitHub?

sudo apt-get install -y ripgrep o cargo install ripgrep.
Muchos equipos añaden un paso de configuración una vez por workflow.

¿Puede jq analizar la salida de eas submit?

eas submit:list --json - mismos patrones para estado de envío y enlaces de ASC/Play.

¿Cómo busco registros de Metro en CI?

Guarda salida de Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log.
Combina con fallos de npx expo export registrados en envoltorios JSON.

Relacionado

CLI Basics for RN - eas build:list y flags --json
adb & Android Devices - instala APK desde URL analizada
xcrun simctl & iOS Simulators - instala simulador .app desde URL
EAS Build Basics - perfiles que dan forma a artefactos JSON
GitHub Actions + EAS - conecta EXPO_TOKEN y pasos de compilación
Mobile CI/CD Basics - dónde se ajusta el análisis JSON de PR vs carriles de lanzamiento

Versiones de stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

Receta

Tarjeta de receta de referencia rápida - lista para copiar-pegar.

# URL del APK de Android de producción más reciente terminado
eas build:list --platform android --status finished --limit 1 --json \
  | jq -r '.[0].artifacts.buildUrl // empty'
 
# Descarga del simulador de iOS .app + bundle id del mismo blob JSON
eas build:list --platform ios --status finished --limit 1 --json \
  | jq -r '.[0] | "\(.applicationArchiveUrl // .artifacts.buildUrl)\t\(.buildDetails?.buildConfiguration ?? "n/a")"'
 
# Grep en registro JSON de EAS/GitHub para firma de fallo
rg -n '"level":"error"|Gradle failure|pod install' ./artifacts/build-logs.jsonl
 
# GitHub Actions: establece output para paso de instalación posterior
echo "apk_url=$(jq -r '.[0].artifacts.buildUrl' build.json)" >> "$GITHUB_OUTPUT"

Cuándo usarlo:

CI necesita la URL de compilación verde más reciente después de eas build --wait.
Estás triando un archivo de registro de EAS de 40 MB buscando la primera línea error.
Un script debe ramificarse en buildProfile o gitCommitHash desde JSON.
Quieres consultas portátiles que se ejecuten idénticamente en agentes de macOS y Linux.
Los bots de PR comentan con enlaces de compilación de vista previa analizados desde eas build:list.

Ejemplo Práctico

GitHub Actions: espera a EAS, extrae URL de APK, instala en emulador, grep en registros en caso de fallo.

#!/usr/bin/env bash
# scripts/ci/fetch-latest-apk.sh - ejecuta después de 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"
 
# Falla ruidosamente si no hay artefacto
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

En caso de fallo - descarga registros y ripgrep:

# EAS imprime la URL de registro en JSON de construcción cuando está disponible
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

Lo que esto demuestra:

jq -er - sale con código diferente a cero cuando falta el campo; CI falla en lugar de instalar URL vacía.
Filtros de eas build:list - platform, buildProfile, status se reducen al artefacto que pretendes.
curl -fsSL - fallo silencioso en páginas de error HTML 404 haciéndose pasar por artefactos.
rg --max-count - primeras cinco líneas de fallo sin desplazarse por megabytes.
$GITHUB_OUTPUT de GitHub - pasos posteriores de adb install o Maestro consumen campos analizados.

Análisis Profundo

Cómo Funciona

EAS CLI puede emitir JSON (--json) para build:list, build:view, submit:list y similares - estable para scripting.
jq es un lenguaje de consulta JSON - los filtros se ejecutan en milisegundos en archivos de tamaño de CI.
rg busca texto recursivamente con defaults sensatos - más rápido que grep -R, respeta .gitignore.
JSONL (un objeto JSON por línea) aparece en telemetría exportada - jq lee línea por línea con -c o inputs.

Mapa de Campos de eas build:list

ruta jq	Significado
`.[0].id`	UUID de compilación para `eas build:view`
`.[0].status`	`finished`, `errored`, `canceled`, `in-progress`
`.[0].platform`	`ios` o `android`
`.[0].buildProfile`	`development`, `preview`, `production`
`.[0].gitCommitHash`	Commit que EAS construyó
`.[0].artifacts.buildUrl`	Artefacto instalable (APK/AAB/IPA/simulador)
`.[0].applicationArchiveUrl`	Enlace de archivo alternativo en algunos perfiles
`.[0].logFiles[]`	URLs de registros remotos cuando están presentes

# Pretty-print de construcción más reciente completa
eas build:list --limit 1 --json | jq '.[0]'
 
# Tabla de las últimas 10 compilaciones
eas build:list --limit 10 --json \
  | jq -r '.[] | [.id[0:8], .platform, .buildProfile, .status, .createdAt] | @tsv'
 
# Busca la última construcción de Android de producción con error
eas build:list --platform android --status errored --limit 1 --json \
  | jq '.[0] | {id, error: .error.message}'

Patrones de jq para CI

# Default seguro con operador //
jq -r '.[0].artifacts.buildUrl // "none"'
 
# Requiere campo o sale con 1
jq -er '.[0].artifacts.buildUrl' build.json > apk.url
 
# Mapea todas las URLs de artefactos (construcciones de matriz)
jq -r '.[] | select(.status=="finished") | .artifacts.buildUrl'
 
# Extrae config de Expo anidado desde metadatos personalizados (si tu pipeline lo agrega)
jq -r '.[0].metadata | fromjson? | .updateGroup // empty'
 
# Slurp array JSON desde archivo sin pipe de stdin
jq -r '.[0].id' < eas-last-build.json

Patrones de rg para Registros

# Primer OOM de Gradle en registro de Android de EAS
rg -m 1 'OutOfMemoryError|Java heap space' artifacts/android-build.log
 
# Fallo de resolución de CocoaPods (iOS)
rg -n 'CocoaPods could not find compatible versions|pod install' artifacts/ios-build.log
 
# JSONL: líneas que contienen nivel de error (ripgrep literal)
rg '"level":"error"' artifacts/telemetry.jsonl
 
# Busca en carpeta de CI pero solo markdown/json
rg -g '*.{json,jsonl,log}' 'buildProfile' .github/
 
# Líneas de contexto alrededor de coincidencia (como grep -C)
rg -C 3 'Metro bundler' artifacts/expo-start.log

Pipelines: Comenta PR con Enlaces de Vista Previa

# Después de eas build en 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 de Bash

# Instala en imágenes de CI de macOS / Linux
# brew install jq ripgrep   # macOS
# apt-get install -y jq     # Debian; rg desde GitHub release o cargo
 
# Valida JSON antes de jq - detecta errores de autenticación de eas CLI devueltos como texto
jq empty < eas-last-build.json
 
# Evita piping progreso de curl en jq
curl -fsSL "$URL" -o artifact.apk
 
# JSONL grande - stream con jq inputs
jq -c 'select(.level=="error")' < huge.jsonl | head -20

Errores Comunes

Análisis de eas build:list sin --json - la tabla humana no es legible por máquina. Solución: siempre pasa --json; fija la versión eas-cli en CI.
jq en array vacío - .[0] es null; despliegues silenciosos malos. Solución: jq -er '.[0].artifacts.buildUrl'.
Descargar IPA cuando CI necesita APK - filtro platform incorrecto. Solución: --platform android y verifica buildProfile.
grep -R node_modules - lento y ruidoso. Solución: rg con globs -g o límites de ruta.
Asumir que la URL del registro siempre existe - las compilaciones más antiguas pueden omitir logFiles. Solución: fallback de eas build:view --json por id.
Secretos en registros JSON - EXPO_TOKEN echo en pasos de depuración. Solución: rg artefactos antes de cargar; enmascara secretos en CI.

Alternativas

Alternativa	Úsalo Cuando	No lo uses Cuando
`eas build:view --json`	Ya tienes UUID de compilación	Listado de "verde más reciente" en perfiles
Script de `JSON.parse` de Node	Transformaciones complejas necesitando libs de npm	Extracción de un campo - `jq` es más simple
TUI de `jless` / `fx`	Exploración local interactiva	Ejecutores de GitHub Actions sin encabezado
UI del panel de Expo	Exploración humana de QA de compilaciones	Pipelines de instalación automatizados

Preguntas Frecuentes

¿jq vs python -m json.tool?

json.tool solo pretty-prints - sin filtrado.
jq selecciona campos, mapea arrays, y sale con errores para guardias de CI.

¿Cómo obtengo JSON para un ID de compilación específico?

eas build:view <BUILD_ID> --json
Combina con jq '.artifacts.buildUrl'

¿rg no encontrado en ubuntu-latest de GitHub?

sudo apt-get install -y ripgrep o cargo install ripgrep.
Muchos equipos añaden un paso de configuración una vez por workflow.

¿Puede jq analizar la salida de eas submit?

eas submit:list --json - mismos patrones para estado de envío y enlaces de ASC/Play.

¿Cómo busco registros de Metro en CI?

Guarda salida de Metro como metro.log - rg 'Bundling|ERROR|Unable to resolve' metro.log.
Combina con fallos de npx expo export registrados en envoltorios JSON.

Relacionado

CLI Basics for RN - eas build:list y flags --json
adb & Android Devices - instala APK desde URL analizada
xcrun simctl & iOS Simulators - instala simulador .app desde URL
EAS Build Basics - perfiles que dan forma a artefactos JSON
GitHub Actions + EAS - conecta EXPO_TOKEN y pasos de compilación
Mobile CI/CD Basics - dónde se ajusta el análisis JSON de PR vs carriles de lanzamiento

Versiones de stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

jq, rg y JSON Logs

Buscar en la documentación

jq, rg y JSON Logs