設備清單開發

在開發和發布新設備時，供應商可以在設備清單 (DM) 中定義和聲明目標 FCM 版本。在為舊設備升級供應商映像時，供應商可以選擇實施新的 HAL 版本並增加目標 FCM 版本。

開發新設備

為新設備定義設備目標 FCM 版本時：

  1. 未定義DEVICE_MANIFEST_FILE和PRODUCT_ENFORCE_VINTF_MANIFEST 。
  2. 為目標 FCM 版本實施 HAL。
  3. 編寫正確的設備清單文件。
  4. 將目標 FCM 版本寫入設備清單文件。
  5. 設置DEVICE_MANIFEST_FILE 。
  6. 將PRODUCT_ENFORCE_VINTF_MANIFEST設置為true 。

發布新設備

當一個新設備發佈時，它的初始目標 FCM 版本需要確定並在設備清單中聲明為頂級<manifest>元素中的“ target-level ”屬性。

例如，搭載 Android 9 的設備的目標 FCM 版本必須等於 3（目前可用的更高版本）。要在設備清單中聲明這一點：

<manifest version="1.0" type="device" target-level="3">
    <!-- ... -->
</manifest>

升級供應商形象

為舊設備升級供應商映像時，供應商可以選擇實施新的 HAL 版本並增加目標 FCM 版本。

升級 HAL

在供應商映像升級期間，供應商可以實施新的 HAL 版本，前提是 HAL 名稱、接口名稱和實例名稱相同。例如：

  • Google Pixel 2 和 Pixel 2 XL 設備隨 Target FCM 版本 2 發布，實現了所需的音頻 2.0 HAL android.hardware.audio@2.0::IDeviceFactory/default 。
  • 對於 Android 9 發布的音頻 4.0 HAL，Google Pixel 2 和 Pixel 2 XL 設備可以使用完整的 OTA 升級到 4.0 HAL，它實現了android.hardware.audio@4.0::IDeviceFactory/default 。
  • 儘管compatibility_matrix.2.xml僅指定了音頻 2.0，但對具有 Target FCM 版本 2 的供應商映像的要求已經放寬，因為 Android 9 框架（FCM 版本 3）在功能方面認為音頻 4.0 是音頻 2.0 HAL 的替代品.

總結一下， compatibility_matrix.2.xml需要音頻 2.0， compatibility_matrix.3.xml需要音頻 4.0，要求如下：

FCM 版本（系統）目標 FCM 版本（供應商）要求
2 (8.1) 2 (8.1)音頻2.0
3 (9) 2 (8.1)音頻 2.0 或 4.0
3 (9) 3 (9)音頻4.0

升級目標 FCM 版本

在供應商映像升級期間，供應商還可以增加目標 FCM 版本以指定升級後的供應商映像可以使用的目標 FCM 版本。要提升設備的目標 FCM 版本，供應商需要：

  1. 為目標 FCM 版本實施所有新的所需 HAL 版本。
  2. 在設備清單文件中修改 HAL 版本。
  3. 修改設備清單文件中的目標 FCM 版本。
  4. 刪除已棄用的 HAL 版本。

例如，使用 Android 7.0 啟動的 Google Pixel 和 Pixel XL 設備因此其目標 FCM 版本必須至少是舊版。但是， 設備清單聲明了 Target FCM 版本 2，因為供應商映像已更新為符合compatibility_matrix.2.xml ：

<manifest version="1.0" type="device" target-level="2">

如果供應商未實施所有必需的新 HAL 版本或未刪除已棄用的 HAL 版本，則無法升級目標 FCM 版本。

例如，Google Pixel 2 和 Pixel 2 XL 設備具有 Target FCM 版本 2。雖然它們確實實現了compatibility_matrix.3.xml所需的一些 HAL（例如音頻 4.0、健康 2.0 等），但它們不會刪除android.hardware.radio.deprecated@1.0 ，在 FCM 版本 3 (Android 9) 中已棄用。因此，這些設備無法將目標 FCM 版本升級到 3。

在 OTA 期間強制內核要求

從 Android 9 或更低版本更新設備

在搭載 Android 9 或更低版本的設備上，確保精心挑選了以下 CL：

這些更改引入了構建標誌PRODUCT_OTA_ENFORCE_VINTF_KERNEL_REQUIREMENTS ，並且未設置搭載 Android 9 或更低版本的設備的標誌。

  • 更新到 Android 10 時，運行 Android 9 或更低版本的設備上的 OTA 客戶端無法正確檢查 OTA 包中的內核要求。需要進行這些更改才能從生成的 OTA 包中刪除內核要求。
  • 更新到 Android 11 時，可以選擇設置PRODUCT_OTA_ENFORCE_VINTF_KERNEL_REQUIREMENTS構建標誌以在生成更新包時檢查 VINTF 兼容性。

有關此構建標誌的更多信息，請參閱從 Android 10 更新設備。

從 Android 10 更新設備

Android 10 引入了一個新的構建標誌PRODUCT_OTA_ENFORCE_VINTF_KERNEL_REQUIREMENTS 。對於搭載 Android 10 的設備，此標誌會自動設置為true 。當標誌設置為true時，腳本會從已安裝的內核映像中提取內核版本和內核配置。

  • 更新到 Android 10 時，OTA 更新包包含內核版本和配置。運行 Android 10 的設備上的 OTA 客戶端會讀取此信息以檢查兼容性。
  • 更新到 Android 11 時，OTA 包類型會讀取內核版本和配置以檢查兼容性。

如果腳本無法為您的內核映像提取此信息，請執行以下操作之一：

  • 編輯腳本以支持您的內核格式並為 AOSP 做出貢獻。
  • 將BOARD_KERNEL_VERSION設置為內核版本，將BOARD_KERNEL_CONFIG_FILE設置為構建的內核配置文件.config的路徑。更新內核映像時必須更新這兩個變量。
  • 或者，將PRODUCT_OTA_ENFORCE_VINTF_KERNEL_REQUIREMENTS設置為false以跳過檢查內核要求。不建議這樣做，因為任何不兼容性都會被隱藏，並且只有在更新後運行 VTS 測試時才會發現。

可以查看內核信息提取腳本extract_kernel.py的源代碼。