Ketika Anda menetapkan targetSdkVersion = "xx", Anda menyatakan bahwa aplikasi Anda berfungsi dengan baik (misalnya, telah diuji secara menyeluruh dan berhasil) pada tingkat API xx.
Versi Android yang berjalan pada tingkat API di atas xx akan menerapkan kode kompatibilitas secara otomatis untuk mendukung fitur apa pun yang mungkin Anda andalkan yang tersedia pada atau sebelum tingkat API xx, tetapi sekarang sudah usang pada tingkat yang lebih tinggi versi Android.
Sebaliknya, jika Anda menggunakan fitur apa pun yang menjadi usang pada atau sebelum level xx, kode kompatibilitas tidak akan secara otomatis diterapkan oleh versi OS pada level API yang lebih tinggi (yang tidak lagi menyertakan fitur-fitur) untuk mendukung penggunaan tersebut. Dalam situasi itu, kode Anda sendiri harus memiliki klausul kasus khusus bahwa tes tingkat API dan, jika tingkat OS terdeteksi adalah lebih tinggi yang tidak lagi telah fitur API yang diberikan, kode Anda harus menggunakan fitur alternatif yang berada tersedia di menjalankan OS ini Tingkat API.
Jika gagal melakukan hal ini, maka beberapa fitur antarmuka mungkin tidak muncul yang biasanya akan memicu peristiwa dalam kode Anda, dan Anda mungkin kehilangan fitur antarmuka penting yang harus dipicu oleh pengguna untuk mengakses peristiwa tersebut dan mengakses fungsionalitasnya (seperti pada contoh di bawah).
Seperti yang dinyatakan dalam jawaban lain, Anda dapat menetapkan targetSdkVersion lebih tinggi dari minSdkVersion jika Anda ingin menggunakan beberapa fitur API yang awalnya ditentukan pada tingkat API yang lebih tinggi daripada minSdkVersion Anda, dan telah mengambil langkah-langkah untuk memastikan bahwa kode Anda dapat mendeteksi dan menangani tidak adanya fitur-fitur tersebut di tingkat lebih rendah dari targetSdkVersion.
Untuk memperingatkan pengembang untuk secara khusus menguji tingkat API minimum yang diperlukan untuk menggunakan fitur, kompiler akan mengeluarkan kesalahan (bukan hanya peringatan) jika kode berisi panggilan ke metode apa pun yang didefinisikan pada tingkat API kemudian daripada minSdkVersion, bahkan jika targetSdkVersion lebih besar dari atau sama dengan tingkat API di mana metode itu pertama kali tersedia. Untuk menghapus kesalahan ini, arahan kompiler
@TargetApi(nn)
memberitahu kompiler bahwa kode dalam lingkup direktif itu (yang akan mendahului metode atau kelas) telah ditulis untuk menguji tingkat API setidaknya nn sebelum memanggil metode apa pun yang bergantung pada memiliki setidaknya tingkat API. . Misalnya, kode berikut mendefinisikan metode yang dapat dipanggil dari kode dalam aplikasi yang memiliki minSdkVersion kurang dari 11 dan targetSdkVersion 11 atau lebih tinggi:
@TargetApi(11)
public void refreshActionBarIfApi11OrHigher() {
//If the API is 11 or higher, set up the actionBar and display it
if(Build.VERSION.SDK_INT >= 11) {
//ActionBar only exists at API level 11 or higher
ActionBar actionBar = getActionBar();
//This should cause onPrepareOptionsMenu() to be called.
// In versions of the API prior to 11, this only occurred when the user pressed
// the dedicated menu button, but at level 11 and above, the action bar is
// typically displayed continuously and so you will need to call this
// each time the options on your menu change.
invalidateOptionsMenu();
//Show the bar
actionBar.show();
}
}
Anda mungkin juga ingin mendeklarasikan targetSdkVersion yang lebih tinggi jika Anda telah menguji pada tingkat yang lebih tinggi dan semuanya berfungsi, bahkan jika Anda tidak menggunakan fitur apa pun dari tingkat API yang lebih tinggi dari minSdkVersion Anda. Ini hanya untuk menghindari overhead dalam mengakses kode kompatibilitas yang dimaksudkan untuk beradaptasi dari level target ke level min, karena Anda telah mengkonfirmasi (melalui pengujian) bahwa tidak diperlukan adaptasi seperti itu.
Contoh fitur UI yang bergantung pada targetSdkVersion yang dideklarasikan adalah tombol menu tiga-titik vertikal yang muncul pada bilah status aplikasi yang memiliki targetSdkVersion kurang dari 11, ketika aplikasi tersebut berjalan di bawah API 11 dan lebih tinggi. Jika aplikasi Anda memiliki targetSdkVersion 10 atau lebih rendah, diasumsikan bahwa antarmuka aplikasi Anda tergantung pada keberadaan tombol menu khusus, dan tombol tiga-titik tampaknya menggantikan perangkat keras khusus sebelumnya dan / atau versi layar. tombol itu (misalnya, seperti yang terlihat di Gingerbread) ketika OS memiliki tingkat API yang lebih tinggi di mana tombol menu khusus pada perangkat tidak lagi dianggap. Namun, jika Anda menetapkan targetSdkVersion aplikasi Anda menjadi 11 atau lebih tinggi, diasumsikan bahwa Anda telah memanfaatkan fitur yang diperkenalkan pada tingkat itu yang menggantikan tombol menu khusus (e. g., Bar Tindakan), atau Anda telah mengelak dari kebutuhan untuk memiliki tombol menu sistem; akibatnya, "kompatibilitas tombol" menu tiga-titik-vertikal menghilang. Dalam hal itu, jika pengguna tidak dapat menemukan tombol menu, dia tidak dapat menekannya, dan itu, pada gilirannya, berarti bahwa aktivitas Anda pada overCreateOptionsMenu (menu) override mungkin tidak pernah dipanggil, yang, sekali lagi pada gilirannya, berarti bahwa sebagian besar fungsi aplikasi Anda dapat kehilangan antarmuka penggunanya. Kecuali, tentu saja, Anda telah mengimplementasikan Bilah Tindakan atau cara alternatif lain bagi pengguna untuk mengakses fitur-fitur ini. t menemukan tombol menu, dia tidak bisa menekannya, dan itu, pada gilirannya, berarti bahwa aktivitas Anda diCreateOptionsMenu (menu) override mungkin tidak akan pernah dipanggil, yang, sekali lagi pada gilirannya, berarti bahwa sebagian besar fungsi aplikasi Anda bisa menjadi kehilangan antarmuka penggunanya. Kecuali, tentu saja, Anda telah mengimplementasikan Bilah Tindakan atau cara alternatif lain bagi pengguna untuk mengakses fitur-fitur ini. t menemukan tombol menu, dia tidak bisa menekannya, dan itu, pada gilirannya, berarti bahwa aktivitas Anda diCreateOptionsMenu (menu) override mungkin tidak akan pernah dipanggil, yang, sekali lagi pada gilirannya, berarti bahwa sebagian besar fungsi aplikasi Anda bisa menjadi kehilangan antarmuka penggunanya. Kecuali, tentu saja, Anda telah mengimplementasikan Bilah Tindakan atau cara alternatif lain bagi pengguna untuk mengakses fitur-fitur ini.
minSdkVersion, sebaliknya, menyatakan persyaratan bahwa versi OS perangkat memiliki setidaknya tingkat API untuk menjalankan aplikasi Anda. Ini memengaruhi perangkat mana yang dapat melihat dan mengunduh aplikasi Anda ketika ada di Google Play Store (dan mungkin juga toko aplikasi lainnya). Ini adalah cara untuk menyatakan bahwa aplikasi Anda mengandalkan fitur OS (API atau lainnya) yang dibuat pada tingkat itu, dan tidak memiliki cara yang dapat diterima untuk menangani ketiadaan fitur tersebut.
Contoh menggunakan minSdkVersion untuk memastikan keberadaan fitur yang tidak terkait dengan API adalah dengan menetapkan minSdkVersion ke 8 untuk memastikan bahwa aplikasi Anda hanya akan berjalan pada versi yang didukung JIT dari juru bahasa Dalvik (sejak JIT diperkenalkan ke juru bahasa Android di API level 8). Karena kinerja untuk juru bahasa berkemampuan JIT dapat sebanyak lima kali lipat dari yang tidak memiliki fitur itu, jika aplikasi Anda menggunakan prosesor dengan berat maka Anda mungkin memerlukan API level 8 atau lebih tinggi untuk memastikan kinerja yang memadai.
