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,betaomaster.flutter-version: una versión como3.19.0, o una parcial como3.x.flutter-version-file: lee la versión depubspec.yamlo.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 definepub-cache, también controla la caché de dependencias de pub.cache-key,pub-cache-keyycache-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 --coveragesolo si sube la cobertura; añade tiempo. - Si su repositorio tiene varios paquetes (un monorepo con Melos), ejecute
flutter testpor 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
analyze-testen Linux para cada push: pub get, análisis, pruebas.build-androiden Linux para cada push a PR que modifiqueandroid/olib/.build-iosen macOS solo paramainy 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.
Relacionado
- Acelere un monorepo de TypeScript en GitHub ActionsAcelere la comprobación de tipos y el linting en un monorepo TypeScript con GitHub Actions: tsc incremental, referencias de proyecto y cachés.
- Acelere Playwright en un monorepo con GitHub ActionsAcelere las pruebas e2e de Playwright en un monorepo Node con GitHub Actions: compile la app una vez y omita e2e si no cambió.
- Añada una insignia de velocidad de CI a su READMEMuestre la velocidad de su CI con una insignia en el README: el tiempo mediano de ejecución en GitHub Actions, actualizado automáticamente. Gratis.
- Acelere .NET en GitHub ActionsAcelere las compilaciones de .NET en GitHub Actions: caché de NuGet con setup-dotnet, --no-restore, --no-build, dotnet test en paralelo y servicios SQL.