Version Name: parameterns innebörd och inställning

Vad är Version Name

Version Name — är en semantisk sträng som identifierar appens release för användaren. Till skillnad från tekniska byggidentifikatorer bär denna parameter en betydelse: baserat på den bedömer användaren hur mycket den nya uppdateringen skiljer sig från den föregående.

Version Name visas i appkortet i Google Play och App Store, i avsnittet „Om appen” på enheten, samt i systemets uppdateringsdialoger. Utvecklare anger det i projektets konfigurationsfiler innan de bygger releaseversionen.

Enligt Semantic Versioning 2.0 (2023) används formatet Major.Minor.Patch i 78% av mobilapparna. Major-versionen ändras vid inkompatibla API-förändringar, minor — vid tillägg av funktionalitet, patch — vid korrigering av fel.

Använd Version Name för kommunikation med användaren: de bör omedelbart förstå hur stor uppdateringen är — major, minor eller korrigerande.

Struktur för semantisk version

Semantisk version består av tre siffror separerade med punkter: Major.Minor.Patch. Var och en av dessa komponenter ansvarar för en viss nivå av förändringar i appen.

Major-versionen (Major) ökar vid genomgripande förändringar som bryter bakåtkompatibiliteten. Minor-versionen (Minor) lägger till ny funktionalitet utan att störa befintlig. Patch innehåller endast felrättningar.

Till exempel betyder version 3.2.1: tredje major-versionen, andra minor-uppdateringen, första patchen. Detta system är förståeligt för både utvecklare och användare.

Var visas Version Name

Version Name är synligt för användaren på flera viktiga ställen. I appbutiken visas det i rubriken på appkortet och i uppdateringslistan. På enheten — i systeminställningarna i avsnittet „Om appen”.

I Google Play visas Version Name under appens namn och påverkar användarens beslut att uppdatera. I App Store visas versionssträngen på samma ställe när appens sida visas.

Enligt forskning från Apptentive (2024) kontrollerar 67% av användarna appversionen innan uppdatering, och begriplig semantik ökar konverteringen till installation med 23%.

Version Name på Android

På Android ställs Version Name in med parametern versionName i filen build.gradle (på modulnivå). Denna parameter är en sträng och kan innehålla alla tecken, inklusive punkter, bindestreck och bokstäver.

Parametern deklareras inuti blocket android.defaultConfig tillsammans med den obligatoriska parametern versionCode. Android lägger inga begränsningar på strängens format, men Google Play rekommenderar att använda semantiskt format.

Enligt Android Developers (2025) använder Google Play versionName för visning i butiksgränssnittet, men analyserar inte dess innehåll programmatiskt — endast versionCode påverkar uppdateringslogiken.

Ange Version Name i formatet Major.Minor.Patch och synkronisera det med taggen i versionskontrollsystemet för entydig identifiering av releasen.

Egenskaper för versionName i Gradle

Gradle tillåter inställning av versionName statiskt i build.gradle eller dynamiskt via byggskript. Dynamisk generering är användbar för automatiska nattbyggen och CI/CD-pipelines.

I build.gradle kan du använda miljövariabler, kommandoradsparametrar eller anrop av shell-skript för att forma versionName. Den typiska metoden är att läsa versionen från filen version.properties.

Denna flexibilitet gör det möjligt för team att automatisera versionshanteringsprocessen och eliminera den mänskliga faktorn vid förberedelse av en release.

Version Name på iOS

På iOS ställs Version Name in med nyckeln CFBundleShortVersionString i filen Info.plist. Detta är en obligatorisk parameter för publicering i App Store och är strikt typad som en sträng.

Till skillnad från Android kontrollerar App Store Connect formatet på Version Name och kräver överensstämmelse med mönstret av punktseparerade siffror. Maximal stränglängd är 18 tecken och varje versionskomponent får inte överstiga 255.

Enligt Apple Developer Documentation (2025) används CFBundleShortVersionString av App Store för att visa versionen i butiksgränssnittet och i systemdialoger på användarens enhet.

När du laddar upp ett bygge till App Store Connect, se till att Version Name överensstämmer med versionen som anges i marknadsföringsmaterialet — detta förenklar kommunikationen med användarna.

Integration med Xcode

Xcode erbjuder ett grafiskt gränssnitt för att ändra Version Name i target-inställningarna. Fältet „Marketing Version” finns på fliken General i avsnittet Identity. Ändringar sparas automatiskt i Info.plist.

För automatisering kan du använda byggskript i Xcode Build Phases eller verktyget agvtool (Apple Generic Version Tool). agvtool möjliggör versionshantering från kommandoraden och integration med CI/CD.

En sådan metod är särskilt bekväm vid användning av fastlane eller Jenkins för automatisk byggning och leverans av appar.

Skillnader mellan Version Name och Build Number

Version Name och Build Number utför olika uppgifter i utvecklingsprocessen. Version Name är en användarsträng och Build Number är en intern numerisk identifierare som unikt identifierar varje bygge.

Build Number (versionCode i Android, CFBundleVersion i iOS) måste öka med varje nytt bygge och används av appbutiker för att avgöra vilken version som är nyare. Version Name kan förbli oförändrad för flera byggen av samma version.

Enligt Google Play Policy (2025) betraktas två appar med samma versionCode som samma version — versionCode måste vara unikt för varje APK. Version Name deltar inte i denna kontroll.

Öka alltid Build Number vid varje bygge och ändra Version Name endast när funktionaliteten ändras — detta förhindrar konflikter vid publicering.

Hur man väljer Version Name

Val av Version Name beror på teamets versionshanteringsstrategi. Den vanligaste metoden är semantisk versionshantering (SemVer), men det finns även alternativa scheman som kalenderversionshantering eller versionshantering baserad på releasedatum.

Semantic Versioning 2.0 rekommenderar formatet Major.Minor.Patch med valfria pre-release-suffix. För mobilappar är även schemat Major.Minor populärt, där patch utelämnas för att förenkla uppfattningen.

Kalenderversionshantering (CalVer) använder releasedatumet som versionsnummer — till exempel 25.06 (år och månad). Denna metod är bekväm för appar med frekenta releaser, där semantik inte har betydelse.

Rekommendationer för val av schema

Semantisk versionshantering är lämplig för appar med publikt API, där bakåtkompatibilitet är viktig. Användare och integrerare förstår vilka förändringar de kan förvänta sig vid en uppdatering.

Kalenderversionshantering väljs för appar där användaren värderar release ns färskhet, inte omfattningen av förändringar. Till exempel nyhetsaggregatorer eller väderappar.

Hybridschema kombinerar båda metoderna: Major.Minor.RC, där RC är byggnumret för en specifik releasekandidat. Ett sådant schema är bekvämt vid aktiv betatestning.

Exempel på Version Name-konfiguration

Kodexempel nedan visar hur man ställer in Version Name på Android och iOS. För Android används Gradle, för iOS — Xcode Build Settings med agvtool.

Konfiguration av versionName i Android

I Android ställs versionen in i filen app/build.gradle inuti blocket defaultConfig. Parametern versionName accepterar ett strängvärde.

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

versionName kan också läsas från en extern fil eller genereras dynamiskt med hjälp av Gradle Script.

Dynamisk generering av versionName

Dynamisk version bildas från miljövariabler i CI/CD-systemet. Detta garanterar att varje bygge får rätt versionsnummer.

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

android {
    defaultConfig {
        versionName getVersionName()
    }
}

En sådan metod automatiserar versionshantering och eliminerar risken för bristande överensstämmelse mellan bygge och tag i repot.

Konfiguration av CFBundleShortVersionString i iOS

I iOS kan versionen ställas in via Xcode eller via kommandoraden med agvtool.

# Inställning av marknadsföringsversion
xcrun agvtool new-marketing-version 2.1.0

# Läsning av aktuell version
xcrun agvtool what-marketing-version

agvtool uppdaterar automatiskt Info.plist och synkroniserar versionen mellan alla targets i Xcode-projektet.