Level API vendor mengacu pada versi antarmuka yang didukung oleh partisi vendor. Antarmukanya bersifat dua arah; antarmuka ini menjelaskan API yang disediakan partisi vendor untuk partisi sistem (antarmuka hardware abstraction layer atau HAL), dan juga API yang diperlukan partisi vendor dari partisi sistem (antarmuka low-level native developers kit atau LLNDK).
Tingkat API vendor juga digunakan untuk menentukan Persyaratan Software Vendor (VSR), yang merupakan kumpulan persyaratan fungsional dan non-fungsional yang harus dipenuhi oleh software di partisi vendor.
Bagian selanjutnya di halaman ini menjelaskan cara penggunaan properti sistem, bergantung pada versi Android Anda, untuk menentukan level API vendor.
Penghentian vendor
Android memungkinkan vendor membekukan partisi vendor pada versi VSR tertentu. Kumpulan fitur yang diharapkan Android dari partisi vendor ditentukan oleh level API vendor yang terkait dengan partisi vendor. Saat runtime, perilaku software yang berjalan di partisi sistem disesuaikan untuk mengakomodasi level API vendor dari partisi vendor. Misalnya, software di partisi sistem mungkin tidak menggunakan fitur baru jika tidak didukung oleh level API partisi vendor.
Penghentian vendor hanya tersedia jika Anda membuat perangkat yang kompatibel dengan Android.
Menentukan level API vendor (Android 14-QPR3 dan yang lebih baru)
Untuk Android 14-QPR3 dan yang lebih baru, level API vendor dirilis secara terpisah, yang berarti level API SDK dan level API vendor tidak sinkron.
Karena jadwal rilis yang terpisah, untuk Android 14-QPR3 dan yang lebih baru, level API vendor sepenuhnya terpisah dari level API SDK. Untuk memastikan pemisahan ini jelas, format level API vendor adalah tanggal yang diformat sebagai YYYYMM (tahun dan bulan), sedangkan level SDK adalah bilangan bulat.
Android 14-QPR3 dan yang lebih baru berisi properti sistem berikut yang terkait dengan level API vendor:
| Properti sistem | Format | Deskripsi | Setelan awal |
|---|---|---|---|
ro.board.api_level |
YYYYMM | Level API vendor yang didukung oleh software chipset. Properti ini ditetapkan untuk semua chipset. | Ini ditetapkan oleh sistem build secara otomatis. |
ro.board.first_api_level |
YYYYMM | Level API vendor yang digunakan saat software chipset pertama kali dirilis. Properti ini hanya merupakan fungsi chipset dan ditetapkan oleh vendor SoC jika chipset SoC memenuhi syarat untuk vendor freeze. Setelah setelan awal, setelan ini tidak boleh diubah. | Vendor SoC menetapkan setelan ini menggunakan BOARD_SHIPPING_API_LEVEL. |
ro.product.first_api_level |
Bilangan Bulat | Level API SDK yang digunakan saat perangkat diluncurkan pertama kali. | Properti ini ditetapkan oleh OEM dan tidak pernah diupdate, bahkan setelah upgrade OS. |
ro.vendor.api_level |
YYYYMM | Level API vendor yang sesuai dengan ro.product.first_api_level. Kami menetapkan ro.vendor.api_level ke nilai ro.board.api_level saat ro.board.api_level kurang dari level API vendor ro.product.first_api_level hanya jika chipset SoC memenuhi syarat untuk pembekuan vendor. |
Dijelaskan setelah tabel ini. |
ro.board.api_frozen |
boolean | Properti ini ditetapkan ke true jika level API vendor yang diwakili oleh ro.board.api_level telah difinalisasi. |
Jika properti ini tidak disetel, nilai defaultnya adalah false. |
ro.llndk.api_level |
YYYYMM | Tingkat API vendor dalam format YYYYMM yang disediakan oleh LLNDK saat ini di partisi sistem. LLNDK kompatibel dengan versi sebelumnya, sehingga image vendor apa pun yang kurang dari atau sama dengan level API ini dapat di-flash dengan image sistem ini. | Properti ini ditetapkan di partisi sistem. |
Properti ro.vendor.api_level diperoleh dengan salah satu dari dua cara berikut:
Jika chipset memenuhi syarat untuk pembekuan vendor:
ro.vendor.api_level = min( ro.board.api_level, AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level))Jika chipset tidak dalam pembekuan vendor:
ro.vendor.api_level = AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level)
Metode AVendorSupport_getVendorApiLevelOf() menentukan level API vendor yang sesuai dari level API SDK. Misalnya
AVendorSupport_getVendorApiLevelOf(35), dengan 35 adalah level API SDK dari
rilis Android utama pada tahun 2024 menampilkan 202404, yang merupakan perkiraan tanggal
Android 14-QPR3 saat level API Vendor saat ini ditetapkan.
Menentukan level API vendor (Android 13)
Level API vendor mengikuti level API SDK, yang ditujukan untuk antarmuka aplikasi-OS dan diupdate setahun sekali saat platform Android baru dirilis ke AOSP.
Android 13 berisi properti sistem berikut yang terkait dengan level API vendor:
| Properti sistem | Format | Deskripsi | Setelan awal |
|---|---|---|---|
ro.board.first_api_level |
Bilangan Bulat | Level API vendor yang digunakan saat software chipset pertama kali dirilis. Ini hanya fungsi chipset, dan tidak dapat diubah oleh vendor SoC atau OEM. Properti ini hanya disetel untuk chipset yang memenuhi syarat untuk pembekuan vendor | Nilai ditetapkan dengan menyetel BOARD_SHIPPING_API_LEVEL dalam file device.mk. |
ro.board.api_level |
Bilangan Bulat | Level API vendor yang didukung oleh software chipset. Properti ini hanya disetel untuk chipset yang memenuhi syarat untuk penghentian vendor. | Awalnya, nilai properti ini disetel oleh sistem build ke nilai yang sama dengan ro.board.first_api_level, tetapi dapat diperbarui jika partisi vendor diupgrade. |
ro.product.first_api_level |
Bilangan Bulat | Level API SDK yang digunakan saat perangkat diluncurkan pertama kali. | Properti ini ditetapkan oleh OEM dan tidak pernah diupdate, bahkan setelah upgrade OS. |
ro.vendor.api_level |
Bilangan Bulat | Sama dengan deskripsi level API vendor dalam tabel sebelumnya. | |
ro.vndk.version |
Bilangan Bulat | Versi VNDK yang digunakan untuk membangun partisi vendor. | Properti ini ditetapkan di partisi vendor. |
ro.vendor.build.version.sdk |
Bilangan Bulat | Level API SDK dari struktur sumber tempat partisi vendor dibangun. |