Google berkomitmen untuk mendorong terwujudnya keadilan rasial bagi komunitas Kulit Hitam. Lihat caranya.

Membuat versi aplikasi Anda

Pembuatan versi merupakan bagian penting dari proses upgrade aplikasi dan strategi pemeliharaan. Pembuatan versi penting karena:

  • Pengguna perlu memiliki informasi khusus mengenai versi aplikasi yang terinstal di perangkat mereka dan versi upgrade yang tersedia untuk diinstal.
  • Aplikasi lain — termasuk aplikasi lain yang Anda publikasikan sebagai paket — perlu mengkueri sistem perihal versi aplikasi Anda, untuk menentukan kompatibilitas dan mengidentifikasi dependensi.
  • Layanan yang akan Anda gunakan untuk memublikasikan aplikasi juga mungkin perlu mengkueri aplikasi untuk mengetahui versinya, sehingga aplikasi dapat menampilkan versinya kepada pengguna. Layanan publikasi mungkin juga perlu memeriksa versi aplikasi untuk menentukan kompatibilitas dan menetapkan hubungan upgrade/downgrade versi.

Sistem Android menggunakan informasi versi aplikasi Anda untuk memberikan perlindungan dari downgrade. Sistem tidak menggunakan informasi versi aplikasi untuk menerapkan batasan pada upgrade atau kompatibilitas aplikasi pihak ketiga. Aplikasi Anda harus menerapkan batasan versi apa pun dan harus memberi tahu pengguna tentang hal tersebut.

Sistem Android menerapkan kompatibilitas versi sistem sebagaimana yang diungkapkan oleh setelan minSdkVersion dalam file build. Setelan ini memungkinkan aplikasi menetapkan API sistem minimum yang kompatibel dengannya. Untuk informasi selengkapnya, lihat Menetapkan Versi API Minimum Sistem.

Menetapkan informasi versi aplikasi

Untuk menentukan informasi versi aplikasi Anda, tetapkan nilai untuk setelan versi dalam file build Gradle. Nilai-nilai ini kemudian digabungkan ke dalam file manifes aplikasi pada proses build.

Catatan: Jika aplikasi Anda menentukan versi aplikasi secara langsung dalam elemen <manifest>, nilai-nilai versi dalam file build Gradle akan menggantikan setelan di manifes. Selain itu, menentukan setelan ini dalam file build Gradle memungkinkan Anda menetapkan nilai yang berbeda untuk berbagai versi aplikasi. Agar dapat lebih fleksibel dan untuk menghindari potensi penimpaan saat manifes digabungkan, Anda harus menghapus atribut ini dari elemen <manifest> dan menentukan setelan versi dalam file build Gradle.

Ada dua setelan yang tersedia, dan Anda harus selalu menetapkan nilai untuk keduanya:

  • versionCode - Bilangan bulat positif yang digunakan sebagai nomor versi internal. Nomor ini hanya digunakan untuk menentukan apakah suatu versi lebih baru daripada versi yang lain; nomor yang lebih tinggi menunjukkan versi yang lebih baru. Nomor ini bukanlah nomor versi yang ditunjukkan kepada pengguna; nomor tersebut ditentukan oleh setelan versionName, selanjutnya di bagian bawah. Sistem Android menggunakan nilai versionCode untuk memberikan perlindungan terhadap downgrade dengan mencegah pengguna menginstal APK menggunakan versionCode yang lebih rendah dari versi yang saat ini terinstal di perangkat mereka.

    Nilai ini berupa bilangan bulat positif sehingga aplikasi lain dapat mengevaluasinya secara terprogram, misalnya untuk memeriksa hubungan upgrade atau downgrade. Anda dapat menetapkan nilainya ke bilangan bulat positif yang diinginkan, tetapi Anda harus memastikan setiap rilis aplikasi sudah menggunakan nilai yang lebih besar. Anda tidak dapat mengupload APK ke Play Store dengan versionCode yang sudah digunakan untuk versi sebelumnya.

    Catatan: Dalam beberapa situasi tertentu, Anda mungkin ingin mengupload versi aplikasi dengan versionCode yang lebih rendah daripada versi terbaru. Misalnya, jika memublikasikan beberapa APK, Anda mungkin memiliki rentang versionCode yang telah ditetapkan untuk APK tertentu. Untuk informasi selengkapnya tentang menetapkan nilai versionCode bagi beberapa APK, lihat Dukungan Beberapa APK.

    Biasanya, Anda akan merilis aplikasi pertama Anda dengan versionCode yang ditetapkan ke 1, yang kemudian meningkat secara monoton dengan setiap rilis, terlepas apakah rilis tersebut merupakan rilis utama atau rilis minor. Artinya, nilai versionCode tidak selalu harus memiliki kemiripan dengan versi rilis aplikasi yang dapat dilihat oleh pengguna (lihat versionName selanjutnya di bagian bawah). Aplikasi dan layanan publikasi tidak boleh menampilkan nilai versi ini kepada pengguna.

    Peringatan: Nilai terbesar yang diizinkan oleh Google Play untuk versionCode adalah 2100000000.

  • versionName - String yang digunakan sebagai nomor versi yang ditampilkan kepada pengguna. Setelan ini dapat ditentukan sebagai string raw atau sebagai referensi resource string.

    Nilai ini berupa string sehingga Anda dapat menjelaskan versi aplikasi sebagai string <major>.<minor>.<point>, atau sebagai jenis ID versi absolut atau relatif lainnya. versionName tidak memiliki tujuan selain untuk ditampilkan kepada pengguna.

Anda dapat menentukan nilai default setelan ini dengan menyertakannya ke dalam blok defaultConfig {}, yang disarangkan dalam blok android {} file build.gradle modul Anda. Anda kemudian dapat mengganti nilai default ini untuk versi aplikasi Anda lainnya dengan menentukan nilai tersendiri bagi masing-masing jenis build atau ragam produk. File build.gradle berikut memperlihatkan setelan versionCode dan versionName dalam blok defaultConfig {}, serta blok productFlavors {}.

    android {
      ...
      defaultConfig {
        ...
        versionCode 2
        versionName "1.1"
      }
      productFlavors {
        demo {
          ...
          versionName "1.1-demo"
        }
        full {
          ...
        }
      }
    }
    

Dalam blok defaultConfig {} pada contoh ini, nilai versionCode menunjukkan bahwa APK saat ini berisi rilis kedua aplikasi, dan string versionName menentukan bahwa versi 1.1 akan ditampilkan kepada pengguna. File build.gradle ini juga menentukan dua ragam produk, yaitu "demo" dan "lengkap". Karena ragam produk "demo" menentukan versionName sebagai "1.1-demo", build "demo" akan menggunakan versionName, bukan nilai default. Blok ragam produk "lengkap" tidak menentukan versionName sehingga akan menggunakan nilai default "1.1".

Framework Android menyediakan API yang memungkinkan Anda meminta informasi versi aplikasi pada sistem. Untuk mendapatkan informasi versi, gunakan metode getPackageInfo(java.lang.String, int) dari PackageManager.

Menetapkan persyaratan API level

Jika aplikasi Anda memerlukan versi minimum spesifik platform Android, Anda dapat menetapkan persyaratan versi tersebut sebagai setelan API level dalam file build.gradle aplikasi. Selama proses build, setelan ini akan digabungkan ke dalam file manifes aplikasi Anda. Penetapan persyaratan level API akan memastikan bahwa aplikasi Anda hanya dapat diinstal pada perangkat yang menjalankan versi platform Android yang kompatibel.

Catatan: Jika Anda menetapkan persyaratan API level secara langsung dalam file manifes aplikasi, setelan yang terkait dalam file build akan menggantikan setelan dalam file manifes. Selain itu, menentukan setelan ini dalam file build Gradle memungkinkan Anda menetapkan nilai yang berbeda untuk berbagai versi aplikasi. Agar dapat lebih fleksibel dan untuk menghindari potensi penimpaan saat manifes digabungkan, Anda harus menghapus atribut ini dari elemen <uses-sdk> dan menetapkan setelan API level dalam file build Gradle.

Ada dua setelan API level yang tersedia:

  • minSdkVersion - Versi minimum platform Android tempat aplikasi akan dijalankan, yang ditetapkan oleh ID API level platform.
  • targetSdkVersion - Menentukan API level yang ditetapkan untuk menjalankan aplikasi. Dalam beberapa situasi, setelan ini memungkinkan aplikasi menggunakan elemen atau perilaku manifes yang ditentukan dalam API level target, bukan dibatasi agar hanya menggunakan setelan yang sudah ditentukan untuk API level minimum.

Untuk menetapkan persyaratan API level default dalam file build.gradle, tambahkan satu atau beberapa setelan di atas ke blok defaultConfig {}, yang disarangkan dalam blok android {}. Anda juga dapat mengganti nilai default ini untuk berbagai versi aplikasi Anda dengan menambahkan setelan ke jenis build atau ragam produk. File build.gradle berikut menetapkan setelan minSdkVersion dan targetSdkVersion default dalam blok defaultConfig {} dan mengganti minSdkVersion untuk satu ragam produk.

    android {
      ...
      defaultConfig {
        ...
        minSdkVersion 14
        targetSdkVersion 24
      }
      productFlavors {
        main {
          ...
        }
        afterLollipop {
          ...
          minSdkVersion 21
        }
      }
    }
    

Saat bersiap menginstal aplikasi Anda, sistem akan memeriksa nilai setelan ini dan membandingkannya dengan versi sistem. Jika nilai minSdkVersion lebih besar dari versi sistem, sistem akan mencegah penginstalan aplikasi.

Jika Anda tidak menetapkan setelan ini, sistem akan menganggap bahwa aplikasi Anda kompatibel dengan semua versi platform.

Untuk informasi selengkapnya, lihat dokumentasi elemen manifes <uses-sdk> dan dokumen API Level. Untuk mengetahui setelan build Gradle, lihat Mengonfigurasi Varian Build.