Version Name: Wesen, Bedeutung des Parameters und Einrichtung

Was ist Version Name

Version Name ist eine semantische Zeichenfolge, die den Release der App für den Benutzer identifiziert. Im Gegensatz zu technischen Build-Kennungen trägt dieser Parameter eine semantische Bedeutung: Anhand von ihm bewertet der Benutzer, wie stark sich das neue Update vom vorherigen unterscheidet.

Version Name wird in der App-Karte bei Google Play und im App Store angezeigt, im Abschnitt „Über die App“ auf dem Gerät sowie in den Systemdialogen für Updates. Entwickler geben ihn in den Konfigurationsdateien des Projekts vor dem Build der Release-Version an.

Laut Semantic Versioning 2.0 (2023) wird das Format Major.Minor.Patch in 78% der mobilen Apps verwendet. Die Major-Version ändert sich bei inkompatiblen API-Änderungen, die Minor-Version — bei der Hinzufügung von Funktionalität, der Patch — bei Fehlerkorrekturen.

Verwenden Sie Version Name für die Kommunikation mit dem Benutzer: Er soll sofort verstehen, wie groß das angebotene Update ist — Major, Minor oder Korrektur.

Struktur einer semantischen Version

Die semantische Version besteht aus drei durch Punkte getrennten Zahlen: Major.Minor.Patch. Jede dieser Komponenten ist für eine bestimmte Ebene der Änderungen in der App verantwortlich.

Die Major-Version (Major) erhöht sich bei grundlegenden Änderungen, die die Rückwärtskompatibilität brechen. Die Minor-Version (Minor) fügt neue Funktionalität hinzu, ohne die bestehende zu beeinträchtigen. Der Patch (Patch) enthält nur Fehlerkorrekturen.

Zum Beispiel bedeutet die Version 3.2.1: die dritte Major-Version, das zweite Minor-Update, der erste Patch. Ein solches System ist sowohl für Entwickler als auch für Benutzer verständlich.

Wo Version Name angezeigt wird

Version Name ist für den Benutzer an mehreren wichtigen Stellen sichtbar. Im App-Store wird er im Titel der App-Karte und in der Update-Liste angezeigt. Auf dem Gerät — in den Systemeinstellungen im Abschnitt „Über die App“.

Bei Google Play wird Version Name unter dem App-Namen angezeigt und beeinflusst die Entscheidung des Benutzers über das Update. Im App Store wird die Versionszeichenfolge an derselben Stelle beim Anzeigen der App-Seite angezeigt.

Laut der Studie Apptentive (2024) prüfen 67% der Benutzer die Version der App vor dem Update, und eine verständliche Semantik erhöht die Konversion zur Installation um 23%.

Version Name unter Android

Unter Android wird Version Name durch den Parameter versionName in der Datei build.gradle (auf Modulebene) festgelegt. Dieser Parameter ist eine Zeichenfolge und kann beliebige Zeichen enthalten, einschließlich Punkte, Bindestriche und Buchstaben.

Der Parameter wird im Block android.defaultConfig zusammen mit dem Pflichtparameter versionCode deklariert. Android legt keine Beschränkungen für das Format der Zeichenfolge fest, aber Google Play empfiehlt die Verwendung des semantischen Formats.

Laut Android Developers (2025) verwendet Google Play versionName für die Anzeige in der Store-Oberfläche, analysiert seinen Inhalt jedoch nicht programmatisch — nur versionCode beeinflusst die Update-Logik.

Geben Sie Version Name im Format Major.Minor.Patch an und synchronisieren Sie ihn mit dem Tag im Versionskontrollsystem für eine eindeutige Identifizierung des Releases.

Besonderheiten von versionName in Gradle

Gradle ermöglicht es, versionName statisch in build.gradle oder dynamisch über Build-Skripte festzulegen. Die dynamische Generierung ist nützlich für automatische Nacht-Builds und CI/CD-Pipelines.

In build.gradle können Umgebungsvariablen, Kommandozeilenparameter oder Aufrufe von Shell-Skripten zur Bildung von versionName verwendet werden. Ein typischer Ansatz ist das Lesen der Version aus der Datei version.properties.

Diese Flexibilität ermöglicht es Teams, den Versionsprozess zu automatisieren und den menschlichen Faktor bei der Release-Vorbereitung auszuschließen.

Version Name unter iOS

Unter iOS wird Version Name durch den Schlüssel CFBundleShortVersionString in der Datei Info.plist festgelegt. Dies ist ein Pflichtparameter für die Veröffentlichung der App im App Store, und er ist streng als Zeichenfolge typisiert.

Im Gegensatz zu Android prüft App Store Connect das Format von Version Name und verlangt die Übereinstimmung mit dem Muster aus durch Punkte getrennten Zahlen. Die maximale Länge der Zeichenfolge beträgt 18 Zeichen, und jede Versionskomponente darf 255 nicht überschreiten.

Laut Apple Developer Documentation (2025) verwendet der App Store CFBundleShortVersionString, um die Version in der Store-Oberfläche und in den Systemdialogen auf dem Gerät des Benutzers anzuzeigen.

Stellen Sie beim Hochladen des Builds in App Store Connect sicher, dass Version Name mit der in den Marketing-Materialien angegebenen Version übereinstimmt — dies vereinfacht die Kommunikation mit den Benutzern.

Integration mit Xcode

Xcode bietet eine grafische Oberfläche zum Ändern von Version Name in den Target-Einstellungen. Das Feld „Marketing Version“ befindet sich auf der Registerkarte General im Abschnitt Identity. Änderungen werden automatisch in Info.plist gespeichert.

Für die Automatisierung können Build-Skripte in Xcode Build Phases oder das Dienstprogramm agvtool (Apple Generic Version Tool) verwendet werden. agvtool ermöglicht die Verwaltung von Versionen über die Kommandozeile und lässt sich in CI/CD integrieren.

Dieser Ansatz ist besonders praktisch bei der Verwendung von fastlane oder Jenkins für den automatischen Build und die Bereitstellung von Apps.

Unterschiede zwischen Version Name und Build Number

Version Name und Build Number erfüllen unterschiedliche Aufgaben im Entwicklungsprozess. Version Name ist eine Benutzerzeichenfolge, während Build Number ein interner numerischer Identifikator ist, der jeden Build eindeutig identifiziert.

Build Number (versionCode unter Android, CFBundleVersion unter iOS) muss mit jedem neuen Build erhöht werden und wird von den App-Stores verwendet, um zu bestimmen, welche Version neuer ist. Version Name kann für mehrere Builds einer Version unverändert bleiben.

Laut Google Play Policy (2025) gelten zwei Apps mit demselben versionCode als dieselbe Version — versionCode muss für jedes APK eindeutig sein. Version Name ist an dieser Prüfung nicht beteiligt.

Erhöhen Sie Build Number bei jedem Build und ändern Sie Version Name nur bei Änderungen der Funktionalität — dies verhindert Konflikte bei der Veröffentlichung.

So wählt man Version Name

Die Wahl von Version Name hängt von der Versionsstrategie des Teams ab. Der am häufigsten verwendete Ansatz ist das semantische Versionsmanagement (SemVer), aber es gibt auch alternative Schemata wie das Kalender-Versionsmanagement oder das Versionsmanagement nach Release-Datum.

Semantic Versioning 2.0 empfiehlt das Format Major.Minor.Patch mit optionalen Pre-Release-Suffixen. Für mobile Apps ist auch das Schema Major.Minor beliebt, bei dem die Patch-Version zur Vereinfachung der Wahrnehmung weggelassen wird.

Das Kalender-Versionsmanagement (CalVer) verwendet das Release-Datum als Versionsnummer — zum Beispiel 25.06 (Jahr und Monat). Dieser Ansatz ist praktisch für Apps mit häufigen Releases, bei denen die Semantik keine Bedeutung hat.

Empfehlungen zur Wahl des Schemas

Semantisches Versionsmanagement eignet sich für Apps mit einer öffentlichen API, bei denen die Rückwärtskompatibilität wichtig ist. Benutzer und Integratoren verstehen, welche Änderungen beim Update zu erwarten sind.

Kalender-Versionsmanagement wird für Apps gewählt, bei denen dem Benutzer die Aktualität des Releases wichtiger ist als der Umfang der Änderungen. Zum Beispiel Nachrichten-Aggregatoren oder Wetter-Apps.

Ein Hybrid-Schema vereint beide Ansätze: Major.Minor.RC, wobei RC die Build-Nummer für einen bestimmten Release-Kandidaten ist. Ein solches Schema ist bei aktivem Beta-Testing praktisch.

Beispiele für die Einrichtung von Version Name

Die Codebeispiele unten zeigen, wie Version Name unter Android und iOS festgelegt wird. Für Android wird Gradle verwendet, für iOS — Xcode Build Settings mit agvtool.

Einrichtung von versionName in Android

In Android wird die Version in der Datei app/build.gradle im Block defaultConfig festgelegt. Der Parameter versionName akzeptiert einen Zeichenfolgenwert.

android {
    defaultConfig {
        versionCode 3
        versionName "2.1.0"
    }
}

versionName kann auch aus einer externen Datei gelesen oder dynamisch mit Gradle Script generiert werden.

Dynamische Generierung von versionName

Die dynamische Version wird aus den Umgebungsvariablen des CI/CD-Systems gebildet. Dies gewährleistet, dass jeder Build eine korrekte Versionsnummer erhält.

def getVersionName = {
    return System.getenv("VERSION_NAME") ?:
            "2.1.0"
}

android {
    defaultConfig {
        versionName getVersionName()
    }
}

Dieser Ansatz automatisiert das Versionsmanagement und schließt das Risiko einer Diskrepanz zwischen Build und Tag im Repository aus.

Einrichtung von CFBundleShortVersionString in iOS

In iOS kann die Version über Xcode oder über die Kommandozeile mit agvtool festgelegt werden.

# Marketing-Version festlegen
xcrun agvtool new-marketing-version 2.1.0

# Aktuelle Version auslesen
xcrun agvtool what-marketing-version

agvtool aktualisiert automatisch Info.plist und synchronisiert die Version zwischen allen Targets im Xcode-Projekt.