Android 11 mendukung artefak build snapshot VNDK dan snapshot vendor, yang dapat Anda gunakan untuk membuat vendor.img
apa pun versi Android di pohon sumber. Hal ini memungkinkan versi campuran gambar, seperti vendor lama dan gambar sistem yang lebih baru.
Versi gambar campuran tidak didukung untuk hal berikut.
Android.mk.
Karena Soong menghasilkan snapshot vendor, modul yang ditentukan diAndroid.mk
tidak diambil sebagai snapshot vendor (modul milik SoC diAndroid.mk
juga tidak dijamin berfungsi).pembersih. Snapshot vendor dan VNDK tidak mendukung sanitizer karena varian sanitizer perlu dibuat secara terpisah.
Tentang snapshot vendor
Snapshot vendor adalah snapshot milik OEM. Ini adalah sekumpulan modul C++ bawaan yang dipasang di /vendor
tetapi dikelola di AOSP. Tanpa mengambil snapshot vendor dari versi Android sebelumnya, mengupgrade ke versi Android baru mungkin merusak partisi vendor karena modul snapshot vendor dapat dihapus atau diubah tanpa kompatibilitas API atau ABI.
Snapshot vendor berisi modul berikut di AOSP.
- Pustaka bersama, statis, dan header dengan
vendor: true
atauvendor_available: true
- Pustaka statis VNDK dengan
vendor_available: true
- File executable dan objek dengan
vendor: true
atauvendor_available: true
Modul di bawah direktori berikut dianggap sebagai kode perangkat keras milik SoC dan diabaikan.
-
device/
-
vendor/
-
hardware/
, kecuali-
hardware/interfaces
-
hardware/libhardware
-
hardware/libhardware_legacy
-
Kode perangkat keras milik SoC mungkin juga ada di direktori lain. Saat ini, snapshot vendor tidak mendukung konfigurasi tersebut.
Membangun snapshot vendor
Buat snapshot vendor menggunakan perintah berikut.
. build/envsetup.sh
lunch target
m dist vendor-snapshot
Perintah ini membuat file vendor-$(TARGET_DEVICE).zip
di $DIST_DIR
. Contoh di bawah ini menunjukkan file ZIP snapshot vendor.
vendor-$(TARGET_DEVICE).zip
├── arch-arm64-armv8-a
│ ├── binary -> binary files, *.json files
│ ├── header -> *.json files
│ ├── object -> *.o files, *.json files
│ ├── shared -> *.so files, *.json files
│ └── static -> *.a files, *.json files
├── arch-arm-armv8-a -> (arch-arm64-armv8-a)
├── configs -> *.rc files, *.xml files
├── include -> exported header files (*.h, *.hh, etc.)
└── NOTICE_FILES -> license txt files
- File JSON berisi tanda seperti nama modul, direktori yang diekspor, file
init_rc
, dan filevintf_fragments
. - Direktori
configs
berisi file.rc
dan.xml
dari flaginit_rc
danvintf_fragments
.
Menginstal snapshot vendor
Untuk menginstal snapshot vendor, navigasikan ke direktori tujuan dan gunakan perintah berikut.
python3 development/vendor_snapshot/update.py --local $DIST_DIR --install-dir \
vendor/vendor name/vendor_snapshot VER
Perintah ini menghasilkan /vendor/ vendor name /vendor_snapshot/v VER /$(TARGET_ARCH)/Android.bp
. Contoh berikut menunjukkan struktur direktori snapshot vendor.
vendor/vendor name/vendor_snapshot/
├── v30
│ ├── arm64
│ │ ├── arch-arm64-armv8-a
│ │ │ ├── binary -> (prebuilt libs)
│ │ │ ├── object -> (prebuilt libs)
│ │ │ ├── shared -> (prebuilt libs)
│ │ │ └── static -> (prebuilt libs)
│ │ ├── arch-arm-armv8-a -> (same as above)
│ │ ├── configs -> (config files)
│ │ ├── include -> (exported header files)
│ │ ├── NOTICE_FILES -> (license files)
│ │ └── Android.bp -> (snapshot modules)
│ ├── arm -> (same as above)
│ ├── x86_64 -> (same as above)
│ └── x86 -> (same as above)
└── (other vendor versions) -> (same as above)
Membangun citra vendor
Dengan menggunakan artefak build snapshot VNDK dan snapshot vendor, Anda dapat membuat vendor.img
apa pun versi Androidnya di pohon sumber, sehingga memungkinkan pembuatan gambar versi campuran. Setelah menginstal snapshot VNDK dan snapshot vendor, atur BOARD_VNDK_VERSION
ke versi vendor. Misalnya:
# BoardConfig.mk
BOARD_VNDK_VERSION := 29
Ketika BOARD_VNDK_VERSION
diatur ke nilai selain current
, sistem build:
- Mengaktifkan modul snapshot VNDK dan modul snapshot vendor
BOARD_VNDK_VERSION
. Setiap modul snapshot menimpa modul sumber C++ yang memiliki nama yang sama. - Setel
ro.vndk.version
keBOARD_VNDK_VERSION
. - Menginstal modul snapshot VNDK
BOARD_VNDK_VERSION
kesystem_ext
.