Was kann ich tun, wenn der Android-Build in Bitrise aufgrund fehlender SDK-Komponenten fehlschlägt?

1. Einleitung
2. Ursachen verstehen
3. Bitrise Build-Stack überprüfen
4. Installation fehlender SDK-Komponenten im Workflow
5. Cache und Konfiguration überprüfen
6. Prüfung der Build-Spezifikationen
7. Zusammenfassung

Einleitung

Wenn dein Android-Build in Bitrise aufgrund fehlender SDK-Komponenten fehlschlägt, liegt das häufig daran, dass die notwendigen Android-SDK-Pakete, Build-Tools oder Plattformversionen entweder nicht installiert oder in der Bitrise-Build-Umgebung nicht korrekt konfiguriert sind. Da Bitrise standardmäßig eine vorkonfigurierte Umgebung bereitstellt, kann es vorkommen, dass neue oder spezielle SDK-Komponenten fehlen, die dein Projekt benötigt. Im Folgenden erfährst du, wie du dieses Problem eingrenzen und beheben kannst.

Ursachen verstehen

Die Fehlermeldung bezüglich fehlender SDK-Komponenten entsteht typischerweise, wenn im Build-Prozess ein bestimmtes Android-SDK-Paket (wie z. B. eine bestimmte API-Level-Plattform, Build-Tools oder Support Libraries) benötigt wird, das in der aktuell verwendeten Bitrise-Stack-Version nicht vorinstalliert ist. Da Bitrise verschiedene Stacks mit unterschiedlichen vorkonfigurierten SDK-Versionen anbietet, kann die Wahl eines falschen Stacks oder das Fehlen einer individuellen SDK-Installation zu Problemen führen.

Bitrise Build-Stack überprüfen

Zuerst solltest du prüfen, welchen Build-Stack dein Workflow verwendet. In Bitrise kannst du im Workflow-Editor sehen, welche Umgebung (Stack) eingestellt ist. Für Android-Builds werden meist Stacks wie Ubuntu 20.04 with Android SDK, Ubuntu 18.04, oder auch Container-basierte Images verwendet. Ältere oder minimalistische Stacks enthalten eventuell nicht alle neuesten SDK-Komponenten. Falls möglich, wechsle zu einem neueren oder umfangreicheren Stack, der die benötigten Komponenten bereits installiert hat.

Installation fehlender SDK-Komponenten im Workflow

Wenn der Stack die benötigten SDK-Komponenten nicht vorinstalliert hat, kannst du diese im Build-Prozess selbst installieren. Bitrise bietet dafür verschiedene Möglichkeiten. Du kannst einen Workflow-Step hinzufügen, der die Android-SDK-Komponenten über den Befehl sdkmanager installiert. Dies kannst du z. B. mit einem Script-Step realisieren, der vor deinem Build ausgeführt wird. Ein Beispiel-Befehl könnte folgendermaßen aussehen:

Dieser Befehl installiert z.B. die Plattform API 30 und die Build-Tools Version 30.0.3. Vergiss nicht, anschließend das Android-SDK-Verzeichnis und Umgebungsvariablen korrekt zu setzen, sodass deine Build-Tools darauf zugreifen können.

Cache und Konfiguration überprüfen

Ein weiterer wichtiger Punkt ist das Caching in Bitrise. Manchmal bleiben veraltete oder unvollständige SDK-Versionen im Cache hängen, was zu Inkonsistenzen führt. Leere den Bitrise-Cache oder konfiguriere ihn so, dass SDK-Komponenten korrekt aktualisiert und gespeichert werden. Außerdem solltest du sicherstellen, dass deine local.properties und build.gradle Dateien keine falschen oder veralteten Pfadangaben zu SDK-Komponenten enthalten, da diese den Build-Prozess stören können.

Prüfung der Build-Spezifikationen

Stelle außerdem sicher, dass in deiner build.gradle und eventuell in der gradle.properties keine Versionskonflikte oder falsche SDK-Versionen angegeben sind, die nicht mit der auf Bitrise vorhandenen SDK-Version harmonieren. Gegebenenfalls solltest du diese Dateien so anpassen, dass sie mit dem auf dem Build-Stack verfügbaren SDK kompatibel sind oder lade die entsprechenden Komponenten per Script nach.

Zusammenfassung

Wenn der Android-Build auf Bitrise aufgrund fehlender SDK-Komponenten fehlschlägt, solltest du zunächst den verwendeten Build-Stack überprüfen und gegebenenfalls zu einem umfassenderen wechseln. Falls die benötigten SDK-Teile nicht standardmäßig vorhanden sind, kannst du deren Installation mit einem Skript-Step automatisieren, indem du den Android SDK Manager nutzt. Achte außerdem auf korrekte Cache-Konfigurationen und die Kompatibilität deiner Projektkonfigurationsdateien mit der SDK-Version. Durch diese Maßnahmen kannst du die fehlenden SDK-Komponenten in der Bitrise-Buildumgebung nachinstallieren und deinen Build erfolgreich abschließen.