Saltar al contenido

Plantilla de flujo de trabajo de GitHub Actions para React Native

Última actualización

Este es un .github/workflows/ci.yml funcional para una aplicación de React Native. Un trabajo rápido de JavaScript ejecuta lint, la comprobación de tipos y Jest en cada push. Un segundo trabajo compila la aplicación para Android con caché de Gradle. iOS se trata en las variantes porque requiere macOS.

El flujo de trabajo

name: CI

on:
  push:
    branches: [main]
  pull_request:

permissions:
  contents: read

concurrency:
  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

jobs:
  js:
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm

      - run: npm ci
      - run: npm run lint
      - run: npx tsc --noEmit
      - run: npm test -- --ci --maxWorkers=2

  android:
    needs: js
    runs-on: ubuntu-latest
    timeout-minutes: 40
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm

      - uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: 17

      - uses: gradle/actions/setup-gradle@v4
        with:
          cache-read-only: ${{ github.ref != 'refs/heads/main' }}

      - run: npm ci
      - run: ./gradlew assembleDebug --no-daemon
        working-directory: android

Qué hacen las partes menos evidentes

  • Dos trabajos a propósito. Las comprobaciones de JavaScript terminan en minutos y detectan la mayoría de los errores. La compilación para Android es más lenta, así que espera a que terminen con needs: js.
  • cache: npm guarda en caché las descargas de npm, indexadas por package-lock.json. Consulte caché de npm. Si usa Yarn o pnpm, cambie la opción de caché y el comando de instalación; consulte Yarn y pnpm.
  • --ci --maxWorkers=2 hace que Jest falle ante snapshots obsoletos en lugar de escribirlos, y limita los workers para que el uso de memoria sea predecible. Aumente maxWorkers en máquinas más potentes.
  • npm ci antes de Gradle. La compilación para Android lee los módulos nativos de node_modules, así que instale primero las dependencias de JavaScript.
  • working-directory: android ejecuta el wrapper en la carpeta donde está el archivo gradlew.
  • setup-gradle guarda en caché las dependencias de Gradle y el wrapper. Solo main guarda la caché, para evitar muchas entradas casi duplicadas. Más detalles en caché de Gradle.
  • Compilación de depuración. assembleDebug no necesita claves de firma, por lo que es seguro en pull requests.

Variantes

iOS en macOS

  ios:
    needs: js
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: bundle install && bundle exec pod install
        working-directory: ios
      - run: xcodebuild -workspace App.xcworkspace -scheme App -configuration Debug -sdk iphonesimulator build CODE_SIGNING_ALLOWED=NO
        working-directory: ios

Sustituya App por su workspace y su scheme. Los minutos de macOS cuestan varias veces más que los de Linux, así que ejecute esto en main o en pull requests etiquetados. Consulte runners de macOS para CI de iOS y acelere las compilaciones de Xcode.

Expo y EAS

Para proyectos de Expo, ejecute npx expo-doctor y Jest aquí, y deje que EAS Build gestione las compilaciones nativas.

Pruebas de extremo a extremo

Detox o Maestro necesitan emuladores y son lentos. Ejecútelos cada noche o divídalos en fragmentos; consulte sharding de pruebas.

Compilaciones de producción

Decodifique las claves de firma desde los secrets en tiempo de compilación y suba el APK o AAB como artefacto.

Ejecútelo en máquinas más rápidas

Las compilaciones de Android con Gradle usan todos los núcleos y son el paso más largo. Cambie una línea en cada trabajo de Linux:

    runs-on: [self-hosted, Linux, compiler-ci]

El trabajo se ejecuta en una máquina nueva de 8 vCPU de compiler.dev, con alternativa a su runner original. macOS está en acceso anticipado. Consulte acelere React Native en GitHub Actions y precios.

Preguntas frecuentes

¿Necesito Watchman?

No, no para Jest en CI. Use --watchman=false si Jest muestra una advertencia al respecto.

¿Por qué mi compilación de Android es tan lenta la primera vez?

Gradle descarga las dependencias y compila el código nativo. Las cachés solucionan las ejecuciones posteriores.

¿Puedo compilar iOS en Linux?

No. Las compilaciones de iOS necesitan macOS y Xcode.

¿Debo ejecutar el empaquetado de Metro en CI?

Solo para compilaciones de producción. Para las comprobaciones, lint, tipos y Jest son suficientes.