Xcode-Builds in der CI beschleunigen
Zuletzt aktualisiert am
Xcode-Builds in CI sind aus vorhersehbaren Gründen langsam: kalte Paket-Downloads, vollständige Neukompilierungen, Simulatorstart und Tests auf einer kleinen VM. Da Mac-Minuten teuer sind, kostet jeder dieser Punkte echtes Geld. Dieser Guide zeigt, was hilft und was nicht.
Die Umgebung festlegen
Machen Sie Läufe zunächst vergleichbar. Fixieren Sie das Runner-Image und die Xcode-Version:
runs-on: macos-15
steps:
- uses: actions/checkout@v4
- run: sudo xcode-select -s /Applications/Xcode_16.4.app
- run: xcodebuild -version
Prüfen Sie im Readme des runner-images-Repositorys für Ihr Image, welche Xcode-Versionen installiert sind; die verfügbaren Pfade ändern sich mit den Image-Updates. Wenn Sie macos-latest verwenden, kann sich Ihr Build ändern, sobald der Standard wechselt.
Abhängigkeiten des Swift Package Managers cachen
Das Auflösen und Klonen von Paketen kann auf einem kalten Runner eine Minute oder mehr dauern. Geben Sie xcodebuild an, wo die Klone abgelegt werden sollen, und cachen Sie dann dieses Verzeichnis:
- uses: actions/cache@v4
with:
path: .spm
key: spm-${{ runner.os }}-${{ hashFiles('**/Package.resolved') }}
restore-keys: spm-${{ runner.os }}-
- run: |
xcodebuild -resolvePackageDependencies \
-scheme MyApp \
-clonedSourcePackagesDirPath .spm
Übergeben Sie denselben -clonedSourcePackagesDirPath .spm an die späteren build- und test-Befehle. Committen Sie Package.resolved, damit der Cache-Schlüssel stabil bleibt und Builds reproduzierbar sind.
Bei CocoaPods cachen Sie das Verzeichnis Pods anhand von Podfile.lock oder besser ~/.cocoapods und führen pod install aus, damit die Lockdatei maßgeblich bleibt. Carthage-Nutzer sollten Carthage/Build cachen und XCFrameworks mit --use-xcframeworks verwenden.
DerivedData: Vorsicht
Das Cachen von ~/Library/Developer/Xcode/DerivedData ist die verlockende Lösung für langsame Kompilierungen, enttäuscht aber oft. Die inkrementellen Build-Entscheidungen von Xcode hängen von Änderungszeitpunkten der Dateien und absoluten Pfaden ab. Ein frischer git checkout gibt jeder Quelldatei einen neuen Änderungszeitpunkt, sodass Xcode alles als geändert ansieht und neu baut, obwohl Sie zuvor den Cache mit mehreren Gigabyte wiederhergestellt haben.
Was funktioniert:
- Build-Produkte pro Abhängigkeit cachen für Abhängigkeiten, die sich nicht ändern, etwa vorkompilierte XCFrameworks für Ihre Pods oder Pakete, anhand ihrer Version.
- Einen Compiler-Cache verwenden, etwa ccache für C-, C++- und Objective-C-Teile, oder einen Build-System-Cache, wenn Sie die Cache-Funktionen von Bazel oder Tuist nutzen.
- Einen gemeinsamen DerivedData-Pfad über Jobs hinweg vermeiden, sofern Sie ihn nicht getestet haben: Setzen Sie
-derivedDataPath build, damit der Speicherort explizit und bei jedem Lauf gleich ist.
Wenn Sie einen DerivedData-Cache ausprobieren, vergleichen Sie einen Kaltlauf mit einem Warmlauf im Build-Log. Kompiliert der Warmlauf immer noch die meisten Dateien, entfernen Sie den Cache; er belegt Speicher aus Ihrem Limit von 10 GB pro Repository ohne Nutzen.
Einmal bauen, parallel testen
Kompilieren Sie einmal und führen Sie die Tests dann auf verschiedene Arten aus:
- run: |
xcodebuild build-for-testing \
-scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16' \
-derivedDataPath build \
-clonedSourcePackagesDirPath .spm
- run: |
xcodebuild test-without-building \
-scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16' \
-derivedDataPath build \
-parallel-testing-enabled YES
Sie können die gebauten Produkte auch als Artefakt hochladen und test-without-building mit -only-testing:-Filtern auf mehrere Jobs verteilen. Jeder zusätzliche Job wird zum Mac-Tarif mit mindestens einer Minute berechnet, deshalb lohnt sich das nur für Suiten, die viele Minuten laufen.
Tests günstiger machen
- Wählen Sie für PR-Builds einen Simulator, etwa das aktuelle iPhone, und führen Sie die breitere Geräte-Matrix nachts aus. Jedes Ziel vervielfacht die Laufzeit.
- Starten Sie den Simulator früh, damit er sich aufwärmt, während Pakete aufgelöst werden:
xcrun simctl boot "iPhone 16"als Hintergrundschritt. Verfügbare Geräte prüfen Sie mitxcrun simctl list devices available. - Paralleles Testen (
-parallel-testing-enabled YES) klont Simulatoren und führt Testklassen gleichzeitig aus. Dafür brauchen Sie Tests ohne gemeinsamen globalen Zustand, und es verbraucht mehr Arbeitsspeicher, was auf dem Standard-Runner mit 7 GB ins Gewicht fällt. - UI-Tests nicht bei jedem Push ausführen. UI-Tests sind langsam und anfällig für Flakiness; führen Sie sie beim Merge oder bei einem Label aus.
- Code Coverage und unnötige Ergebnisbündel bei PR-Läufen deaktivieren:
-enableCodeCoverage NO.
Kompilieraufwand reduzieren
- Verwenden Sie
-skipMacroValidationund-skipPackagePluginValidationnur, wenn Sie den Makros und Plugins in Ihren Abhängigkeiten vertrauen; andernfalls wartet die CI auf eine Freigabe. Verstehen Sie zuerst den Sicherheits-Trade-off. - Setzen Sie
COMPILER_INDEX_STORE_ENABLE=NOin CI-Builds. Die Indizierung dient dem Editor, nicht dem Build. - Bauen Sie für Tests die Debug-Konfiguration. Release-Builds mit Whole-Module-Optimierung sind deutlich langsamer und nur für Archive nötig.
- Teilen Sie große Targets in Module auf, damit Änderungen weniger neu kompiliert werden. Das hilft auch auf den Rechnern der Entwickler.
- Geben Sie für Simulator-Builds
ARCHS=arm64(oderONLY_ACTIVE_ARCH=YES) an, damit Sie nicht für Architekturen kompilieren, die der Runner nicht nutzt.
Senken Sie die Kosten, nicht nur die Laufzeit
Mac-Minuten sind teuer. Kombinieren Sie Geschwindigkeitsoptimierungen mit den Kostenregeln aus macOS-Runner für iOS-CI: Linting auf Linux ausführen, überholte Läufe abbrechen, timeout-minutes setzen und die Kosten pro Lauf messen, bevor Sie auf einen größeren Mac wechseln. Tragen Sie Ihre Zahlen in den Kostenrechner ein, um die monatliche Wirkung zu sehen.
Eine sinnvolle Reihenfolge
- Xcode und das Runner-Image fixieren.
- SPM oder Pods cachen.
- Build und Test mit
build-for-testingtrennen. - Ziele und UI-Tests aus PR-Läufen streichen.
- Einen größeren Runner ausprobieren und die Kosten pro Lauf vergleichen.
FAQ
Sollte ich DerivedData cachen?
Testen Sie es, bevor Sie sich festlegen. Der Checkout setzt die Änderungszeitstempel der Dateien zurück, was Xcodes inkrementelle Logik häufig aushebelt. Dependency-Caches sind der sicherere erste Schritt.
Warum sind meine Simulator-Tests in der CI langsamer als lokal?
CI-Macs haben weniger Kerne und weniger Arbeitsspeicher als ein Entwickler-Laptop, und der Simulator startet kalt. Starten Sie ihn frühzeitig und reduzieren Sie die parallelen Worker, wenn Sie Speicherdruck bemerken.
Hilft ein größerer Runner bei Xcode?
In der Regel ja, da Xcode parallel kompiliert. Der M2 Pro 5-Core-Runner kostet $0.102 pro Minute gegenüber $0.062 für den Standard-Runner, daher muss er mindestens 1.65-mal schneller sein, um günstiger zu sein.
Wie finde ich langsame Targets?
Fügen Sie -showBuildTimingSummary zu xcodebuild hinzu und lesen Sie die Zusammenfassung am Ende des Logs, oder aktivieren Sie -Xfrontend -warn-long-function-bodies=500, um Funktionen zu finden, deren Typprüfung lange dauert.
Vergleich mit Ihrem eigenen Projekt
Die Build-Zeiten hängen stark von Ihrem Projekt ab. Mit dem Vergleichsmodus von compiler.dev können Sie einen macOS-Workflow auf den Early-Access-M4-Pro-Runnern ausführen und Laufzeit sowie Kosten mit Ihrem aktuellen Runner vergleichen, ohne den Rest Ihrer Pipeline zu ändern.
Verwandt
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.
- .NET in GitHub Actions beschleunigen.NET-Builds in GitHub Actions beschleunigen: NuGet-Caching mit setup-dotnet, --no-restore, --no-build, paralleles dotnet test und SQL-Server-Services.