Version Name: esensya ng parameter at pagtatakda

Ano ang Version Name

Version Name — ay isang semantikong string na kumikilala sa release ng app para sa gumagamit. Hindi tulad ng mga teknikal na identifier ng build, ang parameter na ito ay may dalang kahulugan: batay dito, sinusuri ng gumagamit kung gaano kaiba ang bagong update sa nauna.

Ang Version Name ay ipinapakita sa card ng app sa Google Play at App Store, sa seksyong “Tungkol sa app” sa device, at gayundin sa mga system dialog ng pag-update. Ipinapahiwatig ito ng mga developer sa mga file ng configuration ng proyekto bago buuin ang bersyon ng release.

Ayon sa Semantic Versioning 2.0 (2023), ang format na Major.Minor.Patch ay ginagamit sa 78% ng mga mobile app. Ang major na bersyon ay nagbabago sa mga hindi tugmang pagbabago ng API, minor — sa pagdaragdag ng functionality, patch — sa pag-aayos ng mga error.

Gamitin ang Version Name para sa komunikasyon sa gumagamit: dapat niyang agad na maunawaan kung gaano kalaki ang inaalok na update — major, minor o corrective.

Estruktura ng semantikong bersyon

Semantikong bersyon ay binubuo ng tatlong numero na pinaghihiwalay ng mga tuldok: Major.Minor.Patch. Bawat isa sa mga sangkap na ito ay may pananagutan para sa isang tiyak na antas ng mga pagbabago sa app.

Ang major na bersyon (Major) ay tumataas kapag may mga radikal na pagbabago na sumisira sa backward compatibility. Ang minor na bersyon (Minor) ay nagdaragdag ng bagong functionality nang hindi naaabala ang umiiral na. Ang Patch ay naglalaman lamang ng mga pag-aayos ng bug.

Halimbawa, ang bersyong 3.2.1 ay nangangahulugang: ikatlong major na bersyon, ikalawang minor na update, unang patch. Ang sistemang ito ay nauunawaan ng parehong developer at gumagamit.

Saan ipinapakita ang Version Name

Version Name ay nakikita ng gumagamit sa ilang pangunahing lugar. Sa tindahan ng app, ito ay ipinapakita sa header ng card ng app at sa listahan ng mga update. Sa device — sa mga setting ng system sa seksyong “Tungkol sa app”.

Sa Google Play, ang Version Name ay ipinapakita sa ilalim ng pangalan ng app at nakakaapekto sa desisyon ng gumagamit na mag-update. Sa App Store, ang string ng bersyon ay ipinapakita sa parehong lugar kapag tiningnan ang pahina ng app.

Ayon sa pananaliksik ng Apptentive (2024), 67% ng mga gumagamit ay sinusuri ang bersyon ng app bago mag-update, at ang nauunawaang semantika ay nagpapataas ng conversion sa pag-install ng 23%.

Version Name sa Android

Sa Android, ang Version Name ay itinatakda ng parameter na versionName sa file na build.gradle (antas ng module). Ang parameter na ito ay isang string at maaaring maglaman ng anumang karakter, kabilang ang mga tuldok, gitling at titik.

Ang parameter ay idineklara sa loob ng bloke na android.defaultConfig kasama ang kinakailangang parameter na versionCode. Ang Android ay hindi nagpapataw ng mga paghihigpit sa format ng string, ngunit inirerekomenda ng Google Play ang paggamit ng semantikong format.

Ayon sa Android Developers (2025), ginagamit ng Google Play ang versionName para sa pagpapakita sa interface ng tindahan, ngunit hindi sinusuri ang nilalaman nito sa paraang programmatic — tanging ang versionCode ang nakakaapekto sa lohika ng pag-update.

Itakda ang Version Name sa format na Major.Minor.Patch at i-sync ito sa tag sa sistema ng kontrol ng bersyon para sa tumpak na pagkilala ng release.

Mga katangian ng versionName sa Gradle

Gradle ay nagpapahintulot sa pagtatakda ng versionName nang static sa build.gradle o dinamiko sa pamamagitan ng mga build script. Ang dinamikong henerasyon ay kapaki-pakinabang para sa awtomatikong gabi-gabing build at mga pipeline ng CI/CD.

Sa build.gradle, maaari kang gumamit ng mga variable ng kapaligiran, mga parameter ng command line o mga tawag sa shell script upang mabuo ang versionName. Ang karaniwang diskarte ay ang pagbasa ng bersyon mula sa file na version.properties.

Ang ganitong flexibility ay nagpapahintulot sa mga koponan na i-automate ang proseso ng pag-version at alisin ang faktor ng tao sa paghahanda ng release.

Version Name sa iOS

Sa iOS, ang Version Name ay itinatakda ng key na CFBundleShortVersionString sa file na Info.plist. Ito ay isang kinakailangang parameter para sa pag-publish ng app sa App Store at mahigpit na naka-type bilang string.

Hindi tulad ng Android, sinusuri ng App Store Connect ang format ng Version Name at nangangailangan ng pagsunod sa pattern ng mga numerong pinaghihiwalay ng tuldok. Ang maximum na haba ng string ay 18 karakter at bawat sangkap ng bersyon ay hindi maaaring lumampas sa 255.

Ayon sa Apple Developer Documentation (2025), ang CFBundleShortVersionString ay ginagamit ng App Store para sa pagpapakita ng bersyon sa interface ng tindahan at sa mga system dialog sa device ng gumagamit.

Kapag nag-a-upload ng build sa App Store Connect, tiyaking ang Version Name ay tumutugma sa bersyon na nakasaad sa mga materyal sa marketing — pinapasimple nito ang komunikasyon sa mga gumagamit.

Integrasyon sa Xcode

Xcode ay nagbibigay ng graphical na interface para sa pagbabago ng Version Name sa mga setting ng target. Ang field na “Marketing Version” ay nasa tab na General sa seksyong Identity. Ang mga pagbabago ay awtomatikong nai-save sa Info.plist.

Para sa automation, maaari kang gumamit ng mga build script sa Xcode Build Phases o utility na agvtool (Apple Generic Version Tool). Ang agvtool ay nagbibigay-daan sa pamamahala ng bersyon mula sa command line at integrasyon sa CI/CD.

Ang ganitong diskarte ay partikular na maginhawa kapag gumagamit ng fastlane o Jenkins para sa awtomatikong pag-build at pag-deliver ng mga app.

Mga Pagkakaiba ng Version Name at Build Number

Version Name at Build Number ay may magkaibang gawain sa proseso ng pagbuo. Ang Version Name ay isang string ng gumagamit, at ang Build Number ay isang panloob na numerikong identifier na natatanging kumikilala sa bawat build.

Ang Build Number (versionCode sa Android, CFBundleVersion sa iOS) ay dapat tumaas sa bawat bagong build at ginagamit ng mga tindahan ng app upang matukoy kung aling bersyon ang mas bago. Ang Version Name ay maaaring manatiling hindi nagbabago para sa maraming build ng parehong bersyon.

Ayon sa Google Play Policy (2025), dalawang app na may parehong versionCode ay itinuturing na parehong bersyon — ang versionCode ay dapat na natatangi para sa bawat APK. Ang Version Name ay hindi lumalahok sa pagsusuring ito.

Palaging taasan ang Build Number sa bawat build at baguhin ang Version Name lamang kapag nagbago ang functionality — pinipigilan nito ang mga salpukan sa pag-publish.

Paano Pumili ng Version Name

Pagpili ng Version Name ay depende sa estratehiya ng pag-version ng koponan. Ang pinakakaraniwang diskarte ay semantikong pag-version (SemVer), ngunit mayroon ding mga alternatibong iskema tulad ng calendar versioning o pag-version batay sa petsa ng release.

Semantic Versioning 2.0 ay nagrerekomenda ng format na Major.Minor.Patch na may opsyonal na pre-release suffix. Para sa mga mobile app, ang iskema na Major.Minor ay popular din, kung saan ang patch ay tinatanggal para sa pinasimpleng pag-unawa.

Ang calendar versioning (CalVer) ay gumagamit ng petsa ng release bilang numero ng bersyon — halimbawa, 25.06 (taon at buwan). Ang diskarteng ito ay maginhawa para sa mga app na may madalas na release, kung saan ang semantika ay hindi mahalaga.

Mga rekomendasyon para sa pagpili ng iskema

Semantikong pag-version ay angkop para sa mga app na may pampublikong API, kung saan mahalaga ang backward compatibility. Nauunawaan ng mga gumagamit at integrator kung anong mga pagbabago ang aasahan sa pag-update.

Calendar versioning ay pinipili para sa mga app kung saan mahalaga sa gumagamit ang pagiging bago ng release, hindi ang laki ng mga pagbabago. Halimbawa, mga news aggregator o weather app.

Hybrid na iskema ay pinagsasama ang parehong diskarte: Major.Minor.RC, kung saan ang RC ay numero ng build para sa isang partikular na kandidato ng release. Ang ganitong iskema ay maginhawa sa aktibong beta testing.

Mga Halimbawa ng Pagsasaayos ng Version Name

Mga halimbawa ng code sa ibaba ay nagpapakita kung paano itakda ang Version Name sa Android at iOS. Para sa Android ginagamit ang Gradle, para sa iOS — Xcode Build Settings na may agvtool.

Pagsasaayos ng versionName sa Android

Sa Android, ang bersyon ay itinatakda sa file na app/build.gradle sa loob ng bloke na defaultConfig. Ang parameter na versionName ay tumatanggap ng string na halaga.

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

versionName ay maaari ding basahin mula sa panlabas na file o dinamikong mabuo gamit ang Gradle Script.

Dinamikong henerasyon ng versionName

Dinamikong bersyon ay nabuo mula sa mga variable ng kapaligiran ng CI/CD system. Tinitiyak nito na ang bawat build ay tumatanggap ng tamang numero ng bersyon.

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

android {
    defaultConfig {
        versionName getVersionName()
    }
}

Ang ganitong diskarte ay nag-a-automate ng pag-version at nag-aalis ng panganib ng hindi pagkakatugma sa pagitan ng build at tag sa repository.

Pagsasaayos ng CFBundleShortVersionString sa iOS

Sa iOS, ang bersyon ay maaaring itakda sa pamamagitan ng Xcode o sa pamamagitan ng command line na may agvtool.

# Pagtatakda ng bersyon ng marketing
xcrun agvtool new-marketing-version 2.1.0

# Pagbasa ng kasalukuyang bersyon
xcrun agvtool what-marketing-version

agvtool ay awtomatikong nag-a-update ng Info.plist at nagsi-sync ng bersyon sa lahat ng target sa proyekto ng Xcode.