產生供應商快照

Android 11 支援 VNDK 快照版本 構件 和廠商快照，您可以透過這種方式建構 vendor.img 原始碼樹狀結構上的 Android 版本。這可使圖片的混合版本 以便當做舊版的廠商和較新的系統映像檔的映像檔

下列項目不支援混合映像檔版本。

  • Android.mk.：由於 Soong 會產生供應商快照， Android.mk 不會擷取為廠商數據匯報 ( 此外，Android.mk也不保證能正常運作)。

  • Sanitizer。供應商和 VNDK 快照不支援消毒液做為消毒液 變化版本必須個別建立。

關於供應商快照

供應商數據匯報是 OEM 擁有的數據匯報。這是一組預先建構的 C++ 模組 安裝在 /vendor 中，但在 Android 開放原始碼計畫中維護。如果不擷取供應商 前 Android 版本的快照；升級至新的 Android 版本 供應商快照模組可以移除，因此可能會中斷供應商分區 或在沒有 API 或 ABI 相容性的情況下變更

供應商快照包含 Android 開放原始碼計畫中的下列模組。

  • 與 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

這些指令會在以下位置建立 vendor-$(TARGET_DEVICE).zip 檔案： $DIST_DIR。以下範例顯示供應商快照 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 中的 .rc 和 .xml 檔案 和 vintf_fragments。

安裝供應商快照

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

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 以外的值時，建構 系統：

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