產生供應商快照

Android 11 支援 VNDK 快照建構構件和供應商快照，無論來源樹狀結構中的 Android 版本為何，您都可以使用這些快照建構 vendor.img。這可提供混合版本的映像檔，例如舊版供應商和較新的系統映像檔。

以下功能不支援混合圖片版本：

  • Android.mk. 由於 Soong 會產生供應商快照，因此在 Android.mk 中定義的模組不會擷取為供應商快照 (Android.mk 中的 SoC 專屬模組也不保證可運作)。

  • 消毒劑。供應商和 VNDK 快照不支援消毒劑，因為消毒劑變化版本需要個別建構。

關於供應商快照

供應商快照是指原始設備製造商 (OEM) 擁有的快照。這是一組預先建構的 C++ 模組，已安裝在 /vendor 中，但由 AOSP 維護。如果未擷取先前 Android 版本的供應商快照，升級至新版 Android 可能會破壞供應商分區，因為供應商快照模組可在沒有 API 或 ABI 相容性的情況下移除或變更。

供應商快照包含 AOSP 中的下列模組。

  • 使用 vendor: true 或 vendor_available: true 的共用、靜態和標頭程式庫
  • 含有 vendor_available: true 的 VNDK 靜態資料庫
  • 具有 vendor: true 或 vendor_available: true 的執行檔和物件檔案

系統會將下列目錄下的模組視為 SoC 擁有的硬體程式碼，並予以忽略。

  • device/
  • vendor/
  • hardware/，但
    • hardware/interfaces
    • hardware/libhardware
    • hardware/libhardware_legacy

SoC 專屬的硬體代碼也可能存在於其他目錄中。目前供應商快照不支援這類設定。

建構供應商快照

使用下列指令建立供應商快照。

. build/envsetup.sh
lunch target
m dist vendor-snapshot

這些指令會在 $DIST_DIR 中建立 vendor-$(TARGET_DEVICE).zip 檔案。以下範例顯示供應商快照的 ZIP 檔案：

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
  • JSON 檔案包含模組名稱、匯出的目錄、init_rc 檔案和 vintf_fragments 檔案等旗標。
  • configs 目錄包含標記 init_rc 和 vintf_fragments 的 .rc 和 .xml 檔案。

安裝供應商快照

如要安裝供應商快照，請前往目的地目錄並使用下列指令。

python3 development/vendor_snapshot/update.py --local $DIST_DIR --install-dir \
    vendor/vendor name/vendor_snapshot VER

這個指令會產生 /vendor/vendor name/vendor_snapshot/vVER/$(TARGET_ARCH)/Android.bp。以下範例顯示供應商快照的目錄結構：

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)

建構供應商映像檔

您可以使用 VNDK 快照建構成果物和供應商快照，無論來源樹狀結構中的 Android 版本為何，您都可以建構 vendor.img，因此可以建立混合版本的映像檔。安裝 VNDK 快照和供應商快照後，請將 BOARD_VNDK_VERSION 設為供應商的版本。例如：

# BoardConfig.mk
BOARD_VNDK_VERSION := 29

當 BOARD_VNDK_VERSION 設為 current 以外的值時，建構系統會：

  • 啟用 BOARD_VNDK_VERSION 的 VNDK 快照模組和供應商快照模組。每個快照模組都會覆寫同名的 C++ 來源模組。
  • 將 ro.vndk.version 設為 BOARD_VNDK_VERSION。
  • 將 BOARD_VNDK_VERSION 的 VNDK 快照模組安裝至 system_ext。