Saltar al contenido

Acelere Flutter en GitHub Actions

Última actualización

Para acelerar Flutter en GitHub Actions, guarde en caché el SDK de Flutter y los paquetes de pub con subosito/flutter-action, ejecute el análisis y las pruebas en Linux, compile Android en Linux y reserve macOS solo para la compilación de iOS. Los minutos de macOS cuestan varias veces más que los de Linux, y la mayor parte de un pipeline de Flutter no necesita un Mac.

Esta guía es la versión para Flutter de nuestra guía general para acelerar GitHub Actions.

Dónde se va el tiempo

Un pipeline de Flutter tiene cuatro partes: instalar el SDK, flutter pub get, flutter analyze junto con flutter test, y las compilaciones por plataforma (flutter build apk o appbundle, flutter build ios). En una VM nueva, la descarga del SDK ocupa varios cientos de megabytes, y las compilaciones nativas (Gradle para Android, Xcode y CocoaPods para iOS) son las más lentas. Los pasos de pruebas y análisis son rápidos en comparación.

Caché del SDK y de pub con flutter-action

subosito/flutter-action instala Flutter y puede guardarlo en caché. Su README documenta estas entradas:

  • channel: stable, beta o master.
  • flutter-version: una versión como 3.19.0, o una parcial como 3.x.
  • flutter-version-file: lee la versión de pubspec.yaml o .fvmrc. El README advierte de que la versión exacta debe estar en el archivo, así que los rangos no funcionarán.
  • cache: guarda en caché el SDK de Flutter. Si no se define pub-cache, también controla la caché de dependencias de pub.
  • cache-key, pub-cache-key y cache-path: claves y rutas personalizadas. Aceptan marcadores como :os:, :channel:, :version:, :arch: y :hash:.
- uses: actions/checkout@v7
- uses: subosito/flutter-action@v2
  with:
    channel: stable
    flutter-version-file: pubspec.yaml
    cache: true
- run: flutter pub get
- run: flutter analyze
- run: flutter test --coverage

Fije la versión (mediante el archivo o flutter-version) en lugar de seguir stable a ciegas. Una nueva versión estable cambia la clave de caché del SDK y su compilación cambia sin previo aviso. Una versión fijada también hace predecible la tasa de aciertos de la caché.

Velocidad de las pruebas

flutter test ejecuta los archivos de prueba en paralelo. Usa la opción --concurrency, que por defecto equivale al número de núcleos menos una pequeña reserva, de modo que más núcleos ayudan automáticamente. Consejos prácticos:

  • Separe las pruebas rápidas de widgets y unitarias (flutter test) de las pruebas de integración más lentas (integration_test/), que necesitan un dispositivo o emulador y tardan en arrancar.
  • Use flutter test --coverage solo si sube la cobertura; añade tiempo.
  • Si su repositorio tiene varios paquetes (un monorepo con Melos), ejecute flutter test por paquete en una matriz, o use Melos para ejecutar los scripts en paralelo.
  • En las pruebas golden, genere y compare en un mismo sistema operativo. Las fuentes varían entre plataformas, y Linux es el lugar más económico para ejecutarlas.

Compilaciones de Android en Linux

Las compilaciones de Android ejecutan Gradle, y Gradle necesita su propia caché. Añada actions/setup-java y gradle/actions/setup-gradle; consulte nuestra guía de Gradle para la configuración:

build-android:
  runs-on: ubuntu-latest
  timeout-minutes: 30
  steps:
    - uses: actions/checkout@v7
    - uses: actions/setup-java@v6
      with:
        distribution: temurin
        java-version: 17
    - uses: gradle/actions/setup-gradle@v6
    - uses: subosito/flutter-action@v2
      with:
        channel: stable
        flutter-version-file: pubspec.yaml
        cache: true
    - run: flutter pub get
    - run: flutter build apk --release
    - uses: actions/upload-artifact@v7
      with:
        name: apk
        path: build/app/outputs/flutter-apk/app-release.apk

Use flutter build apk --split-per-abi solo si necesita APK separados; compila una vez por ABI y tarda más. Para subir a las tiendas, compile un app bundle (appbundle) una sola vez. Compruebe qué versión de Java requiere la versión de su Android Gradle Plugin antes de fijar una.

Compilaciones de iOS en macOS, con el mínimo uso posible

flutter build ios necesita Xcode, por lo que requiere macOS. Mantenga ese job por separado y ejecútelo solo cuando haga falta, por ejemplo en main o en etiquetas de release, no en cada push a un PR. Guarde CocoaPods en caché almacenando ios/Pods con la clave ios/Podfile.lock:

build-ios:
  runs-on: macos-latest
  steps:
    - uses: actions/checkout@v7
    - uses: subosito/flutter-action@v2
      with:
        channel: stable
        flutter-version-file: pubspec.yaml
        cache: true
    - uses: actions/cache@v6
      with:
        path: ios/Pods
        key: pods-${{ runner.os }}-${{ hashFiles('ios/Podfile.lock') }}
    - run: flutter pub get
    - run: flutter build ios --release --no-codesign

--no-codesign es adecuado para una comprobación de compilación; use la firma real solo en el job de release. Para el coste y las opciones de macOS, consulte runners de macOS para CI de iOS y acelerar las compilaciones de Xcode en CI. macOS alojado se factura a una tarifa por minuto más alta que Linux, así que cada minuto que traslade a Linux supone un ahorro real.

Una distribución de jobs que funciona

  1. analyze-test en Linux para cada push: pub get, análisis, pruebas.
  2. build-android en Linux para cada push a PR que modifique android/ o lib/.
  3. build-ios en macOS solo para main y las etiquetas.

Use filtros de rutas y concurrency para cancelar las ejecuciones superadas.

Lo que aportan más núcleos de CPU

Las pruebas de Flutter se ejecutan en paralelo y Gradle usa varios núcleos, así que una máquina Linux más grande ayuda en el análisis, las pruebas y las compilaciones de Android. El paso de Xcode no se beneficia en absoluto de los núcleos de Linux. No tenemos una fila de Flutter en nuestros benchmarks, así que no citamos ninguna aceleración. La máquina Linux predeterminada de compiler.dev tiene 8 vCPU / 16 GB a $0.008 por minuto. macOS está en acceso anticipado, con una VM Apple M4 Pro de 7 núcleos a $0.028 por minuto y una VM de 14 núcleos a $0.055 por minuto. Consulte los precios y los precios de los runners. Cambiar es una sola línea: runs-on: [self-hosted, Linux, compiler-ci].

Relacionado: la plantilla de Flutter, la guía de React Native y el caching en GitHub Actions.

Preguntas frecuentes

¿flutter-action guarda en caché la caché de pub?

Sí. Con cache: true guarda en caché el SDK, y también las dependencias de pub, salvo que defina pub-cache por separado. Puede definir claves personalizadas con pub-cache-key.

¿Puedo compilar una app de iOS en Linux?

No. Las compilaciones de iOS necesitan Xcode en macOS. Compile Android y ejecute las pruebas en Linux.

¿Debo fijar la versión de Flutter?

Sí. Use flutter-version o flutter-version-file para que el SDK y la clave de caché cambien solo cuando usted decida.

¿Cómo ejecuto las pruebas de integración de Flutter más rápido?

Ejecútelas en un job separado, use un destino sin interfaz gráfica, como un dispositivo de escritorio Linux, cuando su app lo admita, y ejecútelas solo en main si son lentas.

Ejecute este workflow en compiler.dev Sin tarjeta · 200 minutos gratuitos

Pruébelo gratis