Marketing Version: mi ez, különbség a Build Number-től és telepítés

Mi az a Marketing Version

Marketing Version — egy szemantikai szöveg, amely az alkalmazás verzióját képviseli a végfelhasználó számára. iOS-ben a CFBundleShortVersionString kulccsal, Android-ben a versionName paraméterrel van beállítva.

A „Marketing Version" kifejezés hivatalosan a Xcode-ban használatos: a target beállítások felületén a mező neve „Marketing Version", és az Info.plist-ben a CFBundleShortVersionString-nek felel meg. Android-ben a megfelelője a versionName, bár a kifejezés ritkábban használt.

Az Apple Developer Documentation (2025) szerint a Marketing Version legfeljebb három ponttal elválasztott számból állhat, szóközök és speciális karakterek nélkül. Minden szám nem haladhatja meg a 255-öt.

Válassza ki a Marketing Version-t úgy, hogy tükrözze a változtatások jelentőségét: major frissítések radikális változtatásokhoz, minor frissítések új funkciókhoz.

Különbség a belső Build Number-től

Marketing Version alapvetően különbözik a Build Number-től a céljában: az első tájékoztatja a felhasználót, a második — azonosítja a buildet az áruház számára. A Build Number növekedhet a Marketing Version megváltoztatása nélkül.

Például egy kiadott verzióban lévő kritikus hiba kijavításakor a csapat újraépítheti az alkalmazást ugyanazzal a Marketing Version (1.2.0) értékkel, de megnövelt Build Number-rel (15-ről 16-ra). A felhasználó ugyanazt a verziót látja, de az áruház megérti, hogy a build újabb.

Ez a rugalmasság lehetővé teszi a fejlesztők számára, hogy javításokat adjanak ki anélkül, hogy értesítenék a felhasználókat a verzióváltozásról.

Hol jelenik meg a Marketing Version

Marketing Version a felhasználó és az alkalmazás közötti interakció több kulcsfontosságú pontján jelenik meg. Az alkalmazásboltban látható az alkalmazás kártyáján, a frissítés leírásában és a verziótörténetben.

A készüléken a Marketing Version a rendszerbeállításokban („Az alkalmazásról" vagy „Alkalmazások" szakasz), az App Store-on vagy Google Play-en keresztüli frissítési párbeszédablakokban, valamint magában az alkalmazásban a „Névjegy" képernyőn jelenik meg.

Egy érthető Marketing Version segít a felhasználónak felmérni a telepített verzió aktualitását és dönteni a frissítésről.

Marketing Version iOS-en

iOS-en a Marketing Version a Xcode-ban a target beállítások General lapján lévő „Marketing Version" mezőn keresztül állítható be. Az érték az Info.plist-ben CFBundleShortVersionString-ként tárolódik.

A verzióformátumot az Apple szigorúan szabályozza: a szövegnek egy-három pontokkal elválasztott számot kell tartalmaznia (például 1, 1.2 vagy 1.2.3). Maximális hossz — 18 karakter. Minden szám nem haladja meg a 255-öt.

Az Apple App Store Review Guidelines (2025) szerint az App Store Connect nem engedélyezi a build feltöltését, ha a Marketing Version több mint egy major vagy minor értékkel különbözik az előző kiadott verziótól — ez védi a felhasználókat az elmaradt frissítésektől.

Használja az agvtool-t a Marketing Version parancssorból történő kezeléséhez — ez egyszerűsíti a CI/CD rendszerekkel való integrációt és garantálja a szinkronizációt a Build Number-rel.

Marketing Version Androidon

Android-on a Marketing Version a build.gradle fájl versionName paraméterével van beállítva. Az iOS-szel ellentétben az Android nem ír elő szigorú korlátozásokat a verziószöveg formátumára.

versionName bármilyen karaktert tartalmazhat: betűket, számokat, kötőjeleket és pontokat. A Google Play ezt a szöveget az alkalmazás kártyáján és a frissítési listában jeleníti meg, de nem ellenőrzi semmilyen sablonnak való megfelelőségét.

Azonban a Google Play ajánlja a Major.Minor.Patch szemantikai formátum betartását az egységesség érdekében. Ez leegyszerűsíti a verzió érzékelését a felhasználók számára és lehetővé teszi a frissítések automatikus elemzését.

Adjon meg egy olyan versionName-t, amely egyértelműen tükrözi a kiadás típusát — major frissítés, minor vagy patch. Ez segít a felhasználóknak gyorsan felmérni a változtatások jelentőségét.

A versionName dinamikus generálása

versionName Androidon dinamikusan generálható Git tagek vagy CI/CD változók alapján. Ez leegyszerűsíti a verziókezelési folyamatot és kiküszöböli a tároló és a build közötti eltéréseket.

Tipikus megközelítés — a Git tag olvasása (például v2.1.0) és az értékének használata versionName-ként. Ha nincs tag, a verzió generálható a dátum és a commit szám alapján.

Ez a megközelítés garantálja, hogy a versionName mindig megfelel a forráskód állapotának, és nem igényel kézi frissítést.

Különbség a Marketing Version és a Build Number között

Marketing Version és a Build Number — két független paraméter, amelyek különböző feladatokat oldanak meg. A Marketing Version tájékoztatja a felhasználót, a Build Number technikailag azonosítja a buildet.

A legfontosabb különbség — egyediség. A Build Number-nek egyedinek kell lennie minden buildhez. A Marketing Version megismételhető: ugyanazon verzió több buildje ugyanazzal a Marketing Version-nel, de különböző Build Number-rel rendelkezik.

A Google Play Policy (2025) szerint, ha két APK kerül feltöltésre azonos Marketing Version-nel, de eltérő Build Number-rel, a Google Play mindkettőt ugyanazon verzió különböző buildjeiként fogadja el. Az App Store-ra hasonló szabály vonatkozik.

Ne feledje: Build Number — a gépeknek, Marketing Version — az embereknek. Automatizálja az elsőt és gondosan tervezze meg a másodikat.

Verziókezelési stratégiák

A stratégia kiválasztása függ az alkalmazás típusától, a közönségtől és a kiadási folyamattól. Három fő séma — szemantikai, naptári és hibrid — a legtöbb forgatókönyvet lefedi.

Szemantikai verzió (SemVer) a Major.Minor.Patch formátumot használja, és szigorúan meghatározza, hogy mikor melyik összetevőt kell növelni. Ideális nyilvános API-val és összetett integrációval rendelkező alkalmazásokhoz.

A semver.org (2023) szerint a SemVer specifikáció 2.0.0 verzióját a mobil open-source projektek 89%-a használja, és minden csomagkezelő támogatja.

Naptári verziókezelés

Naptári verziókezelés (CalVer) a kiadás dátumát használja verzióként — például 25.06 a 2025. júniusi kiadáshoz. Ez a megközelítés a gyakran frissülő alkalmazásoknál népszerű.

CalVer nem hordoz információt a változtatások jelentőségéről, de kiválóan mutatja a verzió frissességét. A felhasználó azonnal megérti, hogy a 25.06-os verzió újabb, mint a 25.03.

Válassza a naptári verziókezelést, ha alkalmazása gyakran frissül, és a felhasználók számára az adatok frissessége fontosabb, mint a változtatások mértéke.

Ajánlások a kiválasztáshoz

MVP-k és startupok számára egyszerű szemantikai verzió patch nélkül (Major.Minor) megfelelő. Hosszú távú támogatással rendelkező érett termékekhez — teljes SemVer. Folyamatos kiadású alkalmazásokhoz — CalVer.

Soha ne használja a dátumot Build Number-ként — ez konfliktusokhoz vezethet napi több build esetén. A Build Number-nek szekvenciálisnak vagy összetettnek kell lennie, de mindig monoton növekvőnek.

Hibák a Marketing Version kiválasztásakor

Tipikus hiba — a verzió összetevő kihagyása egy új major vonalra való áttéréskor. Például az 1.9.9 verzió után a következőnek 2.0.0-nak kell lennie, nem 1.10.0-nak. Ez sérti a szemantikát és összezavarja a felhasználókat.

Egy másik gyakori probléma — a Marketing Version eltérése a kódban és az alkalmazásboltban. Mindig ellenőrizze, hogy a build.gradle-ben lévő versionName megegyezik-e a Google Play Console-ban vagy App Store Connect-ben megadott verzióval, mielőtt elküldi a buildet felülvizsgálatra.

Példák a Marketing Version beállítására

Kódpéldák mutatják, hogyan kell beállítani a Marketing Version-t mindkét platformon és automatizálni a frissítését.

A versionName beállítása Android Gradle-ben

Android-on a versionName a build.gradle-ben van beállítva. Az érték lehet statikus vagy környezeti változóból olvasott.

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

// Verzió olvasása Git tag-ből
def getVersionNameFromGit = {
    def tag = "git describe --tags".execute().
        text.trim()
    return tag.startsWith("v") ? tag.substring(1) : tag
}

versionName a Git tag-ből kerül kinyerésre, ami garantálja a tárolóban lévő verzió és az összeállított alkalmazás közötti megfelelést.

Marketing Version kezelése Xcode-ban

iOS-en a Marketing Version Xcode-on vagy agvtool-on keresztül állítható be. Az alábbi parancs egy új marketing verziót állít be.

# Marketing Version beállítása
xcrun agvtool new-marketing-version 2.1.0

# Automatikus növelés
xcrun agvtool next-marketing-version

agvtool automatikusan frissíti az Info.plist-et és szinkronizálja a verziót a Xcode projekt összes targetje között.

Fastlane mindkét platformhoz

Fastlane lehetővé teszi a Marketing Version kezelését mindkét platformon egyetlen scriptből, ami leegyszerűsíti a cross-platform projektek támogatását.

# Marketing verzió beállítása
increment_version_number(
    version_number: "2.1.0"
)

# Minor verzió automatikus növelése
increment_version_number(
    bump_type: "minor"
)

Fastlane mindkét platformon működik, és a legtöbb CI/CD szolgáltatás támogatja.