Warum wird bei meinem Bitrise-Build das falsche Version-Numbering verwendet?
- Einführung
- Verwendung von statischen oder falsch eingestellten Versionsquellen
- Fehlerhafte oder fehlende Integration eines Versionsnummerierung-Tools
- Probleme mit Git-Tags oder Branch-Konfigurationen
- Umgebungsvariablen und Secrets nicht korrekt gesetzt
- Zwischenspeicherung und Cache-Probleme
- Empfehlungen zur Fehlersuche und Behebung
Einführung
Die Versionsnummer eines Builds ist eine essenzielle Komponente bei der Softwareentwicklung, die dazu dient, Builds eindeutig zu identifizieren und eine nachvollziehbare Historie der Änderungen zu schaffen. Wenn auf Bitrise das falsche Version-Numbering verwendet wird, kann dies verschiedene Ursachen haben. Im Folgenden werden die häufigsten Gründe anhand typischer Abläufe und Konfigurationen auf Bitrise ausführlich erläutert.
Verwendung von statischen oder falsch eingestellten Versionsquellen
In vielen Projekten wird die Versionsnummer in einer Datei, z.B. einer Info.plist bei iOS oder einer build.gradle Datei bei Android, hinterlegt. Wenn in Bitrise diese Datei nicht richtig ausgelesen oder nicht aktualisiert wird, kann die Versionsnummer unverändert bleiben und somit veraltet oder falsch erscheinen. Das kann passieren, wenn das Versionsmanagement im Code manuell erfolgt, aber das Build-Script keinen automatischen Schritt zur Aktualisierung ausführt.
Fehlerhafte oder fehlende Integration eines Versionsnummerierung-Tools
Viele Teams nutzen Tools oder Step-Plugins in Bitrise, die automatisch anhand von Git-Tags, Commit-Zahlen oder anderen Kriterien die Versionsnummer generieren. Wenn in der Workflow-Konfiguration der entsprechende Schritt nicht aktiviert ist oder falsch konfiguriert wurde, kommt es dazu, dass die Version nicht aktualisiert wird oder eine Standard- bzw. Default-Version eingetragen wird. Fehlt beispielsweise der Git Tag Versioner-Step oder wird er vorzeitig übersprungen, kann dies dazu führen, dass die Versionsnummer nicht wie erwartet dynamisch gesetzt wird.
Probleme mit Git-Tags oder Branch-Konfigurationen
Die automatische Versionierung richtet sich häufig nach Git-Tags oder Branch-Namen. Wenn auf dem verwendeten Branch keine aktuellen oder korrekten Tags vorhanden sind oder die Workflow-Konfiguration branch-spezifisch ist, kann Bitrise eine falsche oder nicht aktualisierte Version bestimmen. Weiterhin kann es sein, dass Tags nicht heruntergeladen werden (z.B. wenn der Cloneschritt nicht mit —tags ausgeführt wird) oder dass das verwendete Repository in Bitrise nicht synchron mit dem erwarteten Stand ist.
Umgebungsvariablen und Secrets nicht korrekt gesetzt
Versionierungs-Tools basieren oft auf Umgebungsvariablen, die in den Bitrise-Einstellungen oder im Workflow hinterlegt sind. Wenn hier die Variablen fehlen, falsch benannt sind oder beispielsweise auf Standardwerte zurückfallen, führt dies zu falscher Versionierung. Weiterhin können fehlende Zugriffsrechte auf Secrets oder APIs (z.B. wenn eine Versionsnummern-API genutzt wird) dazu führen, dass keine aktuelle Version bezogen werden kann.
Zwischenspeicherung und Cache-Probleme
Bitrise nutzt für Performanceoptimierungen Caches von vorherigen Builds. Es kann vorkommen, dass ältere Versionierungsinformationen zwischengespeichert sind und nicht überschrieben werden. Wenn der Cache nicht korrekt invalidiert wird oder nicht richtig konfiguriert ist, kann die Versionsnummer aus einem veralteten Build stammen.
Empfehlungen zur Fehlersuche und Behebung
Zur gezielten Diagnose empfiehlt es sich, zunächst die kompletten Logs des Versionsschritts in Bitrise zu überprüfen. Prüfe, ob Git-Tags korrekt geladen werden, ob die Versionsnummer in den Umgebungsvariablen richtig gesetzt ist und ob das eingesetzte Versionsnummerierungstool funktioniert. Außerdem sollte die Workflow-Konfiguration genau betrachtet werden, insbesondere ob die Schritte in der richtigen Reihenfolge ausgeführt werden. Bei manuell gesetzten Versionsnummern empfiehlt sich, diese Automatisierung durch Tools wie Git Tag Versioner, Agvtool (für iOS) oder ähnliche Lösungen zu ersetzen, um menschliche Fehler zu reduzieren.