Version Name: esensi parameter dan pengaturan

Apa itu Version Name

Version Name — adalah string semantik yang mengidentifikasi rilis aplikasi untuk pengguna. Berbeda dengan pengidentifikasi teknis build, parameter ini membawa muatan makna: berdasarkan itu, pengguna mengevaluasi seberapa besar perbedaan pembaruan baru dari yang sebelumnya.

Version Name ditampilkan di kartu aplikasi di Google Play dan App Store, di bagian “Tentang aplikasi” di perangkat, serta di dialog pembaruan sistem. Pengembang mencantumkannya di file konfigurasi proyek sebelum membangun versi rilis.

Menurut Semantic Versioning 2.0 (2023), format Major.Minor.Patch digunakan di 78% aplikasi mobile. Versi mayor berubah pada perubahan API yang tidak kompatibel, minor — saat menambah fungsionalitas, patch — saat memperbaiki kesalahan.

Gunakan Version Name untuk berkomunikasi dengan pengguna: mereka harus segera memahami seberapa besar pembaruan yang ditawarkan — mayor, minor, atau korektif.

Struktur versi semantik

Versi semantik terdiri dari tiga angka yang dipisahkan oleh titik: Major.Minor.Patch. Masing-masing komponen ini bertanggung jawab atas tingkat perubahan tertentu dalam aplikasi.

Versi mayor (Major) meningkat saat perubahan mendasar yang merusak kompatibilitas mundur. Versi minor (Minor) menambah fungsionalitas baru tanpa mengganggu yang sudah ada. Patch hanya berisi perbaikan bug.

Misalnya, versi 3.2.1 berarti: versi mayor ketiga, pembaruan minor kedua, patch pertama. Sistem ini dapat dipahami oleh pengembang dan pengguna.

Di mana Version Name ditampilkan

Version Name terlihat oleh pengguna di beberapa tempat penting. Di toko aplikasi, ditampilkan di judul kartu aplikasi dan di daftar pembaruan. Di perangkat — di pengaturan sistem di bagian “Tentang aplikasi”.

Di Google Play, Version Name ditampilkan di bawah nama aplikasi dan memengaruhi keputusan pengguna untuk memperbarui. Di App Store, string versi ditampilkan di tempat yang sama saat melihat halaman aplikasi.

Menurut penelitian Apptentive (2024), 67% pengguna memeriksa versi aplikasi sebelum memperbarui, dan semantik yang dapat dipahami meningkatkan konversi instalasi sebesar 23%.

Version Name di Android

Di Android, Version Name diatur dengan parameter versionName di file build.gradle (level modul). Parameter ini adalah string dan dapat berisi karakter apa pun, termasuk titik, tanda hubung, dan huruf.

Parameter dideklarasikan di dalam blok android.defaultConfig bersama dengan parameter wajib versionCode. Android tidak memberlakukan batasan pada format string, tetapi Google Play merekomendasikan penggunaan format semantik.

Menurut Android Developers (2025), Google Play menggunakan versionName untuk ditampilkan di antarmuka toko, tetapi tidak menganalisis kontennya secara terprogram — hanya versionCode yang memengaruhi logika pembaruan.

Cantumkan Version Name dalam format Major.Minor.Patch dan sinkronkan dengan tag di sistem kontrol versi untuk identifikasi rilis yang tepat.

Fitur versionName di Gradle

Gradle memungkinkan pengaturan versionName secara statis di build.gradle atau secara dinamis melalui skrip build. Generasi dinamis berguna untuk build malam otomatis dan pipeline CI/CD.

Di build.gradle, Anda dapat menggunakan variabel lingkungan, parameter baris perintah, atau panggilan skrip shell untuk membentuk versionName. Pendekatan umum adalah membaca versi dari file version.properties.

Fleksibilitas ini memungkinkan tim untuk mengotomatiskan proses versi dan menghilangkan faktor manusia dalam persiapan rilis.

Version Name di iOS

Di iOS, Version Name diatur dengan kunci CFBundleShortVersionString di file Info.plist. Ini adalah parameter wajib untuk publikasi aplikasi di App Store dan secara ketat diketik sebagai string.

Berbeda dengan Android, App Store Connect memeriksa format Version Name dan memerlukan kesesuaian dengan pola angka yang dipisahkan titik. Panjang maksimum string adalah 18 karakter, dan setiap komponen versi tidak boleh melebihi 255.

Menurut Apple Developer Documentation (2025), CFBundleShortVersionString digunakan oleh App Store untuk menampilkan versi di antarmuka toko dan di dialog sistem di perangkat pengguna.

Saat mengunggah build ke App Store Connect, pastikan Version Name sesuai dengan versi yang tercantum di materi pemasaran — ini menyederhanakan komunikasi dengan pengguna.

Integrasi dengan Xcode

Xcode menyediakan antarmuka grafis untuk mengubah Version Name di pengaturan target. Bidang “Marketing Version” berada di tab General di bagian Identity. Perubahan secara otomatis disimpan di Info.plist.

Untuk otomatisasi, Anda dapat menggunakan skrip build di Xcode Build Phases atau utilitas agvtool (Apple Generic Version Tool). agvtool memungkinkan manajemen versi dari baris perintah dan terintegrasi dengan CI/CD.

Pendekatan seperti ini sangat nyaman saat menggunakan fastlane atau Jenkins untuk build dan pengiriman aplikasi secara otomatis.

Perbedaan Version Name dan Build Number

Version Name dan Build Number menjalankan tugas berbeda dalam proses pengembangan. Version Name adalah string pengguna, dan Build Number adalah pengidentifikasi numerik internal yang secara unik mengidentifikasi setiap build.

Build Number (versionCode di Android, CFBundleVersion di iOS) wajib meningkat dengan setiap build baru dan digunakan oleh toko aplikasi untuk menentukan versi mana yang lebih baru. Version Name dapat tetap tidak berubah untuk beberapa build dari versi yang sama.

Menurut Google Play Policy (2025), dua aplikasi dengan versionCode yang sama dianggap sebagai versi yang sama — versionCode harus unik untuk setiap APK. Version Name tidak berpartisipasi dalam pemeriksaan ini.

Selalu tingkatkan Build Number di setiap build dan ubah Version Name hanya saat fungsionalitas berubah — ini mencegah konflik saat publikasi.

Cara Memilih Version Name

Pemilihan Version Name tergantung pada strategi versi tim. Pendekatan paling umum adalah versi semantik (SemVer), tetapi ada juga skema alternatif seperti versi kalender atau versi berdasarkan tanggal rilis.

Semantic Versioning 2.0 merekomendasikan format Major.Minor.Patch dengan sufiks pre-release opsional. Untuk aplikasi mobile, skema Major.Minor juga populer, di mana patch dihilangkan untuk penyederhanaan persepsi.

Versi kalender (CalVer) menggunakan tanggal rilis sebagai nomor versi — misalnya 25.06 (tahun dan bulan). Pendekatan ini nyaman untuk aplikasi dengan rilis sering, di mana semantik tidak penting.

Rekomendasi untuk memilih skema

Versi semantik cocok untuk aplikasi dengan API publik, di mana kompatibilitas mundur penting. Pengguna dan integrator memahami perubahan apa yang diharapkan saat pembaruan.

Versi kalender dipilih untuk aplikasi di mana pengguna lebih mementingkan kesegaran rilis daripada besarnya perubahan. Misalnya, agregator berita atau aplikasi cuaca.

Skema hibrida menggabungkan kedua pendekatan: Major.Minor.RC, di mana RC adalah nomor build untuk kandidat rilis tertentu. Skema seperti ini nyaman saat pengujian beta aktif.

Contoh Konfigurasi Version Name

Contoh kode di bawah menunjukkan cara mengatur Version Name di Android dan iOS. Untuk Android digunakan Gradle, untuk iOS — Xcode Build Settings dengan agvtool.

Konfigurasi versionName di Android

Di Android, versi diatur di file app/build.gradle di dalam blok defaultConfig. Parameter versionName menerima nilai string.

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

versionName juga dapat dibaca dari file eksternal atau dihasilkan secara dinamis menggunakan Gradle Script.

Generasi dinamis versionName

Versi dinamis dibentuk dari variabel lingkungan sistem CI/CD. Ini memastikan bahwa setiap build menerima nomor versi yang benar.

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

android {
    defaultConfig {
        versionName getVersionName()
    }
}

Pendekatan ini mengotomatiskan versi dan menghilangkan risiko ketidaksesuaian antara build dan tag di repositori.

Konfigurasi CFBundleShortVersionString di iOS

Di iOS, versi dapat diatur melalui Xcode atau melalui baris perintah dengan agvtool.

# Mengatur versi pemasaran
xcrun agvtool new-marketing-version 2.1.0

# Membaca versi saat ini
xcrun agvtool what-marketing-version

agvtool secara otomatis memperbarui Info.plist dan menyinkronkan versi di semua target dalam proyek Xcode.