Version Code: ano ito, numeric identifier at mga update

Ano ang Version Code sa Android

Version Code — ay isang integer ng uri Integer na itinalaga sa bawat build ng Android application. Hindi tulad ng Version Name, ang Version Code ay hindi ipinapakita sa user at ginagamit lamang ng operating system at Google Play upang ihambing ang mga bersyon kapag nag-i-install ng mga update.

Format ng Version Code

Version Code ay dapat na isang positibong integer sa hanay mula 1 hanggang 2100000000. Bawat kasunod na build ay dapat may Version Code na mahigpit na mas malaki kaysa sa nauna. Kung ang developer ay naglabas ng build na may Version Code 5, ang susunod na publikasyon ay maaaring gumamit ng 6, 7, o anumang bilang na mas malaki sa 5, ngunit hindi 4 at hindi 5 muli.

Kasaysayan ng paglitaw

Ipinakilala ng Google ang paghahati sa Version Code at Version Name kasabay ng paglabas ng Android SDK noong 2007. Version Code ay idinisenyo bilang machine identifier para sa awtomatikong paghahambing ng bersyon, habang ang Version Name — bilang isang label na nababasa ng tao. Ang paghihiwalay na ito ay nagpapahintulot sa developer na pangalanan ang bersyon ayon sa gusto, habang pinapanatili ang mahigpit na pagkakasunud-sunod ng pag-update sa pamamagitan ng numeric code.

Paano gumagana ang pag-version sa pamamagitan ng Version Code

Ang mekanismo ng paghahambing ng Version Code ay naka-embed sa Android operating system at sa Google Play store. Sa bawat publikasyon, sinusuri ng Google Play kung ang Version Code ng bagong build ay mas malaki kaysa sa code ng naka-install na bersyon. Kung hindi natugunan ang kundisyon, ang publikasyon ay tatanggihan na may error.

Proseso ng pagsusuri ng update

Kapag ang device ay kumonekta sa Google Play upang suriin ang mga update, inihahambing ng server ang Version Code ng naka-install na application sa maximum na available sa store. Kung ang code sa server ay mas malaki — magsisimula ang pag-download at pag-install ng update. Nakikita ng user ang Version Name na tinukoy ng developer, ngunit ang desisyon tungkol sa pag-update ay ginagawa batay sa Version Code.

Pagtaas ng Version Code

Ang mga developer ay nag-aaplay ng iba’t ibang estratehiya para sa pagtaas ng Version Code. Ang pinakasimple ay pagtaas ng 1 sa bawat build. Para sa CI/CD pipelines, madalas ginagamit ang timestamp o build number: 2026070301 (taon-buwan-araw-bilang). Mahalaga na ang code ay monotonic na tumaas at hindi maulit sa pagitan ng iba’t ibang build at Google Play track.

• Monotonic na pagtaas — pagtaas ng 1 sa bawat commit sa release branch
• Format ng timestamp — 20260703 para sa araw-araw na build, 2026070301 para sa marami sa isang araw
• SemVer sa mga numero — 100010000 para sa bersyon 1.1.0 (major 1, minor 1, patch 0)
• Numero ng build — paggamit ng BUILD_NUMBER mula sa CI system (Jenkins, GitHub Actions)

Mga pagkakaiba sa pagitan ng Version Code at Version Name

Version Code at Version Name — dalawang independiyenteng field sa build.gradle na gumaganap ng iba’t ibang function. Ang Version Code ay isang panloob na identifier para sa system, ang Version Name ay isang marketing label para sa user. Maaari silang magbago nang independiyente sa isa’t isa.

Version Name para sa user

Version Name — ay isang string na ipinapakita sa mga setting ng application, sa Google Play, at sa mga dialog ng pag-update. Maaaring tukuyin ng developer ang anumang format: 1.0.0, 2.3.1-beta, 3.0-rc1. Para sa paghahambing ng mga text version, hindi ginagamit ang Version Name — ang Google Play ay laging umaasa sa Version Code.

Mga senaryo ng pagkakaiba

Posible ang sitwasyon kung saan Version Code ay tumaas, ngunit ang Version Name ay nananatiling hindi nagbabago. Halimbawa, kung ang developer ay nag-aayos ng kritikal na bug sa isang hotfix build nang hindi binabago ang functionality. Ang Version Name ay nananatiling 2.0.0, at ang Version Code ay nagbabago mula 5 hanggang 6. Tamang hahawakan ng Google Play ang naturang update.

// Halimbawa: hindi nagbabago ang version name, tumataas ang code
android {
    defaultConfig {
        versionCode 6  // Ay 5 — hotfix na walang bagong feature
        versionName "2.0.0"  // Hindi nagbago
    }
}

// Pagsusuri ng bersyon sa runtime
val code = BuildConfig.VERSION_CODE
val name = BuildConfig.VERSION_NAME
println("Code: $code, Pangalan: $name")

Konfigurasyon ng Version Code sa build.gradle

Konfigurasyon ng Version Code ay ginagawa sa file na build.gradle ng module ng application. Ang field na versionCode ay tumatanggap ng integer at nasa block na defaultConfig. Para sa iba’t ibang flavour build, maaaring itakda ang sariling mga halaga sa pamamagitan ng field na versionCode sa configuration ng produkto.

Pangunahing konfigurasyon

// build.gradle.kts — Kotlin DSL
android {
    defaultConfig {
        applicationId "com.example.app"
        versionCode 15
        versionName "2.1.0"
    }

    flavorDimensions +"version"
    productFlavors {
        create("demo") {
            versionCode 1015
        }
        create("full") {
            versionCode 2015
        }
    }
}

Product flavors ay nagpapahintulot sa paggamit ng iba’t ibang Version Code para sa iba’t ibang configuration: demo version, hiwalay na bersyon para sa mga tablet. Kung ang flavors ay ginagamit sa proyekto, ang huling Version Code ay binubuo ng base number at flavour-specific na pagtaas. Sinusubaybayan ng Google Play ang bawat kumbinasyon nang independiyente.

Awtomatikong pagtaas sa pamamagitan ng CI

Sa CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins) ang Version Code ay madalas na awtomatikong nabubuo batay sa build number o petsa. Tinatanggal nito ang mga pagkakamali ng tao sa manu-manong pag-update. Binabasa ng script ang kasalukuyang Version Code mula sa build.gradle, tinataasan ito, at isinusulat ito pabalit bago magsimula ang build.

// Awtomatikong pagtaas ng Version Code
import java.util.Properties
import java.io.FileInputStream

val versionProps = Properties()
versionProps.load(FileInputStream("version.properties"))

val versionCode = versionProps.getProperty("VERSION_CODE").toInt() + 1
versionProps.setProperty("VERSION_CODE", versionCode.toString())

android {
    defaultConfig {
        versionCode = versionCode
    }
}

Mga patakaran ng Version Code para sa pag-publish sa Google Play

Google Play ay may mahigpit na patakaran para sa Version Code sa pag-publish at pag-update ng mga application. Ang paglabag sa mga patakarang ito ay humahantong sa pagtanggi ng build o kawalan ng kakayahang maglabas ng update. Dapat maunawaan ng developer ang mga limitasyon at estratehiya ng pamamahala ng code sa lahat ng yugto ng lifecycle.

Patakaran ng monotonic na pagtaas

Google Play ay hindi pinapayagan ang pag-upload ng APK o AAB na ang Version Code ay mas maliit o katumbas ng kasalukuyang nai-publish. Ang patakarang ito ay gumagana para sa bawat track (production, beta, alpha) nang independiyente. Kung sa production ay na-upload ang build na may Version Code 10, at sa alpha — na may code 5, ang alpha track ay maaaring i-update sa 6, 7, 8 o 9, ngunit ang production ay nananatili sa 10.

Migrasyon sa pagitan ng mga track

Sa pag-promote ng build mula alpha patungong beta, pagkatapos ay sa production, Version Code ay dapat tumaas sa bawat yugto. Kung ang alpha version ay may code 10, ang beta ay maaaring gumamit ng 11, at ang production — 12. Hindi maaaring i-rollout sa production ang build na may code 10 kung ang alpha ay gumagamit na ng 10, kahit na hindi pa ito nakikita ng production.

• Monotonous increment — bawat build sa isang track ay may Version Code na mas malaki kaysa sa nauna sa parehong track
• Cross-track awareness — sa pag-promote sa pagitan ng mga track, ang Version Code ay sunud-sunod na tumataas
• Internal testing — ang internal testing track ay gumagamit ng parehong mga patakaran ng monotonisidad
• Multiple APKs — ang lumang format ng publikasyon ay nangangailangan ng natatanging Version Code para sa bawat APK

Mga error sa pagtukoy ng Version Code

Ang pinakakaraniwang error — pagtutugma ng Version Code sa iba’t ibang build na na-upload sa isang track. Ibinabalik ng Google Play ang error na APK_VERSION_CODE_ALREADY_EXISTS. Isa pang error — paglampas sa maximum na halaga na 2100000000, na nagdudulot ng error sa compilation. Upang maiwasan ang mga salungatan, gamitin ang awtomatikong pagbuo ng code sa CI system na naka-link sa build number o petsa ng build.

Ang mga developer ay madalas ding nagkakamali sa hindi pagtaas ng Version Code sa hotfix build para sa alternatibong track. Kung ang production ay may code 15, at ang alpha track ay nanatili sa 14, sa pag-promote ng alpha sa production, tatanggihan ng Google Play ang build dahil ang code nito ay mas maliit kaysa sa kasalukuyang production. Subaybayan ang monotonisidad ng code sa lahat ng track nang sabay-sabay — para dito, gumamit ng isang file na version.properties kung saan binabasa ng lahat ng track ang kasalukuyang halaga.