Zum Inhalt springen

Flutter in GitHub Actions beschleunigen

Zuletzt aktualisiert am

Um Flutter in GitHub Actions zu beschleunigen, cachen Sie das Flutter-SDK und die Pub-Pakete mit subosito/flutter-action, führen Analyse und Tests unter Linux aus, bauen Android unter Linux und verwenden macOS nur für den iOS-Build. macOS-Minuten kosten ein Vielfaches von Linux-Minuten, und der Großteil einer Flutter-Pipeline braucht keinen Mac.

Dieser Leitfaden ist die Flutter-Version unseres allgemeinen Leitfadens zur Beschleunigung von GitHub Actions.

Wo die Zeit verloren geht

Eine Flutter-Pipeline besteht aus vier Teilen: Installation des SDK, flutter pub get, flutter analyze plus flutter test sowie plattformspezifische Builds (flutter build apk oder appbundle, flutter build ios). Auf einer frischen VM ist der SDK-Download einige hundert Megabyte groß, und die nativen Builds (Gradle für Android, Xcode und CocoaPods für iOS) sind am langsamsten. Die Schritte für Tests und Analyse sind dagegen schnell.

SDK- und Pub-Cache mit flutter-action

subosito/flutter-action installiert Flutter und kann es cachen. Die README dokumentiert diese Eingaben:

  • channel: stable, beta oder master.
  • flutter-version: eine Version wie 3.19.0 oder eine Teilangabe wie 3.x.
  • flutter-version-file: liest die Version aus pubspec.yaml oder .fvmrc. Die README weist darauf hin, dass die exakte Version in der Datei stehen muss, Bereichsangaben funktionieren nicht.
  • cache: cacht das Flutter-SDK. Ist pub-cache nicht gesetzt, steuert es auch das Caching der Pub-Abhängigkeiten.
  • cache-key, pub-cache-key und cache-path: benutzerdefinierte Schlüssel und Pfade. Sie akzeptieren Platzhalter wie :os:, :channel:, :version:, :arch: und :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

Pinnen Sie die Version (über die Datei oder flutter-version), anstatt blind stable zu folgen. Ein neues stabiles Release ändert den SDK-Cache-Schlüssel, und Ihr Build verändert sich unbemerkt. Eine feste Version macht außerdem die Cache-Trefferquote vorhersehbar.

Testgeschwindigkeit

flutter test führt Testdateien parallel aus. Dafür sorgt die Option --concurrency, die standardmäßig die Anzahl der Kerne abzüglich einer kleinen Reserve verwendet, sodass mehr Kerne automatisch helfen. Praktische Tipps:

  • Trennen Sie schnelle Widget- und Unit-Tests (flutter test) von langsameren Integrationstests (integration_test/), die ein Gerät oder einen Emulator benötigen und langsam starten.
  • Verwenden Sie flutter test --coverage nur, wenn Sie die Abdeckung hochladen; es kostet zusätzliche Zeit.
  • Wenn Ihr Repository mehrere Pakete enthält (ein Monorepo mit Melos), führen Sie flutter test pro Paket in einer Matrix aus oder nutzen Sie Melos, um Skripte parallel laufen zu lassen.
  • Bei Golden-Tests erzeugen und vergleichen Sie die Bilder auf einem Betriebssystem. Schriften unterscheiden sich zwischen Plattformen, und Linux ist der günstigste Ort dafür.

Android-Builds unter Linux

Android-Builds führen Gradle aus, und Gradle braucht ein eigenes Caching. Fügen Sie actions/setup-java und gradle/actions/setup-gradle hinzu; die Einstellungen finden Sie in unserem Gradle-Leitfaden:

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

Verwenden Sie flutter build apk --split-per-abi nur, wenn Sie separate APKs benötigen; es baut einmal pro ABI und dauert länger. Für Store-Uploads bauen Sie einmal ein App-Bundle (appbundle). Prüfen Sie, welche Java-Version Ihre Android-Gradle-Plugin-Version erfordert, bevor Sie eine festlegen.

iOS-Builds auf macOS, so wenig wie möglich

flutter build ios benötigt Xcode und damit macOS. Halten Sie diesen Job getrennt und führen Sie ihn nur bei Bedarf aus, zum Beispiel auf main oder bei Release-Tags, nicht bei jedem Push auf einen PR. Cachen Sie CocoaPods, indem Sie ios/Pods cachen, mit dem Schlüssel aus 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 eignet sich für eine Kompilierprüfung; echte Signierung nur im Release-Job. Zu Kosten und Optionen für macOS siehe macOS-Runner für iOS-CI und Xcode-Builds in CI beschleunigen. Gehostetes macOS wird pro Minute teurer abgerechnet als Linux, daher spart jede Minute, die Sie auf Linux verlagern, echtes Geld.

Ein Job-Aufbau, der funktioniert

  1. analyze-test unter Linux für jeden Push: pub get, analyze, Tests.
  2. build-android unter Linux für jeden Push auf PRs, die android/ oder lib/ ändern.
  3. build-ios unter macOS nur für main und Tags.

Verwenden Sie Pfadfilter und concurrency, um überholte Läufe abzubrechen.

Was mehr CPU-Kerne bringen

Flutter-Tests laufen parallel und Gradle nutzt mehrere Kerne, daher hilft eine größere Linux-Maschine bei Analyse, Tests und Android-Builds. Der Xcode-Schritt profitiert überhaupt nicht von Linux-Kernen. Wir haben keine Flutter-Zeile in unseren Benchmarks, daher nennen wir keine Beschleunigung. Die Standard-Linux-Maschine von compiler.dev hat 8 vCPU / 16 GB und kostet $0.008 pro Minute. macOS ist in der Early Access verfügbar, mit einer Apple M4 Pro 7-Core-VM für $0.028 pro Minute und einer 14-Core-VM für $0.055 pro Minute. Siehe Preise und Runner-Preise. Der Wechsel erfordert eine Zeile, runs-on: [self-hosted, Linux, compiler-ci].

Verwandt: die Flutter-Vorlage, der React-Native-Leitfaden und Caching in GitHub Actions.

FAQ

Cached flutter-action auch den Pub-Cache?

Ja. Mit cache: true cacht es das SDK und auch die Pub-Abhängigkeiten, sofern Sie pub-cache nicht separat setzen. Eigene Schlüssel legen Sie mit pub-cache-key fest.

Kann ich eine iOS-App unter Linux bauen?

Nein. iOS-Builds benötigen Xcode unter macOS. Bauen Sie Android und führen Sie Tests unter Linux aus.

Sollte ich die Flutter-Version festlegen?

Ja. Verwenden Sie flutter-version oder flutter-version-file, damit sich SDK und Cache-Schlüssel nur dann ändern, wenn Sie es entscheiden.

Wie führe ich Flutter-Integrationstests schneller aus?

Führen Sie sie in einem separaten Job aus, verwenden Sie ein headless Ziel wie ein Linux-Desktop-Gerät, wenn Ihre App dies unterstützt, und laufen Sie nur auf main, wenn sie langsam sind.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen