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: npmguarda en caché las descargas de npm, indexadas porpackage-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=2hace que Jest falle ante snapshots obsoletos en lugar de escribirlos, y limita los workers para que el uso de memoria sea predecible. AumentemaxWorkersen máquinas más potentes.npm ciantes de Gradle. La compilación para Android lee los módulos nativos denode_modules, así que instale primero las dependencias de JavaScript.working-directory: androidejecuta el wrapper en la carpeta donde está el archivogradlew.setup-gradleguarda en caché las dependencias de Gradle y el wrapper. Solomainguarda la caché, para evitar muchas entradas casi duplicadas. Más detalles en caché de Gradle.- Compilación de depuración.
assembleDebugno 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.
Relacionado
- Acelere React Native en GitHub ActionsAcelere el CI de React Native en GitHub Actions: caché de Gradle, CocoaPods y Metro, comprobaciones de JS en Linux y uso mínimo de minutos de macOS.
- Plantilla de flujo de trabajo de GitHub Actions para .NETCI de GitHub Actions para .NET listo para copiar: caché de NuGet, restauración, compilación, pruebas, servicio SQL Server, concurrencia y permisos.
- Plantilla de flujo de trabajo de GitHub Actions para DjangoCI de GitHub Actions para Django, listo para copiar y pegar: contenedor de servicio Postgres, caché de pip, comprobación de migraciones y tests.
- Plantilla de workflow de GitHub Actions para compilar DockerFlujo de trabajo de GitHub Actions para copiar y pegar: compile imágenes Docker con Buildx, capas en caché de GitHub y publique en GHCR desde main.